Skip to main content
POST
Este endpoint envia uma mensagem do WhatsApp usando um modelo pré-aprovado. Mensagens de modelo são necessárias ao iniciar uma conversa com um usuário pela primeira vez ou ao enviar mensagens fora da janela 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 do WhatsApp de onde enviar (obtido do endpoint Obter Remetentes)
integer
required
O ID do modelo de mensagem a ser usado (obtido do endpoint Obter Modelos)
string
required
O número de telefone do destinatário no formato internacional (ex: +1234567890)
string
O nome do destinatário, máximo 255 caracteres (usado para rastreamento de conversas e fins de CRM)
object
Pares chave-valor para variáveis do modelo. As chaves devem corresponder aos nomes das variáveis do modelo. Se o modelo tiver variáveis {{1}}, {{2}}, etc., forneça-as como {"1": "valor1", "2": "valor2"} ou usando as chaves nomeadas do array variables do modelo.

Campos de 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 da mensagem da conversa
integer
O ID do registro da mensagem do WhatsApp
string
O SID da mensagem do Twilio para rastreamento de entrega
string
O status inicial da entrega da mensagem (ex: queued, sent)

Respostas de Erro

Notas

  • Mensagens de modelo devem usar modelos aprovados. Modelos 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 de inquilinos, minutos para usuários diretos).
  • Após enviar uma mensagem de modelo, uma janela de mensagens de 24 horas é aberta. Durante esta janela, você pode enviar mensagens livres sem precisar de um modelo.
  • Se uma conversa já existir com o destinatário, a mensagem é adicionada à conversa existente.
  • Limite de taxa: 5 requisições por segundo por usuário.