Enviar mensagem de texto

Envia uma mensagem de texto para um único DM, grupo ou newsletter.

A instância precisa estar conectada para este envio funcionar. Se ela estiver desconectada, a API retorna 422 e não enfileira a mensagem.

targetId aceita telefone internacional puro (12 a 15 dígitos), JID PN, LID, grupo (@g.us) e newsletter (@newsletter). Telefone puro é normalizado para @s.whatsapp.net; a API nunca inclui @g.us implicitamente. Para grupos, a instância precisa participar do grupo.

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

Respostas

🟢202Aceite

application/json

Resposta de aceite para envio assíncrono de mensagem.

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

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 }'