Enviar mensagem de texto

Amb. de Produção

https://api.way-api.io

POST

/instances/{instanceId}/messages/text

Última modificação:2026-09-17 22:00:23

Adiciona uma mensagem de texto à fila de uma instância.

A instância precisa estar conectada. A resposta 202 confirma apenas que a mensagem entrou na fila.
Para acompanhar o resultado final, cadastre os webhooks message.sent e message.failed.

Para escolher o destino:

contato: informe o telefone com país e DDD, somente com dígitos, como 5511999999999;

grupo: use o id terminado em @g.us retornado pela rota de chats;

newsletter: use o newsletterId terminado em @newsletter retornado pela rota de newsletters;

identificadores de contato terminados em @s.whatsapp.net ou @lid, retornados pelo WhatsApp, também são aceitos.

delaySeconds controla o intervalo entre mensagens da mesma instância. Por exemplo, em três requisições
seguidas com delaySeconds: 15, a primeira começa imediatamente e as próximas ficam separadas por
15 segundos. O valor padrão é 3 segundos.

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

Confirma que a mensagem entrou na fila de envio. Isso ainda não confirma a entrega no WhatsApp.

Bodyapplication/json

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠409Erro de Parâmetro

🟠422Erro de Parâmetro

🟠429

🔴500Erro do Servidor

🔴502Gateway Inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.way-api.io/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-09-17 22:00:23

Página anterior

Cancelar mensagens pendentes

Próxima página

OrderedInboundWebhookPayloadBase