In diesem Artikel wird erklärt, wie Sie einen Webhook im Aircall Dashboard erstellen, um Aircall-Ereignisse in einem externen System Ihrer Wahl zu empfangen.

Schritte:

  1. Melden Sie sich unter Aircall Dashboard > Integrationen > Webhooks an
  2. Klicken Sie auf die grüne Schaltfläche Webhook hinzufügen und wählen Sie dann Webhook installieren aus
  3. Konfigurieren Sie Ihre Webhook-Einstellungen:
  • Passen Sie den Namen Ihres Webhooks an.
  • Fügen Sie die URL hinzu, unter der Sie Aircall-Webhook-Ereignisse empfangen möchten.
  • Wählen Sie die Webhook-Ereignisse aus, die Sie empfangen möchten. Standardmäßig sind alle Ereignisse aktiviert. Weitere Informationen zur Verwendung von Webhooks und zu verfügbaren Ereignissen finden Sie in der 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 wurde, beginnt Aircall, basierend auf den von Ihnen ausgewählten Ereignissen Ereignisse an die konfigurierte URL zu senden.

Fehlerbehebung bei Webhooks

Webhook-Fehler: "timeout of 5000ms exceeded"

Symptom

Sie erhalten die folgende Fehlerantwort, 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 mit einem auf 5 Sekunden festgelegten Timeout an externe Webserver. Eine Webhook-Anfrage gilt als fehlgeschlagen, wenn einer der folgenden Fälle eintritt:

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

Lösung

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

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

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