Este artículo explica cómo crear un Webhook en el Panel de control de Aircall para recibir eventos de Aircall en el sistema externo que elijas.

Pasos:

  1. Accede a Panel de control de Aircall > Integraciones > Webhooks
  2. Haz clic en el botón verde Añadir Webhook y selecciona Instalar Webhook
  3. Configura los ajustes de tu Webhook:
  • Personaliza el nombre de tu Webhook.
  • Añade la URL en la que quieres recibir los eventos de Webhook de Aircall.
  • Selecciona los eventos de Webhook que quieres recibir. Todos los eventos están activados de forma predeterminada. Para obtener más información sobre el uso de Webhook y los eventos disponibles, consulta la documentación de Webhook.
Screenshot 2026-04-08 at 6.35.21 PM.png
  1. Haz clic en Añadir Webhook para completar la creación de tu Webhook.
Nota: Una vez creado el Webhook, Aircall comienza a enviar eventos a la URL configurada en función de los eventos que hayas seleccionado.

Solución de problemas de Webhook

Error de Webhook: "se superó el tiempo de espera de 5000 ms"

Síntoma

Recibes la siguiente respuesta de error, que indica un fallo de Webhook:

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

Causa

Aircall envía solicitudes HTTP a servidores web externos con un tiempo de espera establecido en 5 segundos. Una solicitud de Webhook se considera fallida 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 se encuentra en el rango 2XX.

Resolución

Asegúrate de que tu servidor responda rápida y correctamente a las solicitudes de Webhook.

  1. Revisa el endpoint de tu Webhook para confirmar que puede procesar las solicitudes de forma eficiente.
  2. Asegúrate de que el endpoint devuelva un código de estado HTTP 200.
  3. Comprueba que la respuesta se envíe en un plazo de 5 segundos tras recibir la solicitud.
Importante: Si tu servidor no devuelve un código de estado HTTP 2XX en un plazo de 5 segundos, la solicitud de Webhook se marca como fallida y puede desactivarse.

Al optimizar el tiempo de respuesta y garantizar una respuesta HTTP correcta, puedes evitar fallos de Webhook y mantener integraciones fiables con Aircall.