EntrarComeçar teste grátis
Meta Tech Provider

Automação de status de pedido no WhatsApp

Uma automação de status de pedido no WhatsApp responde "onde está meu pedido?" com dados em tempo real do próprio sistema da loja. Uma etapa por palavra-chave identifica 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 status como resposta. As atualizações de envio que a loja dispara por iniciativa própria saem como templates de utilidade aprovados.

O easyCoexistence conecta o número do WhatsApp Business que sua loja já usa no app à Cloud API da Meta por meio da Coexistência.

20 seconds

Tempo que o backend da loja tem para devolver uma resposta antes que a etapa de webhook falhe e você receba um e-mail.

contact.wa_id

O número de WhatsApp do cliente em dígitos internacionais, enviado junto com a mensagem para que o backend encontre os pedidos pelo telefone.

4,096 characters

Tamanho máximo de uma resposta enviada como um único texto de WhatsApp; o que passar disso é cortado.

Utility

Categoria da Meta para confirmações de pedido e avisos de envio: não promocional e específica do pedido do cliente.

Mixed content

A Meta trata como marketing um template que combina atualização de pedido com promoção.

20 msg/s

Throughput fixo da Meta para um número de Coexistência, o teto para um pico de atualizações de envio.

Como funciona uma resposta automática de status de pedido?

O status fica no sistema da loja, então o trabalho da automação é levar a pergunta até lá e trazer a resposta de volta. Uma automação por palavra-chave identifica perguntas sobre pedidos, a etapa Call my webhook dela envia essas mensagens ao seu backend, e a resposta do backend sai pelo seu número do WhatsApp Business. O easyCoexistence não guarda dados de pedidos: o log de execuções mantém a mensagem e a resposta por 30 dias, e a sua loja continua sendo a fonte da verdade. A mesma consulta também pode ser uma etapa Call an API, que chama diretamente a API da sua loja e guarda a resposta em JSON para as etapas seguintes.

1Customer asks"Where is my order #1042?" to your number
2Has keywordorder, pedido, tracking or # starts the automation
3Call my webhookSigned POST with the message and the customer's number
4Your store backendFinds the order and returns {"reply": "..."}
5Reply sentWithin 20 seconds, and visible in the app's chat

Quais mensagens devem disparar a consulta?

Perguntas sobre pedidos são fáceis de reconhecer pelas palavras usadas, então uma automação por palavra-chave é a escolha certa. Comece por Send to my system e troque o gatilho para Has keyword com Contains, ou comece por Keyword reply e troque a etapa por Call my webhook. Adicione as palavras de cada idioma em que você vende, até 30. As demais perguntas seguem para as outras 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: # captura números de pedido escritos como #1042.

O que o backend da loja recebe e o que precisa devolver?

Um POST em JSON assinado em X-EC-Signature com o Signing secret da automação. Os campos que importam para a 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 pedido. Busque os pedidos mais recentes desse telefone, ou extraia o número do pedido do texto, e responda HTTP 200 com um corpo JSON cujo campo reply contenha o texto a enviar. Mantenha o texto simples e curto: até 4.096 caracteres saem como uma única mensagem, e títulos ou links em markdown aparecem como símbolos brutos.

Request and response of the order lookup
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 o backend deve responder quando não encontra o pedido?

Algo útil em cada caso. Só uma automação responde a cada mensagem, e uma etapa colocada depois do webhook também seria executada após uma resposta bem-sucedida, então os textos alternativos também ficam a cargo do backend (com uma etapa Call an API no lugar, uma etapa Split into paths pode ramificar conforme a resposta):

  • Pedido encontrado: o status, a data prevista e o link de rastreio.
  • Nenhum pedido para este telefone: peça o número do pedido ou o e-mail usado no checkout.
  • Vários pedidos em aberto: liste-os brevemente e pergunte de qual se trata.
  • Encomenda extraviada ou danificada: diga que uma pessoa vai responder neste chat e avise sua equipe.
  • Um teste, com dry_run true: devolva uma resposta de exemplo e não altere nada.
  • Backend fora do ar ou mais lento que 20 segundos: a etapa falha, nada é enviado e você recebe um e-mail para responder por conta própria.

Como enviar atualizações de envio antes que o cliente pergunte?

