Integrações

Webhooks

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

As integrações de webhook disponibilizam endpoints HTTP personalizados como ferramentas que a recepcionista ou o assistente de negócios podem usar durante as conversas. Diferentemente de sistemas de notificação passivos, a IA chama ativamente esses endpoints quando o contexto da conversa exige.

Como funcionam as ferramentas de webhook

Ao criar uma integração de webhook, você define:

  1. Um endpoint HTTP que sua recepcionista pode chamar
  2. Uma descrição do que ele faz (para que a IA saiba quando usá-lo)
  3. Parâmetros que a IA deve coletar da conversa

Durante uma ligação, se a conversa corresponder à finalidade da ferramenta, sua recepcionista chama o endpoint, processa a resposta e continua a conversa.

Criando uma ferramenta de webhook

  1. Vá para Integrações → clique em Webhook
  2. Clique em Adicionar webhook
  3. Configure:
CampoDescrição
NomeNome da ferramenta que a IA vê internamente
DescriçãoQuando e por que usar esta ferramenta (ajuda a IA a decidir)
URLSeu endpoint HTTP
MétodoGET, POST, PUT, PATCH ou DELETE
Parâmetros do corpoParâmetros enviados no corpo da solicitação
Parâmetros de consultaParâmetros enviados como strings de consulta na URL
Tempo limite da respostaQuanto tempo aguardar pelo seu servidor (segundos)
Desativar interrupçõesImpede que quem liga interrompa enquanto a ferramenta é executada
Agentes-alvoQuais agentes podem usar esta ferramenta

Parâmetros

Cada parâmetro tem:

  • Chave — O nome do campo
  • Tipo — string, number ou boolean
  • Descrição — Qual valor a IA deve extrair da conversa
  • Obrigatório — Se a IA deve coletar isso antes de chamar

Agentes-alvo

Atribua cada ferramenta de webhook a:

  • Recepcionista de atendimento ao cliente — Disponível durante ligações telefônicas
  • Assistente de negócios — Disponível no chat do painel
  • Ambos — Disponível em todos os lugares

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
Captura de leadsEnvie os dados de quem liga para seu sistema de marketingPOST
Criação de ticketCrie um ticket de suporte durante a ligaçãoPOST
Cotação de preçoCalcule uma cotação personalizada com base nas necessidades de quem ligaPOST

Exemplo

Uma empresa de encanamento cria uma ferramenta de webhook:

  • Nome: “Verificar disponibilidade na região”
  • Descrição: “Verificar se atendemos o CEP de quem liga e qual é o próximo horário disponível”
  • URL: https://api.mybusiness.com/check-area
  • Método: POST
  • Parâmetros: zip_code (string, obrigatório), service_type (string, obrigatório)

Durante uma ligação, quando alguém pergunta sobre a disponibilidade na sua região, a recepcionista coleta o CEP, chama o webhook e informa o resultado.

As integrações de webhook exigem o plano Basic ou superior.