Cet article explique comment créer un Webhook dans le tableau de bord Aircall afin de recevoir les événements Aircall dans le système externe de votre choix.

Étapes :

  1. Connectez-vous au tableau de bord Aircall > Intégrations > Webhooks
  2. Cliquez sur le bouton vert Ajouter un Webhook , puis sélectionnez Installer le Webhook
  3. Configurez les paramètres de votre Webhook :
  • Personnalisez le nom de votre Webhook.
  • Ajoutez l’URL à laquelle vous souhaitez recevoir les événements Webhook d’Aircall.
  • Sélectionnez les événements Webhook que vous souhaitez recevoir. Tous les événements sont activés par défaut. Pour en savoir plus sur l’utilisation des Webhooks et les événements disponibles, consultez la documentation Webhook.
Screenshot 2026-04-08 at 6.35.21 PM.png
  1. Cliquez sur Ajouter un Webhook pour terminer la création de votre Webhook.
Remarque: :
Une fois le Webhook créé, Aircall commence à envoyer des événements à l’URL configurée en fonction des événements que vous avez sélectionnés.

Résolution des problèmes liés aux Webhooks

Erreur de Webhook : « timeout of 5000ms exceeded »

Symptôme

Vous recevez la réponse d’erreur suivante indiquant l’échec d’un Webhook :

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

Cause

Aircall envoie des requêtes HTTP à des serveurs Web externes avec un délai d’expiration défini sur 5 secondes. Une requête Webhook est considérée comme ayant échoué dans l’un des cas suivants :

  • Le serveur destinataire ne répond pas dans un délai de 5 secondes.
  • Le serveur répond avec un code d’état HTTP qui n’est pas compris dans la plage 2XX.

Résolution

Assurez-vous que votre serveur répond rapidement et correctement aux requêtes Webhook.

  1. Examinez votre point de terminaison Webhook pour vérifier qu’il peut traiter efficacement les requêtes.
  2. Assurez-vous que le point de terminaison renvoie un code d’état HTTP 200.
  3. Vérifiez que la réponse est envoyée dans les 5 secondes suivant la réception de la requête.
Important: :
Si votre serveur ne renvoie pas de code d’état HTTP 2XX dans un délai de 5 secondes, la requête Webhook est marquée comme ayant échoué et peut être désactivée.

En optimisant le temps de réponse et en garantissant une réponse HTTP réussie, vous pouvez éviter les échecs de Webhooks et maintenir des intégrations fiables avec Aircall.