WhatsApp
Enviar Mensagem de Template
Envie uma mensagem do WhatsApp usando um template aprovado
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
pendenteourejeitadofalharã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.

