🛒 Documentação Avançada Completa — Complemento de Notificações de Webhook para E-commerce (Chat-Bot)

Integração oficial com WhatsApp via API Meta Business — Automação Corporativa de Alto Nível

O complemento Notificações de Webhook para E-commerce do Chat-Bot é um módulo avançado que conecta, em tempo real, sua plataforma de e-commerce ao ambiente de automação do WhatsApp. Ele permite que eventos ocorridos em sua loja virtual (pedidos, atualizações, pagamentos, envios etc.) se transformem automaticamente em mensagens enviadas por meio de Modelos Oficiais do WhatsApp, utilizando a infraestrutura de provedor oficial da Meta Business.

Este documento apresenta uma visão 360°, abordando desde conceitos essenciais até arquitetura, fluxo de dados, configurações detalhadas, segurança, melhores práticas, monitoramento e cenários completos de uso.

📚 1. Visão Geral do Recurso

O complemento cria uma ponte direta entre o seu e-commerce e o Chat-Bot, por meio de webhooks, garantindo que:

• ✔ Eventos críticos sejam capturados instantaneamente

• ✔ O Chat-Bot processe os dados recebidos

• ✔ Mensagens automáticas sejam disparadas para o cliente

• ✔ As notificações sejam 100% confiáveis e em conformidade com o WhatsApp Business API

Esse fluxo elimina a necessidade de sincronizações manuais, reduz erros e acelera o suporte pós-venda — transformando o WhatsApp no principal canal de relacionamento automatizado do seu negócio.

🔌 2. O que é um Webhook no Contexto do Chat-Bot

Um webhook é um gatilho de notificação emitido pelo seu e-commerce sempre que um evento ocorre.

No Chat-Bot, um webhook funciona como:

🧠 Um capturador automático de eventos
📢 Um disparador de mensagens validadas
⚙️ Um iniciador de automações de atendimento e pós-venda

Ele opera de forma reativa e instantânea:
👉 o e-commerce envia → o Chat-Bot recebe → o Chat-Bot processa → o WhatsApp entrega.

🧩 3. Arquitetura Técnica — Como Tudo Funciona

E-commerce → Webhook → Endpoint Chat-Bot → Processamento → Motor de Templates → WhatsApp API → Cliente

📌 Etapas detalhadas do fluxo:

1. O evento acontece no e-commerce
   (pedido criado, atualizado, pago, enviado, cancelado…)

2. O e-commerce dispara o webhook

   • O payload enviado contém dados do evento

   • O formato é JSON

3. O Chat-Bot recebe o webhook no endpoint dedicado

   • Valida a chave secreta (opcional, mas recomendada)

   • Processa e extrai as variáveis

4. O Chat-Bot identifica o Template do WhatsApp configurado

   • Preenche automaticamente as variáveis do template

5. O Chat-Bot envia a mensagem via API oficial da Meta

   • Garante entregas seguras

   • Taxas de sucesso monitoradas

6. O cliente recebe no WhatsApp em segundos

⚙️ 4. Painel do Complemento — Webhooks de E-commerce (Chat-Bot)

A interface do painel foi projetada para administrações profissionais, oferecendo:

📈 Visão Geral de Métricas

• Total de webhooks criados

• Limite e cota restante

• Webhooks ativos / inativos

• Taxa global de sucesso

• Total de mensagens disparadas

• Falhas recentes em destaque

🧭 Navegação facilitada

Menu → Complementos → Notificações Webhook E-commerce

🆕 5. Criando um Novo Webhook

▶ Etapa 1 — Acessar o formulário

Clique em + Criar Webhook

▶ Etapa 2 — Preencher configurações avançadas

🔐 Recomendação de segurança

Utilize chaves com formatação semelhante:

wc_sec_t8d8jk33lss92ks9js8ssll28q

🔗 6. Endpoint Gerado

Cada webhook criado gera um endpoint único:

https://seudominio/api/webhooks/[webhook_id]

Esse endpoint deverá ser configurado dentro do seu e-commerce.

🧪 7. Testes e Depuração

O Chat-Bot oferece uma ferramenta avançada de testes:

Ferramentas disponíveis:

• 📋 Visualizador de Payload JSON

• 🔄 Botão Sincronizar (escuta ativa)

• 🗑️ Exclusão de dados de teste

• 🧭 Console de logs por evento

• 🛠️ Simulador de requisições

Procedimento recomendado:

1. Clicar em Sincronizar

2. Disparar evento real no e-commerce

3. Validar se:

   • Payload chegou

   • Estrutura está correta

   • Variáveis foram identificadas

🛍️ 8. Integração com WooCommerce (Exemplo Oficial)

Caminho:

WooCommerce → Configurações → Avançado → Webhooks

Campos principais:

• Nome

• Status

• Tópico (Pedido Criado, Pedido Atualizado etc.)

• URL de Entrega (Endpoint Chat-Bot)

Observação importante:

Ao ativar o webhook pela primeira vez, o WooCommerce enviará um ping inicial.

📦 9. Principais Eventos do E-commerce Suportados

Plataformas compatíveis (exemplos):

• WooCommerce

• Shopify

• NuvemShop (via App Privado)

• Magento / Adobe Commerce

• Sistemas próprios (via webhook HTTP)

Eventos recomendados para automação:

📬 10. Disparo de Modelo Oficial do WhatsApp

Após o recebimento do webhook, o Chat-Bot:

1. Identifica qual modelo está associado ao evento

2. Preenche variáveis automaticamente

3. Envia a mensagem ao cliente

Exemplos de variáveis preenchidas:

• {{nome_cliente}}

• {{numero_pedido}}

• {{data_pedido}}

• {{valor}}

• {{codigo_rastreio}}

🛡️ 11. Segurança e Boas Práticas

Medidas recomendadas:

✔ Ativar chave secreta nos webhooks
✔ Trabalhar sempre com HTTPS
✔ Validar IPs da origem quando possível
✔ Monitorar falhas de entrega
✔ Evitar payloads excessivamente grandes
✔ Rotacionar chaves em intervalos regulares

📊 12. Monitoramento e Logs

Todos os envios são registrados no:

📁 Registro de Atividades

Incluindo:

• Data e hora

• Webhook acionado

• Payload capturado

• Template enviado

• Status do envio

• Código da API Meta (200, 400 etc.)

💡 13. Casos de Uso Avançados

🛒 Carrinho Abandonado

WooCommerce → webhook customizado → Chat-Bot → disparo automático após X minutos

📦 Atualização de Rastreamento

E-commerce → webhook → Chat-Bot → mensagem com link de rastreio

🤝 Pós-venda Automático

Pedido concluído → WhatsApp → solicitação de avaliação

🔁 Recompra automática

Pedido entregue → gatilho → sugestão de produtos complementares

🧭 14. Checklist de Implementação

• Criar webhook no Chat-Bot

• Copiar endpoint

• Configurar webhook no e-commerce

• Definir modelos no Chat-Bot

• Testar payloads

• Monitorar via Registro de Atividades

• Ativar automações avançadas (opcional)

🎯 15. Benefícios Diretos