Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

Confirmações de encomenda e atualizações de envio no WhatsApp, automáticas

As confirmações automáticas de encomenda são templates utilitários aprovados que o sistema da loja envia pela Cloud API da Meta quando acontece um evento de encomenda: feita, enviada, em entrega, entregue. Cada template indica a encomenda concreta e não contém qualquer oferta, como exige a categoria utilitária da Meta. A resposta de um cliente abre uma janela de 24 horas em que podem seguir respostas automáticas.

O easyCoexistence liga o número WhatsApp Business que a sua loja já usa na app à Cloud API da Meta através da Coexistência e entrega à loja as suas credenciais, no painel ou através de get_api_credentials, para que as confirmações e as atualizações de envio saiam do número que os clientes conhecem e apareçam no chat da app.

Utility

Categoria da Meta para mensagens que confirmam, atualizam ou cancelam uma encomenda com detalhes específicos, sem promover nem vender mais.

Mixed content

A Meta classifica como template de marketing uma atualização de encomenda que inclua também uma promoção.

30 days

Tempo de vida predefinido de um template utilitário; em alternativa, pode ser definido de 30 segundos a 12 horas.

250

Pessoas únicas a quem um novo portefólio empresarial pode enviar mensagens fora de uma janela de atendimento ao cliente, em 24 horas móveis.

20 msg/s

Throughput fixo de um número usado ao mesmo tempo na app WhatsApp Business e na Cloud API.

Mirrored

As mensagens enviadas pela Cloud API num número Coexistence também aparecem na app WhatsApp Business.

Que mensagens de encomenda podem sair automaticamente?

Cada momento da vida de uma encomenda pode ter o seu próprio template aprovado, enviado pelo sistema da loja quando esse momento acontece. As diretrizes utilitárias da Meta listam exatamente estas funções: confirmar uma encomenda, partilhar um número de rastreio e uma data de entrega, avisar sobre um artigo sem stock e confirmar um reembolso. Mantenha um template por evento, para que cada um diga uma só coisa e possa ser reformulado sem tocar nos outros. Uma loja que envia no mesmo dia pode precisar de apenas três deles.

order_confirmedOrder placed: the order number and what happens next
order_shippedFulfilled: the carrier, the tracking number and the expected date
out_for_deliveryOn the way today: short-lived, so give it a short time-to-live
order_deliveredDelivered: how to report a problem with the order
order_delayedBackordered or late: the new estimate and the option to cancel
refund_processedReturn received: the amount refunded and the order number

Como é um template utilitário de encomenda?

Um corpo curto que indica o nome do cliente e a encomenda, com variáveis posicionais e valores de exemplo, e um botão opcional. O exemplo abaixo é o que uma IA submete através de create_template ao pedido «criar um template utilitário para encomendas enviadas com um botão de rastreio». O botão de rastreio tem uma variável no fim do seu URL, preenchida por encomenda no momento do envio. Escreva texto depois da última variável, porque a Meta rejeita um corpo que termine com uma variável, e deixe de fora descontos, sugestões de produtos e pedidos de avaliação: qualquer um deles passa o template para marketing.

create_template arguments for a shipping update
{
  "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 é que a loja envia cada atualização?

Através da Cloud API da Meta, a partir do sistema da própria loja, com as credenciais do número. No painel do easyCoexistence, o cartão «Plug in your own system» do número mostra o «Send endpoint» e o botão «Reveal access token»; a sua IA devolve os mesmos valores com get_api_credentials. A loja, ou um fluxo de trabalho no n8n, Make ou Zapier que escute os eventos de encomenda, envia um pedido por cliente e preenche as variáveis a partir do registo da encomenda. A variável do botão de rastreio vai num componente de botão separado, como neste pedido. Sem código Graph, uma automatização com o gatilho «Your system calls a URL» faz o envio: a loja envia {"to": "+5511987654321", "name": "Ana", "order": "1042"} para o URL mostrado no editor, com o segredo da automatização como Bearer token, e um passo «Send a template» preenche o template a partir de {{vars.webhook.name}} e {{vars.webhook.order}}.

The store's send request when an order ships
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" }] }
    ]
  }
}

Em vez disso, a sua IA pode enviar uma atualização de encomenda?

Sim, para as atualizações que uma pessoa decide. Com o conector do easyCoexistence no ChatGPT ou no Claude, «diz à Ana no 5511987654321 que a encomenda 1042 está atrasada até segunda-feira, com o template order_delayed» transforma-se numa única chamada send_template para um só destinatário, e o ChatGPT pode pedir-lhe que confirme antes de a executar. Isto serve para uma encomenda atrasada, uma encomenda feita manualmente ou um teste de um template novo. As atualizações de rotina pertencem ao sistema da loja, porque um assistente só age enquanto alguém está a conversar com ele. Essas saem do sistema da loja, ou através de uma automatização que o seu sistema inicia ao chamar o respetivo URL, que pode enviar um template aprovado a um cliente que não acabou de escrever para o número.

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

