Pular para o conteúdo principal
POST
/
api
/
instances
/
{instanceId}
/
messages
/
send
Enviar uma mensagem via WhatsApp
curl --request POST \
  --url https://api.wappfy.io/api/instances/{instanceId}/messages/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "<string>",
  "type": "text",
  "body": "<string>",
  "media_url": "<string>",
  "caption": "<string>",
  "template_name": "<string>",
  "template_params": {},
  "location": {
    "latitude": -23.5505,
    "longitude": -46.6333,
    "name": "Av. Paulista, São Paulo"
  },
  "quoted_message_id": "<string>",
  "edit_message_id": "<string>",
  "mentions": [
    "<string>"
  ],
  "poll": {
    "name": "<string>",
    "options": [
      "<string>"
    ],
    "multipleAnswers": true
  },
  "contacts": [
    {
      "fullName": "<string>",
      "phoneNumber": "<string>",
      "organization": "<string>",
      "whatsappId": "<string>"
    }
  ],
  "forward_message_id": "<string>",
  "reaction": "<string>",
  "reaction_message_id": "<string>"
}
'
{
  "message": "Message queued for delivery",
  "jobId": "42"
}

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

instanceId
string<uuid>
obrigatório

UUID da instância WhatsApp

Exemplo:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Corpo

application/json
to
string
obrigatório

Número de telefone ou chatId do destinatário

type
enum<string>
obrigatório
Opções disponíveis:
text,
image,
video,
audio,
document,
location,
template,
poll,
contact,
forward,
reaction
body
string
media_url
string
caption
string
template_name
string
template_params
object
location
object
quoted_message_id
string

ID da mensagem para responder/citar

edit_message_id
string

ID da mensagem para editar

mentions
string[]

@menções (números de telefone com @c.us)

poll
object

Dados da enquete (type=poll)

contacts
object[]

Cartões de contato (type=contact)

forward_message_id
string

ID da mensagem para encaminhar (type=forward)

reaction
string

Emoji de reação (type=reaction), string vazia para remover

reaction_message_id
string

ID da mensagem para reagir (type=reaction)

Resposta

Mensagem enfileirada para envio

message
string
obrigatório

Mensagem de confirmação

Exemplo:

"Message queued for delivery"

jobId
string
obrigatório

ID do job BullMQ para rastreamento

Exemplo:

"42"