> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Webhooks

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.

| Campo                          | Descrição                                                                     |
| ------------------------------ | ----------------------------------------------------------------------------- |
| **Name**                       | Nome da ferramenta que a IA vê, por exemplo `check_order_status`              |
| **Description**                | Quando e por que usar esta ferramenta                                         |
| **Method**                     | GET, POST, PUT, PATCH ou DELETE                                               |
| **URL**                        | Seu endpoint HTTP                                                             |
| **Response timeout (seconds)** | Quanto tempo aguardar seu servidor: de 5 a 120 segundos, padrão 20            |
| **Assign to agents**           | **Receptionist**, **Assistant agent** ou ambos                                |
| **Disable interruptions**      | Impede que quem ligou interrompa enquanto a ferramenta é executada            |
| **Request Headers**            | Cabeçalhos opcionais enviados em todas as solicitações, como uma chave de API |
| **Body Parameters**            | Parâmetros enviados no corpo da solicitação                                   |
| **Query Parameters**           | Parâ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ário                | Descrição                                                               | Método |
| ---------------------- | ----------------------------------------------------------------------- | ------ |
| Consulta de CRM        | Consulte informações de clientes no seu sistema                         | GET    |
| Verificação de estoque | Verifique a disponibilidade de produtos em tempo real                   | GET    |
| Captação de leads      | Envie os dados de quem ligou para seu sistema de marketing              | POST   |
| Criação de ticket      | Crie um ticket de suporte durante a chamada                             | POST   |
| Cotação de preço       | Calcule uma cotação personalizada com base nos requisitos de quem ligou | POST   |

## 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.