Enviar mensagem de texto

Amb. de Desenv.

http://localhost:3000

POST

/instances/{instanceId}/messages/text

Envia uma mensagem de texto para um único destino.

Use targetId como identificador do chat/grupo obtido em GET /instances/{instanceId}/chats.

Delay:

delaySeconds é opcional e aceita de 1 a 30 segundos

se não for enviado, a API usa 3 segundos por padrão

se não existir fila futura válida para a instância, a primeira mensagem dispara na hora

se já existir fila futura válida, a próxima mensagem entra após a última mensagem agendada

Exemplos práticos:

se você mandar 3 requisições seguidas com delaySeconds = 15, a primeira sai na hora, a segunda entra 15 segundos depois e a terceira entra 15 segundos depois da segunda

se você mandar 1 mensagem agora e depois de 30 minutos mandar mais 10, a primeira dessa nova leva dispara na hora quando a fila anterior já tiver acabado; as outras entram respeitando o delay

Requisição

Authorization

Adicionar parâmetro em header

x-api-key

Exemplo:

x-api-key: ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢202Aceite

application/json

Resposta de aceite para envio assíncrono de mensagem.

Body

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠422Erro de Parâmetro

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://localhost:3000/instances//messages/text' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "targetId": "120363123456789@g.us",
    "text": "Olá! Esta mensagem entra 15 segundos após a última mensagem agendada.",
    "delaySeconds": 15
}'

Response Example

202 - Mensagem de texto enfileirada

{
    "messageId": "018f47ac-7a5b-7cc2-9f9a-9b8d7f6e5d4c",
    "type": "text",
    "status": "queued"
}

Modificado em 2026-04-17 20:31:44

Página anterior

Enviar mensagem com preview de link

Próxima página

Criar ou atualizar webhook