Automação do estado das encomendas no WhatsApp
Uma automação do estado de encomendas no WhatsApp responde a «onde está a minha encomenda?» com dados em tempo real do próprio sistema da loja. Um passo por palavra-chave deteta a pergunta, um webhook envia a mensagem e o número de telefone do cliente para o backend da loja, e o backend devolve o estado como resposta. As atualizações de envio que a loja envia primeiro seguem como templates de utilidade aprovados.
A easyCoexistence liga o número de WhatsApp Business que a sua loja já usa na app ao Cloud API da Meta através da Coexistência.
Tempo de que o backend da loja dispõe para devolver uma resposta; passado esse prazo, o passo do webhook falha e é enviado um email.
O número de WhatsApp do cliente, em dígitos internacionais, enviado com a mensagem para que o backend encontre encomendas pelo telefone.
A resposta mais longa enviada como um único texto de WhatsApp; o que for mais longo é cortado.
A categoria da Meta para confirmações de encomenda e avisos de envio: não promocional e específica da encomenda do cliente.
A Meta trata como marketing um template que associa uma atualização de encomenda a uma promoção.
O throughput fixo da Meta para um número Coexistence, o limite para uma rajada de atualizações de envio.
Como funciona uma resposta automática sobre o estado da encomenda?
O estado está no sistema da loja, por isso o trabalho da automação é levar a pergunta até lá e trazer a resposta de volta. Uma automação por palavra-chave capta as perguntas sobre encomendas, o seu passo Call my webhook envia-as para o backend, e a resposta do backend sai do seu número de WhatsApp Business. A easyCoexistence não guarda dados de encomendas: o registo de execução guarda a mensagem e a resposta durante 30 dias, e a sua loja continua a ser a fonte de verdade. A mesma consulta pode ser também um passo Call an API, que chama diretamente a API da sua loja e guarda a resposta JSON para os passos seguintes.
Que mensagens devem iniciar a consulta?
As perguntas sobre encomendas são fáceis de reconhecer pelas palavras, por isso uma automação por palavra-chave serve bem. Parta de Send to my system e mude o gatilho para Has keyword com Contains, ou parta de Keyword reply e troque o passo por Call my webhook. Acrescente as palavras de cada língua em que vende, até 30. As outras perguntas passam para as restantes automações, como um agente em Every message, porque as automações por palavra-chave são verificadas primeiro e só uma automação responde a cada mensagem.
- Inglês: order, tracking, delivery, shipped, where is my.
- Português: pedido, rastreio, rastreamento, entrega, encomenda.
- Espanhol: envío, envio, seguimiento, paquete (pedido e entrega já estão na lista).
- Símbolos: # capta números de encomenda escritos como #1042.
O que recebe o backend da loja, e o que deve devolver?
Um POST JSON assinado em X-EC-Signature com o Signing secret da automação. Os campos que importam para uma consulta são contact.wa_id, o número de WhatsApp do cliente em dígitos internacionais sem o sinal de mais, e message.text, onde pode aparecer um número de encomenda. Procure as encomendas mais recentes desse telefone, ou extraia o número do texto, e responda com HTTP 200 e um corpo JSON cujo campo reply contenha o texto a enviar. Mantenha a resposta simples e breve: até 4,096 caracteres saem como uma única mensagem, e títulos ou links em markdown aparecem como símbolos em bruto.
Request (trimmed):
{
"event": "automation.step",
"dry_run": false,
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "type": "text", "text": "Hi, where is my order #1042?" },
"history": [ … up to 10 recent messages, oldest first … ]
}
Response, HTTP 200, within 20 seconds:
{ "reply": "Hi Ana! Order #1042 left our warehouse today and should arrive by Friday. Tracking: https://track.example/1042" }O que deve o backend dizer quando não encontra a encomenda?
Algo útil em cada caso. Só uma automação responde a cada mensagem, e um passo colocado depois do webhook correria também após uma resposta bem-sucedida, por isso o backend também gere os textos alternativos (com um passo Call an API em vez do webhook, um passo Split into paths pode ramificar consoante a resposta):
- Encomenda encontrada: o estado, a data prevista e o link de rastreio.
- Sem encomenda para este telefone: pedir o número da encomenda ou o email usado na compra.
- Várias encomendas em aberto: listá-las brevemente e perguntar qual.
- Encomenda perdida ou danificada: dizer que uma pessoa responderá neste chat, e alertar a sua equipa.
- Um teste, com
dry_runtrue: devolver uma resposta de exemplo e não alterar nada. - Backend em baixo ou mais lento do que 20 segundos: o passo falha, nada é enviado, e um email avisa para responder diretamente.
Como enviar atualizações de envio antes de o cliente perguntar?
As atualizações proativas são mensagens que a sua empresa inicia, por isso saem como templates aprovados, enviados pelo sistema da loja através da Cloud API quando uma encomenda muda de estado. Crie-os na categoria de utilidade, a que a Meta usa para confirmações de encomenda e avisos de envio; um desconto ou uma sugestão de produto no mesmo template torna-o marketing. A sua IA pode redigi-los e submetê-los com create_template, usando {{1}} para o nome e {{2}} para o número da encomenda, com valores de exemplo, e verificar a aprovação com get_template_status. Depois, a loja chama o endpoint de envio obtido em get_api_credentials a partir dos seus próprios eventos de encomenda, ou faz um post para o URL de uma automação com o gatilho O seu sistema chama um URL (o exemplo Atualizações do seu sistema), que envia o template com os dados da encomenda de {{vars.webhook.*}}; as páginas da Shopify e do WooCommerce mostram essa ligação. A Meta fatura as mensagens de template por mensagem, por categoria e por país, na sua própria WhatsApp Business Account.
O que acontece quando um cliente responde a uma atualização de envio?
A resposta abre uma nova janela de 24 horas, e as suas automações tratam-na como qualquer mensagem recebida: uma resposta por palavra-chave, a consulta de encomenda ou o assistente de IA. Há um pormenor importante. Um cliente cuja conversa não tem histórico recente conta como estar a escrever pela primeira vez, por isso uma automação First message pode cumprimentar alguém que apenas responde ao seu aviso de envio; redija a boas-vindas para que também funcione bem depois de uma atualização. Num número Coexistence, o template que a loja enviou fica na conversa da app, por isso a equipa vê o contexto antes de intervir.
Como configurar
- Expose an order lookupAdd an HTTPS endpoint, or an n8n workflow, that verifies X-EC-Signature, finds orders by contact.wa_id or the number in message.text and returns {"reply": "..."}.
- Create the automation, switched OffStart from Send to my system, change the trigger to Has keyword, add your order words, paste the URL into Webhook URL, set the switch to Off and click Save.
- Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's configuration.
- Test with Run testClick Test and send "where is my order #1042?" in Try it. Your endpoint receives dry_run true and the sample contact 15550000000.
- Switch it On, then add shipping templatesSwitch the automation On and save, then create utility templates for confirmed, shipped and delivered orders, sent by your store.
Erros comuns
- Devolver o estado com outro nome de campo. Só uma string de topo chamada reply é enviada; qualquer outra coisa fica registada como sem resposta e o cliente não ouve nada.
- Comparar contact.wa_id com telefones digitados na compra tal como estão. O wa_id tem o indicativo do país e nenhum sinal de mais, espaço ou traço; compare apenas os dígitos.
- Acrescentar um passo Reply with text depois do webhook como alternativa. Também corre depois de uma resposta bem-sucedida, por isso o cliente recebe duas mensagens; devolva o texto alternativo a partir do backend.
- Pôr um cupão no template de envio. A Meta trata conteúdo misto como marketing e pode recategorizá-lo ou rejeitá-lo; mantenha as ofertas em templates de marketing separados.
O seu passo Call my webhook leva as perguntas sobre encomendas ao seu backend e devolve a resposta, com assinatura, um limite de 20 segundos e um email de falha, e get_api_credentials dá à sua loja o que precisa para enviar templates de envio. As automações não têm custo adicional. De US$ 9 a US$ 0.75 por número ligado por mês, com descida à medida que acrescenta números, e os primeiros 3 dias grátis.
Perguntas frequentes
Um passo de IA pode responder a perguntas sobre encomendas em vez de uma palavra-chave?
Sim. Um agente de IA com uma ferramenta personalizada, um URL com parâmetros como o número da encomenda e cabeçalhos opcionais, pode consultar a encomenda por si, ou o modelo pode estar atrás do webhook, por exemplo um nó AI Agent do n8n com uma ferramenta de consulta de encomendas que devolve o seu texto como reply. Um passo Reply with AI, sozinho, lê apenas as suas instruções e a conversa, por isso não tem dados de encomenda em tempo real.
E se o cliente enviar a encomenda como foto ou mensagem de áudio?
Uma foto chega como [image] seguida da legenda, por isso uma palavra-chave só dá correspondência se a legenda tiver a palavra, embora um agente de IA possa ver a imagem com a sua chave. Uma mensagem de voz é transcrita com a sua chave da OpenAI ou do OpenRouter e guardada como [voice message] seguida das palavras, com as quais uma palavra-chave pode dar correspondência; sem essa chave, fica apenas [voice message]. Faça com que a IA ou uma resposta fixa peça o número da encomenda em texto.
A automação pode enviar a fatura ou uma etiqueta de envio em PDF?
Sim, a partir do backend: envie o documento através da Cloud API com as credenciais do número, até 24 horas após a última mensagem do cliente, e devolva uma resposta curta a dizer que o ficheiro está a caminho. A resposta do webhook transporta apenas texto. Um ficheiro fixo, como uma lista de preços, pode sair do passo Send a picture or file.
Quantas perguntas sobre encomendas consegue tratar em simultâneo?
As execuções são independentes, por isso vários clientes podem perguntar ao mesmo tempo. A easyCoexistence espaça os envios para no máximo 10 por segundo por número, abaixo dos 20 por segundo da Meta para números em Coexistência, e o seu backend só tem de responder a um POST em 20 segundos.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em