Como conectar seu Assistente com sistemas externos (APIs) usando Webhooks?
Nível Avançado. Conecte a Vambe com seu software. Aprenda a configurar Webhooks para que sua IA consulte estoque, status de pedido ou envie dados para seu ERP em tempo real.
Como conectar seu Assistente com sistemas externos (APIs) usando Webhooks?
A função Chamada de Webhook é a ferramenta que permite que sua Inteligência Artificial "converse" com outros sistemas fora da Vambe.
Para que serve? Permite enviar ou buscar dados.
Consultar dados (GET): A IA pode ir ao seu sistema, perguntar "Onde está o pedido 123?" e responder ao cliente "Seu pedido foi entregue ontem".
Enviar dados (POST): A IA pode pegar os dados do chat e enviá-los para seu banco de dados ou CRM externo.
⚠️ Requisito: Conhecimento Técnico
Esta função exige manipular conceitos de programação como APIs, Endpoints, JSON e Métodos HTTP (GET, POST, etc.). Se você não lida com esses termos, recomendamos pedir ajuda à sua equipe de desenvolvimento.
Configuração Passo a Passo: Exemplo "Status do Pedido"
Neste exemplo, configuraremos a IA para que, quando um cliente perguntar sobre sua compra, a IA consulte uma API externa e forneça a resposta.
Passo 1: Instrução no Assistente
Vá ao seu Assistente e entre em Casos Possíveis (ideal para perguntas que podem surgir a qualquer momento).
Defina a lógica no texto: "Quando o cliente precisar saber o status do seu pedido, peça o número de rastreamento; assim que ele te entregar, execute a função webhook".
Passo 2: Configuração Básica do Webhook
Clique em + Adicionar Função e selecione Chamada de Webhook.
Configure os dados base:
Nome: Ex: "Status do Pedido".
Descrição (Vital): Diga à IA quando usá-la. Ex: "Quando o cliente perguntar o status do seu pedido e você já souber o número do pedido".
Método: Selecione o verbo HTTP (GET, POST, PUT, DELETE). Para consultar dados, usaremos GET.
URL (Endpoint): Cole o endereço da sua API.
Passo 3: Configuração de Parâmetros e Variáveis
É aqui que você conecta os dados. Você tem abas para Body, Headers, Params e Route.
A. Autenticação (Headers): Se sua API exigir uma chave (Token), adicione-a em Headers.
Importante: Se o token for fixo, DESATIVE o interruptor de "Use AI". Isso diz ao sistema que é um valor estático e a IA não deve tentar inventá-lo ou procurá-lo no chat.
B. Variáveis Dinâmicas (A mágica da IA): Se você precisar inserir um dado que o cliente informou no chat (como o order_id) dentro da URL, use chaves duplas: {{order_id}}.
Ao fazer isso, uma aba de Route (ou Params/Body, conforme o caso) será criada automaticamente.
ATIVE o interruptor "Use AI": Isso permite que a IA procure esse número na conversa.
Descrição do parâmetro: Escreva o que ele é (Ex: "O número do pedido").
Assim fica uma configuração correta com variáveis dinâmicas: Observe como o campo order_id tem o switch de IA ativado (azul), permitindo que o assistente extraia esse dado do chat.
Passo 4: Verificação Visual (Como deve ficar?)
Antes de testar, confirme que a função foi vinculada corretamente ao passo.
Revise a estrutura: você deve ver o texto da sua instrução e, logo abaixo, um cartão branco que diz "🔗 Chamada de Webhook" (ou o nome que você deu, como "Informação do Pedido").
Se você vê o texto mas NÃO vê o cartão abaixo, a IA lerá a instrução, mas não poderá executar nada. Certifique-se de clicar em "Criar"!
💡 Outra Alternativa: Webhooks em Workflows
Está procurando disparar um Webhook quando ocorre um evento (ex.: entra um cliente novo, muda de etapa ou é etiquetado) e não necessariamente em uma conversa?
Para esses casos de automação pura, não use as funções do Assistente. Você deve usar os Workflows.
Atualizado
Isto foi útil?