> 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

La integración **Herramienta de webhook** expone tus rutas de API HTTP como herramientas que tu recepcionista o asistente de negocio puede llamar durante las conversaciones. La IA decide cuándo llamar a la ruta de API según la conversación.

## Cómo funcionan las herramientas de webhook

Cuando creas una herramienta de webhook, defines:

1. Una ruta de API HTTP a la que llamar.
2. Una descripción de lo que hace para que la IA sepa cuándo usarla.
3. Los parámetros que la IA debe recopilar de la conversación.

Durante una llamada, cuando la conversación coincide con el propósito de la herramienta, tu recepcionista recopila los parámetros, llama a la ruta de API y usa la respuesta para continuar la conversación.

## Crear una herramienta de webhook

Ve a **Integraciones**, selecciona **Añadir integración** y elige **Herramienta de webhook**. Configura los campos siguientes y selecciona **Activar**. Puedes añadir varias herramientas de webhook.

| Campo                                        | Descripción                                                                   |
| -------------------------------------------- | ----------------------------------------------------------------------------- |
| **Nombre**                                   | Nombre de la herramienta que ve la IA, por ejemplo `check_order_status`       |
| **Descripción**                              | Cuándo y por qué usar esta herramienta                                        |
| **Método**                                   | GET, POST, PUT, PATCH o DELETE                                                |
| **URL**                                      | Tu ruta de API HTTP                                                           |
| **Tiempo de espera de respuesta (segundos)** | Cuánto esperar a tu servidor: de 5 a 120 segundos, 20 de forma predeterminada |
| **Asignar a agentes**                        | **Recepcionista**, **Agente asistente** o ambos                               |
| **Desactivar interrupciones**                | Impide que quien llama interrumpa mientras se ejecuta la herramienta          |
| **Cabeceras de solicitud**                   | Cabeceras opcionales enviadas con cada solicitud, como una clave de API       |
| **Parámetros del cuerpo**                    | Parámetros enviados en el cuerpo de la solicitud                              |
| **Parámetros de consulta**                   | Parámetros enviados como cadenas de consulta de URL                           |

### Parámetros

Cada parámetro tiene:

* **Clave**: el nombre del campo.
* **Tipo**: `string`, `number` o `boolean`.
* **Descripción**: el valor que la IA debe extraer de la conversación.
* **Obligatorio**: si la IA debe recopilarlo antes de llamar.

## Casos de uso

| Escenario                  | Descripción                                                              | Método |
| -------------------------- | ------------------------------------------------------------------------ | ------ |
| Consulta de CRM            | Consulta información de clientes en tu sistema                           | GET    |
| Comprobación de inventario | Comprueba la disponibilidad de productos en tiempo real                  | GET    |
| Captación de contactos     | Envía los datos de quien llama a tu sistema de marketing                 | POST   |
| Creación de tickets        | Crea un ticket de asistencia durante la llamada                          | POST   |
| Presupuesto                | Calcula un presupuesto personalizado según los requisitos de quien llama | POST   |

## Ejemplo

Una empresa de fontanería crea una herramienta de webhook:

* **Nombre:** `check_service_area`
* **Descripción:** "Comprueba si ofrecemos servicio en el código postal de quien llama y cuál es la siguiente franja disponible."
* **URL:** `https://api.mybusiness.com/check-area`
* **Método:** POST
* **Cabeceras de solicitud:** `Authorization` configurada con la clave de API de la empresa
* **Parámetros del cuerpo:** `zip_code` (string, obligatorio), `service_type` (string, obligatorio)

Cuando alguien llama para consultar el servicio en su zona, la recepcionista recopila su código postal, llama al webhook y le comunica el resultado.

Las herramientas de webhook están disponibles en todos los planes.