Skip to main content
POST
Este endpoint envia uma mensagem do WhatsApp usando um template pré-aprovado. Mensagens de template são necessárias ao iniciar uma conversa com um usuário pela primeira vez ou ao enviar mensagens fora da janela de mensagens de 24 horas.
Este endpoint tem limite de taxa de 5 requisições por segundo por usuário.

Corpo da Requisição

integer
required
O ID do remetente WhatsApp para enviar (obtido do endpoint Obter Remetentes)
integer
required
O ID do template de mensagem a ser usado (obtido do endpoint Obter Templates)
string
required
O número de telefone do destinatário em formato internacional (ex: +1234567890)
string
O nome do destinatário, máximo 255 caracteres (usado para rastreamento de conversa e finalidades de CRM)
object
Pares chave-valor para variáveis do template. As chaves devem corresponder aos nomes das variáveis do template. Se o template tiver variáveis {{1}}, {{2}}, etc., forneça-as como {"1": "valor1", "2": "valor2"} ou usando as chaves nomeadas do array variables do template.

Campos da Resposta

boolean
Se a mensagem foi enviada com sucesso
integer
O ID da conversa (nova ou existente) associada a esta mensagem
integer
O ID do registro de mensagem da conversa
integer
O ID do registro da mensagem WhatsApp
string
O SID da mensagem Twilio para rastreamento de entrega
string
O status inicial de entrega da mensagem (ex: queued, sent)

Respostas de Erro

Observações

  • Mensagens de template devem usar templates aprovados. Templates com status pendente ou rejeitado falharão.
  • O remetente deve estar online. Remetentes offline não podem enviar mensagens.
  • Os custos das mensagens são automaticamente deduzidos do saldo da sua conta (créditos para usuários tenant, minutos para usuários diretos).
  • Após enviar uma mensagem de template, uma janela de mensagens de 24 horas se abre. Durante esta janela, você pode enviar mensagens livres sem precisar de um template.
  • Se uma conversa já existe com o destinatário, a mensagem é adicionada à conversa existente.
  • Limite de taxa: 5 requisições por segundo por usuário.