Comece com o evento e a próxima ação
Deixe visível o motivo da mensagem. Cupons, recomendações ou promoções misturados a uma atualização podem torná-la de marketing. Códigos de login exigem modelos de autenticação. Consulte Modelos de utilidade.

Meta example: a reservation confirmation gives the customer actions relevant to an existing booking.
1. Prepare o remetente, a permissão e os dados
Conecte seu número, confirme a permissão para as atualizações e prepare o evento, o destinatário, a referência da transação, as variáveis e os links de destino. Verifique as preferências atuais do cliente antes de enviar. Consulte Opt-in e Opt-out.2. Crie e teste um modelo
- Abra Modelos → Adicionar modelo para a WABA e escolha Utilidade.
- Insira um nome, idioma e a atualização específica. Use variáveis para valores de clientes ou transações e forneça exemplos fictícios representativos.
- Adicione botões relevantes, como acesso ao rastreamento, onde necessário.
- Envie e verifique a aprovação e a categoria. Consulte Revisão e ciclo de vida em caso de rejeição ou recategorização.
- Use Testar uma mensagem ou Copiar como cURL para verificar o idioma, as variáveis, os botões e as páginas de destino com um destinatário de teste.
Your order {{1}} has shipped. Estimated delivery: {{2}}., com um botão de rastreamento. Este é um conteúdo ilustrativo, não um modelo aprovado. Consulte Criar modelo.
3. Conecte o fluxo de trabalho de envio
Evento de aplicativo: API- Detecte o envio, o reembolso ou outro evento no servidor. Verifique se ele é atual e se ainda não foi processado.
- Selecione o remetente conectado, o destinatário correto, o modelo aprovado e o idioma, e mapeie as variáveis desse evento.
- Envie de forma assíncrona com
POST /v2/whatsapp/messagesou usePOST /v2/whatsapp/messages/sendDirectlyquando precisar de um resultado de envio síncrono. Prepare uma chave do lado do servidor e siga Enviar uma mensagem do WhatsApp. - Associe a mensagem ao evento de negócios e receba atualizações posteriores por meio de
whatsapp.message.updated. O sucesso da requisição não confirma o recebimento.
Opcional: Direct Send para empresas qualificadas
Com acesso ao Direct Send, você pode enviar o conteúdo completo de utilidade para a Meta fazer a correspondência ou gerar modelos. Siga o Guia do Direct Send para verificar o acesso, enviar amostras representativas, confirmar a classificação e enviar com os campos obrigatórios. Isso pode reduzir a manutenção de modelos pré-criados e de mapeamento de variáveis. As regras de conteúdo, qualidade e cobrança ainda se aplicam; não é uma rota para mensagens arbitrárias. Use um modelo de utilidade aprovado se o acesso não estiver disponível.4. Verifique os resultados
- Use os Logs de mensagens ou callbacks para distinguir entre enviado, entregue, lido e com falha.
- Teste eventos duplicados e desatualizados. Não tente reenviar um aviso antigo de falha no pagamento após o pagamento ser bem-sucedido.
- Confirme se as respostas dos clientes chegam à Caixa de entrada ou ao fluxo de processamento desejado.
- Investigue as falhas pelo motivo; a aprovação não é uma garantia de entrega.

