POST
/
wa
/
messages
curl --request POST \
  --url https://api.zapsterapi.com/v1/wa/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipient": "group:123456789987654321",
  "text": "<string>",
  "instance_id": "ozj35qv418rpmlrb",
  "auto_delete": false,
  "auto_mention": true,
  "view_once": false,
  "reply_to": "3EB04E7F387C999A0DD61D",
  "link_preview": false,
  "mentions": "everyone",
  "media": {
    "url": "https://images.unsplash.com/photo-1721332155567-55d1b12aa271?q=80&w=920&format=jpeg&fit=crop",
    "base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
    "caption": "<string>",
    "playback": false,
    "ptt": true,
    "ptv": false,
    "sticker": false,
    "fileName": "<string>"
  }
}'
{
  "message_id": "<string>"
}

​
Respondendo Mensagens

Para responder a mensagens já enviadas ou recebidas, utilize a propriedade reply_to. Isso permite que sua resposta seja vinculada diretamente à mensagem original, proporcionando um contexto claro na conversa (como mostrado na imagem abaixo).

Limitação: Atualmente, só é possível responder a mensagens que foram enviadas/recebidas nos últimos 7 dias.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Instance-ID
string

Obrigatório se instance_id não estiver presente no body.

Body

application/json
​
recipient
string
required

Número ou ID do grupo para onde será enviada a mensagem. Em caso de grupo o ID deve ser prefixado com o texto group: (Ex. group:123456789987654321).

Example:

"group:123456789987654321"

​
text
string
required

Texto a ser enviado para o recipient (destinatário), no caso de envio de mídias esta propriedade não é obrigatória.

​
instance_id
string

ID da instância, obrigatório se X-Instance-ID não for informado nos cabeçalhos.

Example:

"ozj35qv418rpmlrb"

​
auto_delete
boolean
default:false

Opção válida apenas quando o recipient não é um grupo. Se true então o chat/conversa será excluído após o envio da mensagem.

​
auto_mention
boolean
default:true

Opção válida apenas quando o recipient é um grupo. Se true então todo "@" seguido de um número será tratado como uma menção, então se no text ou media.caption tiver algo como "Olá @5599123451234" então tentaremos encontrar o número no grupo e fazer a menção/marcação automática.

O formato do número após o @ deve ser internacional, DDI + DDD + Número.

​
view_once
boolean
default:false

Opção válida apenas para mensagens de áudio, imagens e vídeos. Se true então só será possível visualizar a mensagem uma única vez.

​
reply_to
string

Para responder a uma mensagem específica, informe o ID da mensagem que deseja responder. Ao utilizar essa funcionalidade corretamente, sua resposta será vinculada à mensagem original, marcando-a de forma clara na conversa.

Example:

"3EB04E7F387C999A0DD61D"

​
link_preview
boolean
default:true

Quando false desabilitará a pre-visualização de links que estão presentes na mensagem.

Example:

false

​
mentions

Há duas formas de mencionar pessoas em um grupo, você pode informar o valor everyone e todos presentes no grupo (recipient) serão mencionados, ou você pode especifica-los manualmente informando uma lista de número que deverão ser mencionados.

Available options:
everyone
​
media
object

Response

200 - application/json
Success
​
message_id
string
required

ID usado para depuração interna