Este artículo explica cómo crear un Webhook en el Panel de Control de Aircall, lo que le permite recibir eventos de Aircall en un sistema externo de su elección.

Pasos:

  1. Inicie sesión en Panel de Control de Aircall > Integraciones y API
  2. En la barra de búsqueda, escriba "Webhook"

Screenshot 2025-12-22 at 15.12.36.png

  1. Desplácese hacia abajo y seleccione Webhook.
  2. Haga clic en Instalar integración.

Screenshot 2025-12-22 at 15.12.46.png

  1. Configure los ajustes de su Webhook:
    • Personalice el nombre de su webhook.
    • Añada la URL donde desea recibir los eventos del Webhook de Aircall.
    • Seleccione los eventos del webhook que desea recibir. Todos los eventos están habilitados por defecto. Para más información sobre el uso del webhook y los eventos disponibles, consulte la documentación del Webhook.

Screenshot 2026-04-08 at 6.35.21 PM.png

  1. Haga clic en Añadir Webhook para completar la creación de su Webhook.
Nota: Una vez creado el Webhook, Aircall comienza a enviar eventos a la URL configurada según los eventos que haya seleccionado.

Solución de problemas del Webhook

Error del Webhook: "timeout de 5000ms excedido"

Síntoma

Recibe la siguiente respuesta de error que indica un fallo del webhook:

{
  "status": "{\"message\":\"timeout de 5000ms excedido\",\"name\":\"AxiosError\",\"stack\":\"AxiosError: timeout de 5000ms e…\"}
}

Causa

Aircall envía solicitudes HTTP a servidores web externos con un tiempo de espera establecido en 5 segundos. Se considera que una solicitud de webhook ha fallado si ocurre alguna de las siguientes situaciones:

  • El servidor receptor no responde en un plazo de 5 segundos.
  • El servidor responde con un código de estado HTTP que no está en el rango 2XX.

Resolución

Asegúrese de que su servidor responda rápida y correctamente a las solicitudes del webhook.

  1. Revise el endpoint de su webhook para confirmar que puede procesar las solicitudes de manera eficiente.
  2. Asegúrese de que el endpoint devuelva un código de estado HTTP 200.
  3. Verifique que la respuesta se envíe dentro de los 5 segundos posteriores a la recepción de la solicitud.
Importante: Si su servidor no devuelve un código de estado HTTP 2XX dentro de 5 segundos, la solicitud del webhook se marca como fallida y puede ser desactivada.

Optimizando el tiempo de respuesta y asegurando una respuesta HTTP exitosa, puede evitar fallos en el webhook y mantener integraciones fiables con Aircall.