Integrações de Nível 2: Como Usar Webhooks e HTTP API para Sincronizar Zappia com Seu CRM/ERP
Introdução: O Valor da Zappia como Camada de Aquisição de Dados
A Zappia atua como uma Camada de Aquisição de Dados na interface de mensagens. O objetivo não é apenas conversar, mas coletar dados de alta qualidade e garantir que eles sejam imediatamente persistidos em seu sistema de registro (CRM/ERP), evitando a desorganização da comunicação.
As ferramentas de integração de Nível 2—o Webhook e o HTTP API Connector—são vitais para usuários que precisam de fluxo de dados em tempo quase real para processos críticos, como pontuação instantânea de leads ou atualizações de inventário.
A funcionalidade Incoming Message to Webhook URL e a Integration – HTTP API são liberadas a partir do Plano Intermediário.
Pilar 1: O Fluxo de Saída de Dados com Webhook + Zapier
O Webhook é o mecanismo que permite que a Zappia envie dados em tempo real para aplicativos externos sempre que um evento específico ocorre (ex: um usuário preenchendo um formulário).
- Input Flow como Gatilho: O processo começa com o usuário preenchendo o Fluxo de Entrada (Input Flow) do chatbot. As respostas são salvas em Campos Personalizados.
- Conexão Zapier: A integração com o Zapier (via webhook) permite conectar a Zappia a mais de 5.000 aplicativos sem código.
- Configuração do Webhook:
- No Zapier, você cria um Zap, escolhe “Webhook by Zapier” como o gatilho, e copia a URL do webhook.
- Na Zappia, você navega para Fluxos de Trabalho de Webhook e cola a URL do Zapier.
- Você mapeia os campos do seu Input Flow (ex: e-mail, telefone) para que os dados sejam enviados no payload do webhook.
- Exemplo Prático: Os dados coletados de um lead no WhatsApp podem ser enviados automaticamente via webhook para o Zapier, que por sua vez adiciona esse lead diretamente ao seu CRM (HubSpot, Brevo) ou a uma planilha do Google Sheets.
Pilar 2: Sincronização de Dados Transacionais com HTTP API Connector
O bloco HTTP API (também chamado de JSON API Connector) é usado para buscar dados de sistemas externos (CRM, ERP, inventário) e usá-los dentro da conversa, ou para enviar dados de volta.
- Métodos Suportados: Suporta métodos GET (para buscar dados), POST, PUT e DELETE.
- Mapeamento de Resposta Crítico: Ao configurar a API (em Integrações $\rightarrow$ HTTP API), você define um Campo Personalizado (ex: #Inventario#) para armazenar a resposta JSON retornada pelo sistema externo.
- Integração no Flow: O bloco HTTP API é inserido no Flow Builder. Uma vez executado, o Custom Field é preenchido com os dados.
- Exibição Dinâmica (Caso de Uso Avançado): Os dados JSON complexos podem ser exibidos em formato estruturado (lista) no WhatsApp usando o bloco Interactive Message com o método Dynamic Row Generation. Por exemplo, você mapeia a chave JSON product_name para o Título da Linha e combina price e description para a Descrição da Linha.
Pilar 3: Webhook Workflow (O Gatilho Externo)
O Webhook Workflow é o inverso: ele permite que um evento externo acione uma automação dentro da Zappia.
- Função: Usado para acionar mensagens de template ou fluxos do WhatsApp a partir de eventos que ocorrem em outro lugar, como o envio de um formulário em seu site (ex: Elementor, WPForms).
- Webhooks de E-commerce (Nível 2): Este método é a abordagem de Nível 2 para automações de e-commerce, como a Notificação de Pedido do Shopify. O usuário configura um Webhook de Order Creation no admin do Shopify e mapeia o payload (dados) no Webhook Workflow da Zappia para personalizar a notificação.
- Verificação COD: O fluxo de Verificação de Pedido Cash-On-Delivery (COD) do WooCommerce é acionado por um Webhook Order Created, mostrando como o Workflow permite a automação transacional.
Pilar 4: Integração Google Sheets Nativa
A Zappia oferece uma integração nativa e simples com o Google Sheets.
- Processo: Você conecta sua Conta Google e, dentro de um Fluxo de Entrada de Dados, habilita a opção de integração com o Google Sheets, fornecendo a URL da sua planilha.
- Vantagem: Os dados coletados serão adicionados automaticamente como uma nova linha, facilitando a gestão de contatos e o funil de vendas para PMEs que usam planilhas como seu CRM principal.
Conclusão: As integrações de Nível 2 da Zappia garantem que o dado de alta qualidade coletado no chat não fique isolado. Com Webhooks e HTTP API, você automatiza processos complexos, sincroniza com seu CRM/ERP e transforma a Zappia no hub de comunicação do seu negócio.




PorEdu Gazzinelli