> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Enviar mensagens de utilidade via WhatsApp
Use mensagens de utilidade para atualizações sobre uma transação existente, conta ou solicitação de serviço. Os clientes podem verificar uma remessa, revisar um agendamento ou responder para pedir ajuda. Sua equipe pode acompanhar os resultados das notificações e reduzir explicações repetitivas de status.
## Comece com o evento e a próxima ação
| Cenário | Incluir | Ação do cliente |
| - | - | - |
| Pedido enviado | Referência do pedido, status de envio e acesso ao rastreamento. | Rastrear o envio ou solicitar ajuda. |
| Agendamento alterado | O agendamento existente e o novo horário. | Revisar detalhes ou solicitar uma alteração. |
| Reembolso concluído | Referência do pedido, valor e status do reembolso. | Verificar o reembolso. |
| Informações da conta alteradas | A alteração realizada e a explicação relevante. | Confirmar ou relatar um problema. |
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](/pt/documentation/whatsapp-business-platform/messaging/message-templates/utility-templates).
Fonte: [Modelos de utilidade da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/utility-templates/utility-templates).
## 1. Prepare o remetente, a permissão e os dados
[Conecte seu número](/pt/documentation/quick-start/connect-whatsapp-to-ycloud), 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](/pt/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-in) e [Opt-out](/pt/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out).
## 2. Crie e teste um modelo
1. Abra **Modelos → Adicionar modelo** para a WABA e escolha **Utilidade**.
2. 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.
3. Adicione botões relevantes, como acesso ao rastreamento, onde necessário.
4. Envie e verifique a aprovação e a categoria. Consulte [Revisão e ciclo de vida](/pt/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle) em caso de rejeição ou recategorização.
5. Use [Testar uma mensagem](/pt/documentation/channels/whatsapp-accounts-management/template-management/test-a-message) 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.
Por exemplo: `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](/pt/documentation/channels/whatsapp-accounts-management/template-management/create-template/index).
## 3. Conecte o fluxo de trabalho de envio
**Evento de aplicativo: API**
1. Detecte o envio, o reembolso ou outro evento no servidor. Verifique se ele é atual e se ainda não foi processado.
2. Selecione o remetente conectado, o destinatário correto, o modelo aprovado e o idioma, e mapeie as variáveis desse evento.
3. Envie de forma assíncrona com `POST /v2/whatsapp/messages` ou use `POST /v2/whatsapp/messages/sendDirectly` quando precisar de um resultado de envio síncrono. Prepare uma chave do lado do servidor e siga [Enviar uma mensagem do WhatsApp](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message).
4. 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.
**Um público selecionado: Campanha**
Abra **Campanha → Adicionar campanha → WhatsApp**. Escolha o remetente, o modelo de utilidade, o idioma e o horário de envio. Selecione os destinatários, mapeie as variáveis, visualize e envie. Cada destinatário precisa de um contexto comercial correspondente genuíno. Os arquivos podem fornecer valores de pedidos diferentes por cliente; consulte [Criar uma campanha](/pt/documentation/campaign/create-a-whatsapp-marketing-campaign).
**Múltiplas etapas ou integração de comércio**
Use os gatilhos e componentes suportados de [Journey](/pt/documentation/journey/create-a-journey) quando precisar de esperas, ramificações ou ações posteriores. Usuários do Shopify podem usar [notificações de pedidos cancelados e atendidos](/pt/documentation/integrations/e-commerce/shopify/notify-customers-about-canceled-or-fulfilled-orders). Escolha um único fluxo de trabalho para gerenciar uma notificação, para que uma API e uma integração não enviem o mesmo evento.
## 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](/pt/api-reference/guides/whatsapp-platform/best-practices/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](/pt/documentation/channels/whatsapp-accounts-management/data-analysis/message-logs) 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.
Monitore a entrega, as falhas e as ações subsequentes dos clientes. Consulte os [Preços do WhatsApp](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing) para conferir as tarifas.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.