Confirmações de pedido e atualizações de envio automáticas no WhatsApp
Confirmações automáticas de pedido no WhatsApp são templates de utilidade aprovados. O próprio sistema da loja os envia pela Cloud API da Meta quando acontece um evento do pedido: pedido realizado, enviado, saiu para entrega e entregue. Cada template cita o pedido específico e não traz nenhuma oferta, como exige a categoria de utilidade da Meta. A resposta do cliente abre uma janela de 24 horas em que respostas automáticas podem ser enviadas.
O easyCoexistence conecta à Cloud API da Meta, pela Coexistência, o número do WhatsApp Business que sua loja já usa no app, e entrega as credenciais à sua loja, no painel ou via get_api_credentials.
Categoria da Meta para mensagens que confirmam, atualizam ou cancelam um pedido com detalhes específicos desse pedido, sem promoção nem oferta de produtos adicionais.
A Meta classifica como template de marketing uma atualização de pedido que também traz uma promoção.
Tempo de vida padrão de um template de utilidade, que também pode ser definido entre 30 segundos e 12 horas.
Pessoas únicas para quem um novo Portfólio de Negócios pode enviar mensagens fora de uma janela de atendimento, em um período móvel de 24 horas.
Throughput fixo de um número usado ao mesmo tempo no app do WhatsApp Business e na Cloud API.
Mensagens enviadas pela Cloud API em um número com Coexistência também aparecem no app do WhatsApp Business.
Quais mensagens de pedido podem ser enviadas automaticamente?
Cada etapa do pedido pode ter o próprio template aprovado, que o sistema da loja envia quando essa etapa acontece. As diretrizes da categoria de utilidade da Meta listam exatamente estes usos: confirmar um pedido, informar o código de rastreio e a data de entrega, avisar sobre um item em falta aguardando reposição e confirmar um reembolso. Use um template por evento. Assim cada um diz uma coisa só e pode ser reescrito sem mexer nos outros. Uma loja que despacha no mesmo dia pode precisar de apenas três deles.
Como é um template de utilidade para pedidos?
É um corpo curto que cita o cliente e o pedido, com variáveis posicionais com valores de exemplo e um botão opcional. O exemplo abaixo é o que uma IA submete via create_template depois do comando "create a utility template for shipped orders with a tracking button". O botão de rastreio tem uma variável no fim da URL, preenchida para cada pedido no momento do envio. Escreva algum texto depois da última variável, porque a Meta rejeita um corpo que termina com uma. Deixe de fora descontos, sugestões de produtos e pedidos de avaliação: qualquer um deles faz o template ser classificado como marketing.
{
"connection_id": "<from list_numbers>",
"name": "order_shipped",
"language": "en_US",
"category": "UTILITY",
"components": [
{
"type": "BODY",
"text": "Hi {{1}}, your order #{{2}} has shipped with {{3}}. It should arrive by {{4}}.",
"example": { "body_text": [["Ana", "1042", "DHL", "Friday, May 8"]] }
},
{
"type": "BUTTONS",
"buttons": [
{
"type": "URL",
"text": "Track package",
"url": "https://shop.example.com/track/{{1}}",
"example": ["https://shop.example.com/track/1042"]
}
]
}
]
}Como a loja envia cada atualização?
Pela Cloud API da Meta, a partir do próprio sistema da loja, com as credenciais do número. No painel do easyCoexistence, o cartão "Plug in your own system" do número mostra o endpoint Send e a opção "Reveal access token". Sua IA retorna os mesmos valores com get_api_credentials. A loja, ou um fluxo do n8n, Make ou Zapier que escuta os eventos de pedido, envia uma requisição por cliente e preenche as variáveis com os dados do pedido. A variável do botão de rastreio vai em um componente de botão separado, como nesta requisição. Sem código Graph, uma automação com o gatilho Your system calls a URL faz o envio: a loja envia {"to": "+5511987654321", "name": "Ana", "order": "1042"} para a URL mostrada no editor, com o segredo da automação como Bearer token, e uma etapa Send a template preenche o template a partir de {{vars.webhook.name}} e {{vars.webhook.order}}.
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>
{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "template",
"template": {
"name": "order_shipped",
"language": { "code": "en_US" },
"components": [
{ "type": "body", "parameters": [
{ "type": "text", "text": "Ana" },
{ "type": "text", "text": "1042" },
{ "type": "text", "text": "DHL" },
{ "type": "text", "text": "Friday, May 8" }
]},
{ "type": "button", "sub_type": "url", "index": "0",
"parameters": [{ "type": "text", "text": "1042" }] }
]
}
}A sua IA pode enviar a atualização do pedido em vez da loja?
Sim, para as atualizações que alguém decide na hora. Com o conector do easyCoexistence no ChatGPT ou no Claude, "tell Ana at 5511987654321 that order 1042 is delayed until Monday, with the order_delayed template" vira uma chamada send_template para um único destinatário, e o ChatGPT pode pedir sua confirmação antes de executar. Isso serve para uma encomenda atrasada, um pedido manual ou o teste de um template novo. As atualizações de rotina devem ficar no sistema da loja, porque um assistente só age enquanto alguém conversa com ele. Elas saem do sistema da loja, ou por uma automação que o seu sistema inicia chamando a URL dela, e que pode enviar um template aprovado a um cliente que não acabou de escrever para o número.
O que acontece quando o cliente responde a uma atualização?
A resposta chega no app do WhatsApp Business, logo abaixo do template que a loja enviou, e abre uma janela de 24 horas em que você pode responder com qualquer texto. Em um número cujas mensagens passam pelo easyCoexistence, ela também pode disparar uma automação. Uma automação Has keyword pode identificar dúvidas sobre o pedido e encaminhá-las ao seu backend com Call my webhook, que é a configuração descrita na página de status do pedido. Um botão de resposta rápida no template, como "Change address", chega como uma mensagem com o texto do botão, então uma automação por palavra-chave configurada como Is exactly pode responder a esse toque. Um detalhe: um cliente sem conversa recente conta como quem escreve pela primeira vez, então escreva a saudação de First message de forma que ela faça sentido depois de uma atualização de pedido; um cliente cuja atualização saiu por uma automação iniciada pelo seu sistema já tem um chat do nosso lado, então a resposta dele não é uma primeira mensagem.
Como saber se a atualização chegou ao cliente?
A Meta informa no webhook dela um status de enviada, entregue, lida ou com falha para as mensagens que o número envia. Com o número definido como Through easyCoexistence e uma Forward URL, esses status chegam ao seu sistema assinados por número, dentro do payload original da Meta. Com Send straight to my system, a Meta os envia direto ao seu endpoint. Só marque uma atualização como entregue depois que o status delivered chegar, já que uma requisição aceita não significa entrega. O tempo de vida importa para atualizações com prazo: por padrão, a Meta continua tentando entregar um template de utilidade por 30 dias. Defina algumas horas para out_for_delivery e a Meta descarta a mensagem quando esse prazo passar, em vez de entregar uma notícia de ontem.
Como configurar
- Collect WhatsApp opt-in at checkoutAdd a line near the phone field that names your business and says order updates come by WhatsApp, and save the phone in international format.
- Get the templates approvedAsk your AI to create order_confirmed, order_shipped and order_delivered as UTILITY with create_template, then check get_template_status until each reads APPROVED.
- Copy the credentialsOpen the number in the dashboard, find "Plug in your own system", copy the Send endpoint and click "Reveal access token". Store the token on a server.
- Wire each order event to a sendIn your store or n8n workflow, post the matching template when an order is placed, fulfilled or delivered, with the variables taken from the order.
- Answer the repliesKeep the number on Through easyCoexistence under Where incoming messages go, and add a keyword automation with Call my webhook for order questions, plus a Forward URL to receive delivery statuses.
Erros comuns
- Acrescentar "10% off your next order" ao template de envio. A Meta trata conteúdo misto como marketing, então a atualização é aprovada, ou reclassificada depois, como template de marketing, e passa a ser cobrada e limitada como tal.
- Escolher o template de rastreio na etapa Send a template de uma automação. As automações ainda não conseguem preencher um botão de URL com variável; envie esse template pelo sistema da loja.
- Deixar out_for_delivery com o tempo de vida padrão de 30 dias. Um celular que volta a ficar online dois dias depois ainda recebe "arriving today"; defina algumas horas.
- Tratar o ID da mensagem na resposta da Meta como prova de entrega. Envios aceitos ainda podem falhar; espere o status delivered antes de marcar a atualização como enviada.
Assim, confirmações e atualizações de envio saem do número que os clientes já conhecem e aparecem na conversa do app. As automações respondem às mensagens dos clientes, e cada número é monitorado 24/7, com um aviso por e-mail quando a Meta deixa de entregar os templates dele. De R$ 29,90 a R$ 3,90 por número por mês, com o valor caindo conforme você adiciona números, e os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Preciso de opt-in do cliente para enviar confirmação de pedido pelo WhatsApp?
Sim. A política da Meta vale para qualquer mensagem iniciada pela empresa: o cliente precisa ter informado o número e concordado em receber mensagens da sua empresa. Desde novembro de 2024, essa permissão pode ser geral, sem citar o WhatsApp, desde que identifique a empresa e siga a lei local. Uma frase clara no checkout resolve.
A Meta cobra pelas confirmações de pedido no WhatsApp?
A Meta cobra as mensagens de template por mensagem, conforme a categoria e o país do cliente, direto na sua própria conta do WhatsApp Business. A página de preços da Meta traz as regras atuais para os seus mercados. O easyCoexistence não cobra margem nem taxa por mensagem, e as automações não têm custo adicional.
Dá para enviar a nota fiscal em PDF junto com a confirmação?
Sim, pelo sistema da loja: um template com cabeçalho de documento recebe o link do PDF no momento do envio. As automações não conseguem enviar um template com mídia no cabeçalho. A etapa Send a picture or file envia um PDF que você carregou, o mesmo para todos, então a nota fiscal de cada pedido sai pelo sistema da loja ou pela chamada send_template da sua IA.
E se o número do cliente não tiver WhatsApp?
A Meta aceita a requisição e depois informa um status de falha, geralmente o erro 131026, de mensagem não entregável. Configure seu sistema para monitorar os status de falha e enviar a atualização desse cliente por e-mail ou SMS. Assim ninguém fica sem a confirmação por causa de um erro de digitação no checkout.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em