> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks de voz

> Registra una URL para recibir un aviso por cada evento de llamada de tu organización.

Los **webhooks** avisan a tus sistemas cada vez que ocurre un evento de llamada. Jelou envía una petición `POST` a la URL que registres, lo que te permite llevar el resultado de cada llamada a tu CRM, tu almacén de datos o cualquier flujo interno sin tener que consultar el registro manualmente.

Están en la pestaña **Webhooks** de Voice.

<Frame caption="Pestaña Webhooks con el registro de una URL">
  <img src="https://mintcdn.com/jelouai/AQag8di7NYjLixU_/assets/images/voice/centro-de-voz-webhooks.png?fit=max&auto=format&n=AQag8di7NYjLixU_&q=85&s=a1d7bce3b802af564b17d81194e4426f" alt="Sección Registrar un webhook con el campo de URL y el botón Registrar, y debajo la tabla de webhooks con su URL, tipo y fecha de creación" width="1917" height="1065" data-path="assets/images/voice/centro-de-voz-webhooks.png" />
</Frame>

## Registrar un webhook

Pegas la URL de tu endpoint en el campo y confirmas con **Registrar**. Jelou enviará una petición `POST` a esa URL por cada evento de llamada de tu organización.

La tabla de abajo lista los webhooks ya registrados con tres datos:

| Columna    | Contenido                                                |
| ---------- | -------------------------------------------------------- |
| **URL**    | El endpoint que recibe los eventos.                      |
| **Tipo**   | La categoría de eventos que recibe, por ejemplo `calls`. |
| **Creado** | Cuándo se registró.                                      |

<Note>
  El alcance es **toda la organización**, no un agente o un número concreto. Un webhook registrado aquí recibe los eventos de llamada de todos tus agentes.
</Note>

## Preparar tu endpoint

Tu endpoint debe aceptar peticiones `POST` con cuerpo JSON y responder rápido. Algunas consideraciones que aplican a cualquier receptor de webhooks:

**Responde antes de procesar.** Devuelve una respuesta exitosa en cuanto recibas el evento y haz el trabajo pesado de forma asíncrona. Si tu endpoint tarda, arriesgas reintentos y duplicados.

**Diseña para la idempotencia.** Un mismo evento puede llegar más de una vez ante un error temporal. Usa el identificador de la llamada o de la conversación para reconocer lo que ya procesaste.

**Usa HTTPS y no confíes solo en el secreto de la URL.** El panel no expone un secreto de firma ni documenta un encabezado de verificación, así que la URL es lo único que separa tu endpoint del exterior. Protégelo por tu cuenta: usa una ruta difícil de adivinar, restringe el acceso por IP si tu arquitectura lo permite y trata todo lo que recibas como no confiable hasta validarlo contra tus propios datos.

<Note>
  Si necesitas verificación criptográfica del origen, confírmalo con el equipo de Jelou antes de construir sobre este webhook: no hay un mecanismo de firma documentado en esta pantalla.
</Note>

**Registra lo que recibes.** Guardar el evento crudo junto con la respuesta que diste ahorra mucho tiempo cuando algo no cuadra.

<Warning>
  Los eventos de llamada pueden incluir datos de la conversación y del interlocutor. Trata el endpoint y lo que almacenes con el mismo cuidado que cualquier otro dato personal de tus clientes.
</Warning>

## Qué hacer con los eventos

El evento de fin de llamada es el punto natural para cerrar el ciclo con tus sistemas: registrar el resultado del contacto, actualizar el estado de un caso o disparar el siguiente paso de un proceso.

Si has definido [criterios de evaluación y recolección de datos](/guides/voice/analysis) en el agente, ese análisis es lo que convierte una llamada en un registro utilizable: el motivo del contacto, la clasificación del resultado, si hubo transferencia.

<Tip>
  Antes de construir la integración completa, registra un endpoint que solo guarde el cuerpo de la petición y haz una [llamada de prueba](/guides/voice/numbers). Ver un evento real es más rápido que deducir su forma.
</Tip>

## Desde el CLI

<Card title="jelou voice webhooks" icon="terminal" href="/guides/cli/voice">
  Lista, consulta, crea y elimina webhooks desde la terminal, indicando el tipo de evento.
</Card>
