Dieser Artikel erklärt, wie Sie einen Webhook im Aircall Dashboard erstellen, der es Ihnen ermöglicht, Aircall-Ereignisse in einem externen System Ihrer Wahl zu empfangen.

Schritte:

  1. Melden Sie sich im Aircall Dashboard > Integrationen & API an
  2. Geben Sie in der Suchleiste "Webhook" ein

Screenshot 2025-12-22 at 15.12.36.png

  1. Scrollen Sie nach unten und wählen Sie Webhook aus.
  2. Klicken Sie auf Integration installieren.

Screenshot 2025-12-22 at 15.12.46.png

  1. Konfigurieren Sie Ihre Webhook-Einstellungen:
    • Passen Sie den Namen Ihres Webhooks an.
    • Fügen Sie die URL hinzu, an die Sie Aircall Webhook-Ereignisse erhalten möchten.
    • Wählen Sie die Webhook-Ereignisse aus, die Sie erhalten möchten. Alle Ereignisse sind standardmäßig aktiviert. Für weitere Informationen zur Verwendung von Webhooks und verfügbaren Ereignissen lesen Sie bitte die Webhook-Dokumentation.

Screenshot 2026-04-08 at 6.35.21 PM.png

  1. Klicken Sie auf Webhook hinzufügen, um die Erstellung Ihres Webhooks abzuschließen.
Hinweis: Sobald der Webhook erstellt ist, beginnt Aircall, basierend auf den von Ihnen ausgewählten Ereignissen, Ereignisse an die konfigurierte URL zu senden.

Webhook-Fehlerbehebung

Webhook-Fehler: "timeout of 5000ms exceeded"

Symptom

Sie erhalten die folgende Fehlermeldung, die auf einen Webhook-Fehler hinweist:

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

Ursache

Aircall sendet HTTP-Anfragen an externe Webserver mit einer Timeout-Einstellung von 5 Sekunden. Eine Webhook-Anfrage gilt als fehlgeschlagen, wenn eines der folgenden Ereignisse eintritt:

  • Der empfangende Server antwortet nicht innerhalb von 5 Sekunden.
  • Der Server antwortet mit einem HTTP-Statuscode, der nicht im Bereich von 2XX liegt.

Lösung

Stellen Sie sicher, dass Ihr Server schnell und korrekt auf Webhook-Anfragen reagiert.

  1. Überprüfen Sie Ihren Webhook-Endpunkt, um sicherzustellen, dass er Anfragen effizient verarbeiten kann.
  2. Stellen Sie sicher, dass der Endpunkt einen HTTP-Statuscode 200 zurückgibt.
  3. Vergewissern Sie sich, dass die Antwort innerhalb von 5 Sekunden nach Empfang der Anfrage gesendet wird.
Achtung: Wenn Ihr Server nicht innerhalb von 5 Sekunden einen HTTP-Statuscode 2XX zurückgibt, wird die Webhook-Anfrage als fehlgeschlagen markiert und möglicherweise deaktiviert.

Durch die Optimierung der Antwortzeit und die Sicherstellung einer erfolgreichen HTTP-Antwort können Sie Webhook-Fehler vermeiden und zuverlässige Integrationen mit Aircall aufrechterhalten.