Envie mensagens no WhatsApp a partir de qualquer sistema com um webhook

Para enviar uma mensagem no WhatsApp quando algo acontece em outro sistema, aponte o webhook desse sistema para um receptor que encontre o cliente pelo número de telefone e envie um modelo aprovado do WhatsApp. Sua loja, seu CRM ou sua ferramenta de agendamento já disparam webhooks para pedidos, pagamentos e agendamentos; o trabalho está em escolher quais eventos merecem uma mensagem, escrever os modelos, proteger a URL e testar com requisições reais antes que qualquer cliente veja algo.

Este guia mostra o planejamento, as regras do WhatsApp que o moldam e como montar tudo no MonoChat com um fluxo que começa a partir da sua própria URL de webhook.

O que é um webhook, e o que ele não é

Um webhook é uma requisição HTTP que um sistema envia para uma URL informada por você quando um evento acontece. A Shopify pode enviar uma quando um pedido é criado, o WooCommerce quando um pedido é atualizado, um CRM quando um negócio muda de etapa, uma ferramenta de agendamento quando um horário é marcado. A requisição traz os detalhes do evento, normalmente em JSON: número do pedido, valor, nome do cliente e, o mais importante para o WhatsApp, um número de telefone.

Um webhook não envia nada ao cliente por conta própria. Alguma coisa precisa receber a requisição, decidir o que fazer com ela e chamar a WhatsApp Business API. Essa “alguma coisa” é um código que você escreve e hospeda, ou uma plataforma de automação que fornece uma URL de webhook e permite montar o resto sem código.

Quais eventos merecem uma mensagem no WhatsApp

Nem todo evento vale uma mensagem. Um cliente que recebe cinco notificações sobre o mesmo pedido passa a ignorar todas. Escolha os momentos que ele realmente está esperando:

Evento	Mensagem	Categoria do modelo
Pedido criado ou pago	Confirmação com o número do pedido e o que acontece em seguida	Utilidade
Pagamento recusado ou pendente	Um aviso curto e uma forma de pagar de novo	Utilidade
Pedido enviado	Transportadora e link de rastreio	Utilidade
Pedido com pagamento na entrega criado	Uma pergunta: confirmar o pedido, alterar o endereço ou cancelar	Utilidade
Horário marcado, alterado ou agendado para amanhã	Data, hora, local e uma forma de remarcar	Utilidade
Negócio ganho ou perdido no CRM	Uma passagem para o gerente de contas ou uma pergunta de feedback	Utilidade ou marketing, conforme o texto
Carrinho abandonado	Um lembrete, talvez com uma oferta	Marketing

A Meta define a categoria pelo que o modelo diz, não pelo rótulo que você escolhe. Uma mensagem sobre um pedido, pagamento ou agendamento específico é de utilidade; tudo o que promove, oferece ou tenta persuadir é marketing e exige um consentimento que cubra marketing. Nossos exemplos de modelos de WhatsApp trazem textos para os casos de utilidade acima.

As regras do WhatsApp que se aplicam

A maioria das mensagens de webhook precisa de um modelo

Uma janela de atendimento ao cliente se abre quando o cliente envia uma mensagem ou liga para você, e dura 24 horas a partir da última mensagem dele. Dentro dela, você pode responder livremente; fora dela, só pode enviar modelos de mensagem pré-aprovados. Eventos de loja e de CRM raramente acontecem dentro dessa janela, então planeje cada mensagem de webhook como um modelo e envie os modelos para aprovação antes de ativar qualquer coisa.

O número de telefone precisa ser utilizável

O webhook precisa trazer um número de telefone que o WhatsApp consiga alcançar: em formato internacional, com o código do país. Muitas lojas deixam o cliente digitar o número como quiser, então confira alguns pedidos reais. Um número sem código do país é o motivo mais comum para o teste funcionar e a produção não.

Os preços mudaram em 1º de outubro de 2026

A Meta cobra por mensagem entregue desde 1º de julho de 2025. Desde 1º de outubro de 2026, os modelos de utilidade enviados dentro de uma janela de atendimento ao cliente aberta voltaram a ser cobrados, depois de um período em que eram gratuitos, e cada número de telefone comercial tem 1.000 mensagens de serviço gratuitas por mês. As tarifas dependem da categoria e do país do cliente. Na prática: uma confirmação de pedido tem custo, quer o cliente tenha escrito para você recentemente ou não, então envie as mensagens que importam e deixe de lado as que não importam. O guia de preços da API do WhatsApp explica a tabela de tarifas.

Proteja a URL do webhook

Qualquer pessoa que conheça a URL de um webhook pode chamá-la. Se essa URL envia mensagens no WhatsApp, uma URL vazada significa que outra pessoa pode mandar mensagens aos seus clientes em seu nome ou aumentar a sua conta. Três hábitos evitam isso:

• Exija um segredo. O sistema de origem coloca o segredo em um cabeçalho ou assina o corpo da requisição com ele (HMAC-SHA256), para que o receptor confira que a requisição não foi alterada no caminho. Requisições sem um segredo ou assinatura válidos são rejeitadas.
• Use uma URL para cada finalidade. Um fluxo de pedidos e um fluxo de agendamentos devem ter URLs e segredos diferentes, para que você possa trocar um sem mexer no outro.
• Fique de olho nas falhas do lado de quem envia. O WooCommerce desativa um webhook depois de mais de cinco falhas de entrega consecutivas, e a Shopify exclui uma assinatura de webhook cujo destino retorna repetidamente uma resposta diferente de 200. Um receptor desligado ou mal configurado pode interromper suas notificações sem nenhum aviso.

