Desenvolvedores e Webhooks

Conecte a Inteligência Artificial da Substrata ao seu sistema próprio, ERP ou ferramenta de automação (Make, n8n, Zapier) através de Webhooks Dinâmicos.

Como funciona o Webhook Dinâmico?

Diferente de integrações tradicionais, a Substrata não exige que você construa endpoints específicos para cada ação. Nós enviamos um Payload estruturado para uma única URL sempre que a Inteligência Artificial precisar consultar o seu sistema.

Você configura no Painel da Substrata QUANDO a IA deve chamar o seu Webhook através de "Instruções em Texto Livre" (ex: "Se o cliente perguntar o preço de um serviço específico, consulte o webhook informando o nome do serviço no payload").

1. O que nós enviamos (Requisição HTTP POST)

Quando a IA toma a decisão de consultar seu sistema, faremos um POST para a URL que você configurou no painel, contendo o seguinte Payload em formato JSON:

{ "intent": "verificar_servico", "company_id": "8d71a781-00c5-457f-9c7b-faa2c09771f9", "customer_phone": "5551999999999", "payload": { "servico": "Limpeza de Pele", "unidade": "Centro" } }
  • intent: A intenção da IA (definida pelo nosso motor com base no contexto da conversa).
  • company_id: ID UUID da sua empresa no nosso banco de dados.
  • customer_phone: O número de WhatsApp do cliente que está conversando com a IA.
  • payload: Um objeto JSON flexível com as variáveis chave que a IA coletou na conversa.

2. O que você deve responder

Sua API ou fluxo de automação deve processar os dados e nos retornar um JSON válido com a resposta. A IA vai ler as chaves dessa resposta e usar a criatividade natural para traduzir a informação para o cliente, sem parecer um robô.

{ "status": "disponivel", "preco": "R$ 150,00", "proximo_horario": "Amanhã às 14:00" }

Dica para Automações (n8n, Make)

Você pode usar plataformas No-Code para receber o nosso Webhook, buscar a informação em uma planilha do Google Sheets, Airtable ou CRM local, e retornar a resposta usando um nó de "Webhook Response". É a forma mais ágil de integrar regras complexas sem escrever código nativo.

Segurança e Autenticação (Opcional)

Se a sua API exige autenticação para proteger os dados, você pode fornecer um Token no Painel da Substrata. Nós enviaremos esse token no header de todas as requisições que fizermos para o seu servidor:

Authorization: Bearer SEU_TOKEN