Pular para o conteúdo
D-APITestar grátis

envio de mensagens

Enviar mensagem WhatsApp API a partir do seu sistema, com ordem e confirmação

Para enviar mensagem WhatsApp API pela D-API, basta um POST com sessionId, to e text. Por cima disso vêm resposta citada, menção, fila assíncrona com ordem por contato, edição e eventos de entrega e leitura para o seu SaaS acompanhar cada envio.

SaaS testa 14 dias com o time técnico ajudando na integração.

conexões na D-API
1.875
de uptime garantido em contrato
99,9%
datacenters no Brasil
4
por ligação de WhatsApp na API não-oficial
R$ 0
  • Um POST, três campos

    sessionId, to e text bastam para o primeiro envio. A resposta traz o messageId para você ligar a mensagem ao registro no seu banco.

  • Fila com ordem por contato

    Com async e sequential, as mensagens para o mesmo contato saem na ordem em que chegaram à API, e as de outros contatos seguem em paralelo.

  • Entrega e leitura por webhook

    Os eventos message.delivered e message.read trazem o message_id, para o seu produto mostrar os dois tiques sem consultar nada.

Enviar mensagem pela WhatsApp API é a primeira coisa que todo SaaS integra, e a que mais aparece para o cliente final. É o lembrete da consulta, o “seu pedido saiu para entrega”, o retorno do vendedor no CRM. Na D-API, o envio é uma chamada HTTP com três campos obrigatórios, e o resto da integração existe para responder a perguntas que surgem logo depois: a mensagem chegou? Foi lida? Saiu na ordem certa? Dá para corrigir?

Esta página cobre o envio de texto de ponta a ponta, dentro da API de WhatsApp da D-API. Para imagem, áudio, vídeo e documento, veja enviar mídia pela API.

Como enviar mensagem de texto pela API

A rota é POST /api/v1/messages/send/text, autenticada pelo header Authorization com a sua API key.

curl -X POST https://api.d-api.cloud/api/v1/messages/send/text \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "clinica-vida-recepcao",
    "to": "5511999999999",
    "text": "Oi, Marcos! Sua consulta com a Dra. Paula é amanhã às 9h. Responda 1 para confirmar."
  }'
{
  "success": true,
  "message": "Text message sent successfully",
  "sessionId": "clinica-vida-recepcao",
  "to": "5511999999999",
  "messageId": "3EB0C767D26B8CA3F7A1",
  "messageType": "text",
  "timestamp": "2026-09-03T04:15:22.318Z"
}

Guarde o messageId junto do registro que originou o envio, seja o agendamento, o pedido ou o card do lead. É por ele que os eventos de entrega e leitura vão se conectar ao seu dado.

O to aceita o número no formato internacional, só com dígitos. Também aceita um JID completo, como o de um grupo ([email protected]), o que faz a mesma rota servir para conversa individual e para grupo. Se os seus clientes importam contatos sem o 55, a configuração assume-br-country-code-settings da sessão faz a API assumir o código do Brasil para números sem DDI, com validação de DDD.

Três campos opcionais deixam a mensagem com cara de conversa de verdade.

Resposta citada. Para responder a uma mensagem específica, como o atendente do helpdesk respondendo à pergunta do cliente, envie contextInfo com o stanzaId (o id da mensagem original) e o participant (quem a enviou). A mensagem aparece no celular do contato com o balão citado em cima.

{
  "sessionId": "helpdesk-acme",
  "to": "5511999999999",
  "text": "Já gerei a segunda via, segue no próximo e-mail.",
  "contextInfo": {
    "stanzaId": "BAE5C3F2E3D4",
    "participant": "[email protected]",
    "quotedMessage": { "conversation": "Pode mandar a segunda via do boleto?" }
  }
}

Menção. Em grupos, contextInfo.mentionedJid menciona pessoas específicas, e mentionAll: true menciona todos os participantes. Uma edtech avisa a turma inteira da aula ao vivo com uma chamada só.

Prévia de link. linkPreview: true gera o cartão de pré-visualização do link no texto. linkPreviewUrl define qual URL usar para a prévia e linkPreviewSmall escolhe o formato compacto.

Envio assíncrono e ordem garantida por contato

Por padrão, a API só responde depois que o WhatsApp executou o envio. Para um disparo de lembretes da agenda inteira do dia, segurar cada request até a mensagem sair deixa o seu worker lento. Com async: true, a API coloca o envio na fila, responde na hora com um commandId e executa em segundo plano.