Atualizações proativas são mensagens que a sua empresa inicia, então saem como templates aprovados, enviados pelo sistema da loja via Cloud API quando um pedido muda de status. Crie-os na categoria de utilidade, a que a Meta usa para confirmações de pedido e avisos de envio; um desconto ou uma sugestão de produto no mesmo template o transforma em marketing. Sua IA pode redigi-los e submetê-los com create_template, usando {{1}} para o nome e {{2}} para o número do pedido, com valores de exemplo, e conferir a aprovação com get_template_status. Depois, a loja chama o endpoint de envio informado por get_api_credentials a partir dos seus próprios eventos de pedido, ou envia uma requisição para a URL de uma automação com o gatilho Your system calls a URL (o exemplo Updates from your system), que envia o template com os dados do pedido vindos de {{vars.webhook.*}}; as páginas de Shopify e WooCommerce mostram essa integração. A Meta cobra as mensagens de template por mensagem, conforme a categoria e o país, na sua própria WhatsApp Business Account.

O que acontece quando o cliente responde a uma atualização de envio?

A resposta abre uma nova janela de atendimento de 24 horas, e suas automações a tratam como qualquer mensagem recebida: uma resposta por palavra-chave, a consulta de pedido ou o assistente de IA. Um detalhe importa. Um cliente cujo chat não tem histórico recente conta como alguém escrevendo pela primeira vez, então uma automação de First message pode cumprimentar quem só está respondendo ao seu aviso de envio; escreva as boas-vindas de modo que também façam sentido depois de uma atualização. Em um número de Coexistência, o template enviado pela loja aparece na conversa do app, então a equipe vê o contexto antes de assumir o atendimento.

Como configurar

  1. 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": "..."}.
  2. 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.
  3. Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's configuration.
  4. 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.
  5. 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 status com outro nome de campo. Só uma string de nível superior chamada reply é enviada; qualquer outra coisa é registrada como sem resposta e o cliente fica sem retorno.
  • Comparar contact.wa_id com os telefones exatamente como foram digitados no checkout. O wa_id tem o código do país e nenhum sinal de mais, espaço ou traço; compare apenas os dígitos.
  • Adicionar uma etapa Reply with text depois do webhook como alternativa. Ela também é executada após uma resposta bem-sucedida, e o cliente recebe duas mensagens; devolva o texto alternativo pelo backend.
  • Colocar um cupom 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.
Fazendo isso com o EasyCoexistence

A etapa Call my webhook leva as perguntas sobre pedidos ao seu backend e devolve a resposta, com assinatura, limite de 20 segundos e e-mail em caso de falha, e get_api_credentials entrega à sua loja o necessário para enviar templates de envio. As automações não têm custo extra. De R$ 29,90 a R$ 3,90 por número por mês, valor que cai conforme você adiciona números, com os primeiros 3 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

Uma etapa de IA pode responder perguntas sobre pedidos no lugar de uma palavra-chave?

Sim. Um agente de IA com uma ferramenta personalizada, uma URL com parâmetros como o número do pedido e cabeçalhos opcionais, pode consultar o pedido por conta própria, ou o modelo pode ficar por trás do webhook, por exemplo um nó AI Agent do n8n com uma ferramenta de consulta de pedidos que devolve o texto como reply. Uma etapa Reply with AI, sozinha, lê apenas as próprias instruções e o chat, então não tem dados de pedido em tempo real.

E se o cliente mandar o pedido em foto ou áudio?

Uma foto chega como [image] seguida da legenda, então a palavra-chave só é reconhecida quando a legenda contém a palavra, embora um agente de IA possa olhar a imagem usando a sua chave. Um áudio é transcrito com a sua chave da OpenAI ou do OpenRouter e armazenado como [voice message] seguido das palavras, que uma palavra-chave pode reconhecer; sem uma chave dessas, continua sendo [voice message]. Faça a IA ou uma resposta fixa pedir o número do pedido por texto.

A automação pode enviar a nota fiscal ou uma etiqueta de envio em PDF?

Sim, pelo seu backend: envie o documento pela Cloud API com as credenciais do número, em até 24 horas após a última mensagem do cliente, e devolva uma resposta curta dizendo que o arquivo está a caminho. A resposta do webhook em si carrega apenas texto. Um arquivo fixo, como uma lista de preços, pode ser enviado pela etapa Send a picture or file.

Quantas consultas de pedido ela consegue atender ao mesmo tempo?

As execuções são independentes, então vários clientes podem perguntar no mesmo instante. O easyCoexistence espaça os envios em no máximo 10 por segundo por número, abaixo dos 20 por segundo que a Meta define para Coexistência, e seu backend só precisa responder a um POST em até 20 segundos.

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átis

Verificado em