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

Étapes :

  1. Connectez-vous à Tableau de bord Aircall > Intégrations & API
  2. Dans la barre de recherche, tapez "Webhook"

Screenshot 2025-12-22 at 15.12.36.png

  1. Faites défiler vers le bas et sélectionnez Webhook.
  2. Cliquez sur Installer l’intégration.

Screenshot 2025-12-22 at 15.12.46.png

  1. Configurez les paramètres de votre Webhook :
    • Personnalisez le nom de votre webhook.
    • Ajoutez l’URL où vous souhaitez recevoir les événements Webhook Aircall.
    • Sélectionnez les événements webhook que vous souhaitez recevoir. Tous les événements sont activés par défaut. Pour plus d’informations 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 le Webhook pour finaliser 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.

Dépannage des Webhooks

Erreur Webhook : "timeout of 5000ms exceeded"

Symptôme

Vous recevez la réponse d’erreur suivante indiquant un échec du webhook :

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

Cause

Aircall envoie des requêtes HTTP aux serveurs web externes avec un délai d’attente fixé à 5 secondes. Une requête webhook est considérée comme échouée si l’une des situations suivantes se produit :

  • Le serveur récepteur ne répond pas dans les 5 secondes.
  • Le serveur répond avec un code de statut HTTP qui n’est pas dans la plage 2XX.

Résolution

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

  1. Vérifiez votre point de terminaison webhook pour confirmer qu’il peut traiter les requêtes efficacement.
  2. Assurez-vous que le point de terminaison renvoie un code de statut 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 un code de statut HTTP 2XX dans les 5 secondes, la requête webhook est marquée comme échouée et peut être désactivée.

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