Como usar webhook para enviar mensagens de atualização via WhatsApp

Objetivo

 este artigo mostra como receber atualizações de pedido via webhook e usá-las para enviar mensagens automáticas no WhatsApp, incluindo links de rastreio e pesquisa (CSAT) com identificador de canal para métricas.

Para quem é

• Times técnicos e de operações da marca que vão integrar o webhook e disparar mensagens.
• Parceiros que operam a mensageria em nome da marca.

Pré-requisitos

• Ter um endpoint (URL) para receber o webhook. Observação: não precisa ser público; se for restrito, conseguimos cadastrar headers/autenticação para acesso.
• Ter um provedor que seja responsável pelos disparos das mensagens via WhatsApp.

1) Como funciona

Quando o pedido muda de status, enviamos via webhook as informações sobre os pedidos, como nome do cliente, telefone, status, transportadora e código de rastreio. Usualmente usamos Criado, Em rota e Sucesso, mas a marca pode definir os seus e personalizar os templates.

2) Links de rastreio e de pesquisa (CSAT)

Os links são fixos; muda só a parte final com o código de rastreio do pedido, que vem no webhook.

Exemplos:

Rastreio:

https://meupedido.abbiamolog.com/DN05URUD87ZH

Pesquisa (CSAT):

https://csat.abbiamolog.com/DN05URUD87ZH

Para montar, concatene a parte fixa + o código de rastreio.

3) Identificador do canal para métricas

Inclua um parâmetro no final dos links para sabermos por onde a mensagem foi enviada. Assim conseguimos medir a efetividade por canal.

Formatos:

Rastreio com canal:

https://meupedido.abbiamolog.com/DN05URUD87ZH?s=EXEMPLO

CSAT com canal:

https://csat.abbiamolog.com/DN05URUD87ZH?as=EXEMPLO

• Parâmetro s no link de rastreio
• Parâmetro as no link do CSAT

Importante: se a mensageria for pela infraestrutura da própria marca, não use apenas as=whatsapp, pois esse identificador já é usado nos envios de WhatsApp operados pela Abbiamo. Prefira algo único, como as=whatsapp_marca.

4) Exemplo de payload do webhook (JSON)

Use o exemplo para mapear os campos no template de mensagem.

{
  "order_id": "123456",
  "client_name": "Maria Silva",
  "phone": "+55 11 91234-5678",
  "status": "em_rota",
  "carrier_name": "Transportadora X",
  "tracking_code": "DN05URUD87ZH",
  "last_update": "2025-11-04T12:34:56Z"
}

Exemplo de montagem dos links no seu sistema:

// Rastreio
const tracking = `https://meupedido.abbiamolog.com/${tracking_code}?s=whatsapp_marca`;

// CSAT
const csat = `https://csat.abbiamolog.com/${tracking_code}?as=whatsapp_marca`;

5) Cadastro do webhook

• Envie para a equipe Abbiamo a URL do webhook (endereço que receberá os dados). Faremos o cadastro do nosso lado; ou
• Cadastre diretamente em Configurações > Webhooks > Novo Webhook.

Após o cadastro, as atualizações começam a ser enviadas conforme o avanço dos pedidos.

6) Pontos de atenção

• Todos os templates de mensagem são criados e geridos dentro do provider responsável pelo disparo das mensagens.
• É muito importante incluir o link de rastreio e a pesquisa de satisfação nas suas comunicações, porque dessa forma o cliente tem a visibilidade completa da entrega e consegue fazer a avaliação ao final. O embarcador tem acesso a todas as avaliações dentro da plataforma.
• É essencial que seja feita a identificação do canal, como citado acima. Através disso, o embarcador consegue fazer o controle de qual é o canal mais efetivo para as avaliações de entrega, por exemplo.

Suporte

Em caso de dúvidas na integração ou cadastro do webhook, acione o nosso time pelo canal habitual.