🌐 Integração Bidirecional 2-Way

Manual Completo do Nó HTTP & Webhooks

Aprenda a conectar o Flow Builder do Smartchat a qualquer sistema externo, gateway de pagamento, CRM ou plataforma de automação em tempo real.

⚡ 1. O que é o Nó HTTP Request no Flow Builder?

O nó de Requisição HTTP (disponível na categoria Integrações do editor visual) permite que seu fluxo consulte ou envie dados para qualquer API web externa no exato momento em que o lead passa por aquele passo da automação.

📤 Envio Outbound (Push)

Notifique seu CRM externo, crie um pedido de venda no seu ERP ou acione um webhook no N8N/Make com os dados capturados na conversa.

📥 Consulta Inbound (Pull & Mapping)

Consulte o código PIX de uma fatura, verifique o status do pedido pelo CPF ou receba o código de rastreio dos correios e salve no lead.

📦 2. Estrutura do Payload JSON Enviado (Body Sent)

Nas requisições POST e PUT, o Smartchat injeta automaticamente os dados completos do contato no corpo da requisição JSON:

                // Estrutura JSON enviada para o seu endpoint externo:

                {

                  "lead_id": "lead_9823a10f",

                  "name": "Maria Silva",

                  "username": "mariasilva",

                  "channel": "instagram",

                  "email": "maria@email.com",

                  "phone": "+5511999998888",

                  "cpf": "123.456.789-00",

                  "tags": ["Interessado", "VIP"],

                  "custom_fields": {

                    "produto_interesse": "Curso Avançado v2.0"

                  }

                }

🔄 3. Mapeamento de Resposta JSON & Roteamento 2-Way

Grave qualquer valor da resposta da API externa diretamente em campos do lead e direcione o fluxo dinamicamente:

🟢 Saída de Sucesso (HTTP 2xx)

Quando a API externa responde com status 200 ou 201, o mapeamento JSON grava as variáveis escolhidas e o fluxo segue pela ramificação verde de Sucesso (ex: enviar DM com o código PIX).

✔ Exemplo: Mapear `data.pix_copia_cola` -> Campo do Lead `{pix_code}`

🔴 Saída de Erro (HTTP 4xx / 5xx / Timeout)

Se o servidor externo estiver fora do ar ou retornar um erro (ex: CPF inválido), o fluxo não trava! Ele segue pela ramificação vermelha de Erro (ex: avisar o cliente ou direcionar para o atendimento humano).

✖ Exemplo: API indisponível -> Nó de mensagem fallback: "Desculpe, tente novamente em alguns instantes."

💡 4. Possibilidades de Uso & Integrações Práticas

Veja como empresas usam o nó HTTP Request no dia a dia para automatizar processos de ponta a ponta:

💳

Gateways de Pagamento

Conecte Asaas, Mercado Pago, Hotmart ou Kiwify para gerar cobranças PIX/Boleto em tempo real durante a conversa de atendimento.

⚡

Plataformas de Automação

Dispare webhooks para N8N, Make (Integromat), Zapier ou Pipedream e conecte seu bot a mais de 5.000 aplicativos de mercado.

📊

CRMs Externa & Email

Sincronize novos contatos imediatamente no ActiveCampaign, RD Station, HubSpot ou Salesforce no exato momento da captura.

🔍

Validação de Dados

Consulte APIs públicas ou privadas para validar se o CPF do cliente é válido, consultar o endereço via CEP ou verificar a disponibilidade do produto em estoque.

🚚

Rastreio de Pedidos

Permita que o cliente digite o número do pedido e o robô consulte o status de entrega nos Correios ou na transportadora automaticamente.

🤖

APIs Customizadas de IA

Envie o histórico de mensagens para microserviços em Python ou endpoints de IA proprietários e receba análises ou recomendações sob medida.