Ir para a navegação
Integrações

Webhooks

Dê à sua recepcionista ferramentas personalizadas que chamam seus endpoints HTTP.

A integração Webhook Tool expõe seus endpoints HTTP como ferramentas que sua recepcionista ou assistente comercial pode chamar durante conversas. A IA decide quando chamar o endpoint com base na conversa.

Como as ferramentas de webhook funcionam

Ao criar uma ferramenta de webhook, você define:

  1. Um endpoint HTTP a ser chamado.
  2. Uma descrição do que ela faz, para que a IA saiba quando usá-la.
  3. Parâmetros que a IA deve coletar da conversa.

Durante uma chamada, quando a conversa corresponde à finalidade da ferramenta, sua recepcionista coleta os parâmetros, chama o endpoint e usa a resposta para continuar a conversa.

Criando uma ferramenta de webhook

Acesse Integrations, selecione Add integration e escolha Webhook Tool. Configure os campos abaixo e selecione Enable. Você pode adicionar várias ferramentas de webhook.

CampoDescrição
NameNome da ferramenta que a IA vê, por exemplo check_order_status
DescriptionQuando e por que usar esta ferramenta
MethodGET, POST, PUT, PATCH ou DELETE
URLSeu endpoint HTTP
Response timeout (seconds)Quanto tempo aguardar seu servidor: de 5 a 120 segundos, padrão 20
Assign to agentsReceptionist, Assistant agent ou ambos
Disable interruptionsImpede que quem ligou interrompa enquanto a ferramenta é executada
Request HeadersCabeçalhos opcionais enviados em todas as solicitações, como uma chave de API
Body ParametersParâmetros enviados no corpo da solicitação
Query ParametersParâmetros enviados como strings de consulta na URL

Parâmetros

Cada parâmetro tem:

  • Key: o nome do campo.
  • Type: string, number ou boolean.
  • Description: qual valor a IA deve extrair da conversa.
  • Required: se a IA precisa coletá-lo antes de chamar.

Casos de uso

CenárioDescriçãoMétodo
Consulta de CRMConsulte informações de clientes no seu sistemaGET
Verificação de estoqueVerifique a disponibilidade de produtos em tempo realGET
Captação de leadsEnvie os dados de quem ligou para seu sistema de marketingPOST
Criação de ticketCrie um ticket de suporte durante a chamadaPOST
Cotação de preçoCalcule uma cotação personalizada com base nos requisitos de quem ligouPOST

Exemplo

Uma empresa de encanamento cria uma ferramenta de webhook:

  • Name: check_service_area
  • Description: “Verifique se atendemos o CEP de quem ligou e qual é o próximo horário disponível.”
  • URL: https://api.mybusiness.com/check-area
  • Method: POST
  • Request Headers: Authorization definido como a chave de API da empresa
  • Body Parameters: zip_code (string, obrigatório), service_type (string, obrigatório)

Quando alguém liga perguntando sobre atendimento na sua região, a recepcionista coleta o CEP, chama o webhook e informa o resultado.

As ferramentas de webhook estão disponíveis em todos os planos.