A resposta chega à app WhatsApp Business, junto do template que a loja enviou, e abre uma janela de 24 horas em que pode seguir qualquer texto. Num número cujas mensagens passam pelo easyCoexistence, pode também iniciar uma automatização. Uma automatização «Has keyword» pode captar as dúvidas sobre encomendas e entregá-las ao seu backend com «Call my webhook», que é a configuração descrita na página de estado da encomenda. Um botão de resposta rápida no template, como «Alterar morada», chega como mensagem com o texto do botão, por isso uma automatização com «Is exactly» pode responder a esse toque. Um detalhe: um cliente sem histórico de conversa recente conta como quem escreve pela primeira vez, por isso formule a saudação de «First message» de modo a ficar bem depois de uma atualização de encomenda; um cliente cuja atualização saiu por uma automatização iniciada pelo seu sistema já tem uma conversa do nosso lado, por isso a resposta dele não é uma primeira mensagem.

Como sabe que uma atualização chegou ao cliente?

A Meta comunica o estado enviada, entregue, lida ou falhada das mensagens de saída do número no seu webhook. Com o número definido como «Through easyCoexistence» e um Forward URL, chegam ao seu sistema assinados por número, dentro do payload original da Meta; com «Send straight to my system», a Meta envia-os para o seu endpoint. Marque uma atualização como entregue só depois de chegar o estado de entregue, porque um pedido aceite não é uma entrega. O tempo de vida importa nas atualizações com prazo: por predefinição, a Meta continua a tentar um template utilitário durante 30 dias, por isso defina algumas horas para out_for_delivery, e a Meta descarta a mensagem quando esse tempo passa, em vez de entregar notícias de ontem.

Como configurar

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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% de desconto na próxima encomenda» ao template de envio. A Meta trata o conteúdo misto como marketing, por isso a atualização é aprovada, ou reclassificada mais tarde, como template de marketing e cobrada e limitada como tal.
  • Escolher o template de rastreio no passo «Send a template» de uma automatização. Um botão de URL com variável ainda não pode ser preenchido pelas automatizações; envie-o a partir do sistema da loja.
  • Deixar out_for_delivery com o tempo de vida predefinido de 30 dias. Um telemóvel que volta a ter rede dois dias depois ainda recebe «chega hoje»; defina algumas horas.
  • Tratar o ID da mensagem na resposta da Meta como prova de entrega. Os envios aceites ainda podem falhar; espere pelo estado de entregue antes de marcar a atualização como enviada.
Fazer isto com a EasyCoexistence

As automatizações respondem às respostas, e cada número é monitorizado 24 horas por dia, 7 dias por semana, com um email quando a Meta deixa de entregar os seus templates. De US$ 9 até US$ 0.75 por número por mês, descendo à medida que acrescenta números, com os primeiros 3 dias grátis.

Perguntas frequentes

Preciso de opt-in para enviar confirmações de encomenda no WhatsApp?

Sim. A política da Meta cobre qualquer mensagem iniciada pela empresa: o cliente deu-lhe o número e concordou em receber mensagens da sua empresa. Desde novembro de 2024 essa autorização pode ser geral e não específica do WhatsApp, desde que identifique a empresa e cumpra a lei local, por isso uma linha clara na finalização da compra funciona.

A Meta cobra pelas confirmações de encomenda?

A Meta cobra as mensagens de template por mensagem, consoante a categoria e o país do cliente, à sua própria Conta WhatsApp Business; a página de preços da Meta indica as regras atuais para os seus mercados. O easyCoexistence não acrescenta margem nem taxa por mensagem, e as automatizações não têm custo extra.

A confirmação pode levar a fatura em PDF?

Sim, a partir do sistema da loja: um template com cabeçalho de documento recebe a ligação do PDF no momento do envio. As automatizações não conseguem enviar um template com multimédia no cabeçalho. O passo «Send a picture or file» envia um PDF que carregou, o mesmo para todos, por isso uma fatura por encomenda sai da loja ou através da chamada send_template da sua IA.

E se o número de telemóvel do cliente não estiver no WhatsApp?

A Meta aceita o pedido e depois comunica um estado de falhada, normalmente o erro 131026 para uma mensagem não entregável. Configure o sistema para vigiar os estados falhados e envie a atualização desse cliente por email ou SMS, para que ninguém perca uma confirmação por causa de um erro de digitação na finalização da compra.

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 gratuito

Verificado em