Onde criar o webhook na Shopify e no WooCommerce

• Shopify: Settings › Notifications › Webhooks e depois Create webhook. Escolha um evento (Order creation, Order payment, Fulfillment creation e muitos outros), JSON como formato e uma URL https://. O evento não pode ser alterado depois que o webhook é criado, então crie um webhook por evento. O botão Send test confirma que ele chega à URL.
• WooCommerce: WooCommerce › Settings › Advanced › Webhooks e depois Add webhook. Escolha um tópico (eventos de pedido, cliente, cupom ou produto), informe a URL de entrega e um segredo; o WooCommerce adiciona aos cabeçalhos da requisição um hash do payload gerado com esse segredo.
• Um CRM ou uma ferramenta de agendamento: procure por “webhooks”, “automações” ou “integrações de saída”. Se ela oferecer apenas um formato fixo, confira qual campo traz o telefone do cliente antes de montar qualquer coisa.

Teste com requisições reais antes de colocar no ar

Os payloads de webhook são longos e cada plataforma nomeia os campos de um jeito: o telefone pode estar em phone, billing.phone ou customer.default_address.phone. Não chute. Envie uma requisição de teste real, veja o que chegou e mapeie os campos a partir disso. Depois teste os casos extremos:

• um pedido sem número de telefone, ou com um número sem o código do país;
• o mesmo evento entregue duas vezes, o que as plataformas fazem quando tentam de novo;
• um pedido feito às 3 da manhã, se você prefere que a mensagem espere até de manhã;
• um cliente que responde à notificação, para que uma pessoa ou um assistente de IA esteja pronto para atender.

Como fazer isso no MonoChat

O MonoChat é Meta Business Partner oficial. Desde a versão 3.8.37 (outubro de 2026), um fluxo pode começar a partir de um webhook, então sua loja ou seu CRM podem disparar mensagens no WhatsApp sem código do seu lado.

1. Comece o fluxo com um nó Webhook recebido. Adicione-o a partir dos nós de evento. Ele ganha a própria URL de webhook e o próprio segredo. Escolha o canal, por exemplo o seu número de WhatsApp, e o Caminho da identidade, que indica onde está o telefone do cliente na requisição (request.body.phone por padrão). O MonoChat encontra o cliente nesse canal, ou o cria, e executa o fluxo para ele. O nó responde ao remetente com 202 quando o fluxo entra na fila, e com um erro claro quando o canal ou o número de telefone não é encontrado.

2. Ative Exigir segredo. O remetente pode colocar o segredo no cabeçalho de token (Authorization por padrão, sozinho ou como Bearer <secret>) ou enviar uma assinatura HMAC-SHA256 do corpo bruto no cabeçalho de assinatura (X-Signature por padrão). Os dois nomes de cabeçalho podem ser alterados para combinar com o sistema de origem.

3. Capture uma requisição real. Adicione /test ao final da URL do webhook e aponte o webhook de teste da sua loja para ela. Enquanto as configurações do nó estão abertas, a requisição aparece em Solicitação recebida com corpo, query e cabeçalhos, sem iniciar o fluxo. Use-a para encontrar os caminhos de que você precisa e salve-os como variáveis do fluxo, por exemplo request.body.orderId como orderId.

4. Envie a mensagem. Adicione um nó Enviar mensagem de modelo com o seu modelo aprovado e preencha as variáveis com as variáveis do fluxo: número do pedido, valor, link de rastreio. Use condições para enviar modelos diferentes para status diferentes.

5. Faça uma chamada de volta, se precisar. Um nó Solicitação HTTP pode buscar mais dados no seu próprio sistema ou gravar a resposta do cliente nele, por exemplo “confirmado” em um pedido com pagamento na entrega. Ele segue por Saída quando a chamada dá certo e por Em caso de falha quando não dá, para que você envie uma alternativa ou atribua a conversa a uma pessoa.

Quando o cliente responde, a conversa fica na mesma caixa de entrada do MonoChat que o restante dos seus chats de WhatsApp, Instagram e Messenger, onde a sua equipe ou um assistente de IA pode assumir. Para montar fluxos, veja a automação de fluxos de trabalho.

Há outros dois caminhos, dependendo de quem vai fazer o trabalho:

• Seus desenvolvedores já chamam uma API. O app WhatsApp Template API envia um modelo aprovado com uma única chamada de API, e as respostas chegam à caixa de entrada.
• Você usa a Shopify e quer os dados do pedido no chat. A automação de chat para Shopify sincroniza produtos e pedidos para que a equipe e o assistente de IA respondam a perguntas sobre pedidos.

Para começar, crie uma conta gratuita em app.monochat.ai, conecte seu número de WhatsApp e compare os planos na página de preços.

Fontes

• Meta for Developers: envio de mensagens e a janela de atendimento ao cliente
• Meta for Developers: preços na WhatsApp Business Platform
• Meta for Developers: categorização de modelos
• Central de Ajuda da Shopify: Webhooks
• Documentação do WooCommerce: Webhooks
• Central de ajuda do MonoChat: fluxos e os nós Webhook recebido e Solicitação HTTP