{
  "sessionId": "clinica-vida-recepcao",
  "to": "5511999999999",
  "text": "Lembrete: traga os exames anteriores.",
  "async": true,
  "sequential": true
}

O resultado chega no webhook command.result, com o mesmo commandId, e também pode ser consultado em GET /api/v1/commands/{commandId} por cerca de uma hora. Atenção a um detalhe: o status: "completed" diz que o comando rodou. Se o envio falhou, por número inválido ou sessão desconectada, o comando fica completed com result.success: false.

Os comandos assíncronos rodam em paralelo, então dois envios seguidos para o mesmo contato podem chegar trocados, como uma imagem pesada saindo depois do texto que veio em seguida. O sequential: true resolve: envios para o mesmo destinatário saem um de cada vez, na ordem de chegada na API, enquanto os de outros destinatários continuam em paralelo. Uma falha não trava a sequência; ela aparece no command.result daquele envio e o próximo sai normalmente.

Cada destinatário aceita até 100 envios pendentes na sequência. Acima disso, a API responde 429 com o header Retry-After, de 1 a 60 segundos. E como a ordem preservada é a de chegada, dispare em série do seu lado: espere a resposta de um request, que é imediata, antes de mandar o próximo. A página de comandos assíncronos e a documentação da D-API detalham o fluxo.

Confirmar entrega e leitura pelo webhook

Depois do envio, o ciclo de vida da mensagem chega como evento. message.delivered avisa que a mensagem foi entregue ao aparelho do contato e message.read, que ela foi lida. Os dois têm o mesmo formato:

{
  "event": "message.read",
  "sessionId": "clinica-vida-recepcao",
  "timestamp": "2026-01-24T23:00:00.000Z",
  "data": {
    "message_id": "3EB0F61B5D1F94FAFCD306",
    "remote_jid": "[email protected]",
    "participant": "",
    "timestamp": 1769295600000
  }
}

Em grupos, o participant indica quem leu; em conversa individual, vem vazio. Confirmações repetidas do mesmo status dentro de 30 segundos são deduplicadas. Com esses dois eventos, o seu painel mostra os tiques de entrega e leitura e o seu relatório calcula taxa de leitura por campanha ou por atendente. A lista de todos os eventos está em eventos de webhook.

As mensagens enviadas pelo celular do cliente, fora do seu sistema, também chegam, no evento messages.sent. Assim o histórico no seu produto fica completo mesmo quando o atendente responde pelo telefone.

Editar e apagar mensagens enviadas

Erro de digitação acontece, e o seu usuário vai querer corrigir. PUT /api/v1/messages/{messageId} edita o texto de uma mensagem, ou a legenda de uma imagem, vídeo ou documento, enviada pela API. O corpo leva sessionId, to e o novo text. O WhatsApp só aceita a edição até 15 minutos depois do envio, então esconda o botão de editar passado esse prazo.

Do lado de quem recebe, edições feitas pelo contato chegam em messages.received com type: "edited_message".

Além do texto: enquete, localização, contato e reação

A mesma família de rotas cobre outros formatos que aparecem no dia a dia de um SaaS:

Rota Uso típico
/messages/send/poll Pesquisa rápida com 2 a 12 opções, com ou sem múltipla escolha
/messages/send/location Endereço da loja ou ponto de retirada, com latitude, longitude, nome e endereço
/messages/send/contact Cartão de contato do vendedor responsável
/messages/send/reaction Reagir a uma mensagem; emoji vazio remove a reação

A página de enquete, localização, contato e reação mostra os payloads de cada um. Para listas, carrossel e botão de Pix, o artigo sobre mensagens interativas é o próximo passo.

Time D-API. Atualizado em .

Perguntas frequentes

Existe limite de mensagens por mês na API não oficial?

A D-API não cobra nem limita por volume de mensagens na API não oficial; a cobrança é por conexão ativa. As cotas que o próprio WhatsApp aplica à conta podem ser consultadas em GET /api/v1/limits/{sessionId}.

Posso enviar para um número que ainda não salvou o contato da empresa?

Pode. O envio só exige que o número tenha WhatsApp. Para confirmar isso antes, use POST /api/v1/contacts/check com a lista de números.

A rota de envio é a mesma para a API Oficial?

É. Uma sessão da Cloud API usa o mesmo POST /api/v1/messages/send/text. A diferença é que nela o envio é sempre síncrono e o sequential é ignorado.

Consigo apagar uma mensagem enviada?

Sim, com DELETE /api/v1/chats/messages/{messageId}. A exclusão também gera o evento message.deleted no webhook.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.