Lesen Sie hier, wie Sie einen Webhook einrichten, damit ein anderes System automatisch benachrichtigt wird, wenn sich eine Fahrt in YesHugo ändert.
Ein Webhook ist eine Webadresse eines anderen Systems, die Sie in YesHugo registrieren. Ändert sich eine Fahrt, sendet YesHugo sofort eine Nachricht an diese Adresse. So muss das andere System nicht selbst abfragen, ob sich etwas geändert hat. Praktisch zum Beispiel für eine Lohnbuchhaltung, ein Planungssystem oder eine eigene Integration.
Gut zu wissen
- Sie benötigen die Rolle Manager. Fahrer sehen die Integrationseinstellungen nicht.
- Ihr Abonnement muss API-Zugang enthalten. Sehen Sie die Meldung Webhooks sind für diese Umgebung deaktiviert. Wenden Sie sich an den Support, um Webhooks nutzen zu können.? Nehmen Sie dann Kontakt mit uns auf.
- Ein Webhook sendet nur eine Nachricht, wenn sich eine bestehende Fahrt ändert: jemand bearbeitet die Fahrt, oder YesHugo verarbeitet die Fahrt erneut und ein Feld ändert sich. Eine neue oder gelöschte Fahrt löst keine Nachricht aus.
- Die Nachricht enthält nur die Fahrt-ID. Das andere System benötigt außerdem einen API-Schlüssel, um die Fahrtdaten abzurufen. Siehe API-Schlüssel verwalten.
Einen Webhook hinzufügen
- Gehen Sie zu Verwaltung > Integrationen und suchen Sie die Karte Webhooks.

- Klicken Sie auf Webhook hinzufügen.

- Füllen Sie das Feld URL (https://) mit der Webadresse des empfangenden Systems aus. Fügen Sie optional eine Beschreibung hinzu, zum Beispiel den Namen des Systems.
- Klicken Sie auf Hinzufügen.
- Das Fenster Signaturgeheimnis zeigt das Geheimnis (beginnt mit
whsec_). Klicken Sie auf Geheimnis kopieren und geben Sie es an die Person weiter, die das empfangende System verwaltet.
Achtung: Speichern Sie dieses Geheimnis jetzt. Nach dem Schließen dieses Fensters ist es nicht mehr sichtbar. Wenn Sie es verlieren, erzeugen Sie ein neues Geheimnis (siehe unten).
- Klicken Sie auf Fertig. Der Webhook ist sofort aktiv.
Mögliche Fehlermeldungen beim Hinzufügen:
- Geben Sie eine URL ein.: Sie haben keine Adresse eingegeben.
- Geben Sie eine gültige https://-Adresse ohne Zugangsdaten in der URL ein.: die Adresse beginnt nicht mit
https://oder enthält einen Benutzernamen oder ein Passwort. - Die URL darf höchstens 2048 Zeichen enthalten.
- Verwenden Sie höchstens 255 Zeichen.: die Beschreibung ist zu lang.
Pausieren, Geheimnis erneuern und löschen
- Pausieren oder fortsetzen: verwenden Sie den Schalter Aktiv in der Zeile des Webhooks. Ein pausierter Webhook erhält keine Nachrichten für Änderungen, die während der Pause stattfinden, auch nicht nachträglich.
- Neues Geheimnis erzeugen: öffnen Sie das Menü Aktionen (⋮) des Webhooks und wählen Sie Neues Geheimnis erzeugen. Bestätigen Sie und kopieren Sie das neue Geheimnis. Achtung: das alte Geheimnis ist sofort ungültig. Senden Sie fehlgeschlagene Nachrichten danach erneut (siehe unten).

- Adresse ändern: eine Adresse kann nicht bearbeitet werden. Fügen Sie einen neuen Webhook mit der neuen Adresse hinzu und löschen Sie danach den alten.
- Löschen: öffnen Sie das Menü Aktionen (⋮) und wählen Sie Löschen. Bestätigen Sie die Meldung. Es werden keine Nachrichten mehr an diese Adresse gesendet.

Zustellverlauf ansehen und Nachrichten erneut senden
- Klicken Sie auf Zustellungen in der Zeile des Webhooks.

- Sie sehen eine Liste mit Nachrichten: Erstellt, Ereignis, Fahrt, Status, Versuche und Nächster Versuch. Filtern Sie nach Ausstehend, Zugestellt oder Fehlgeschlagen.
- Klicken Sie auf eine Nachricht, um die Zustellversuche zu sehen, einschließlich Zeitpunkt, ob es Automatisch oder Manuell war, und die Antwort des empfangenden Systems.

- Möchten Sie eine Nachricht erneut senden? Klicken Sie auf die Nachricht und wählen Sie Jetzt erneut senden. Dies funktioniert auch für bereits zugestellte Nachrichten oder Nachrichten eines pausierten Webhooks.
Probleme lösen
- Die Webhooks-Karte zeigt an, dass Webhooks deaktiviert sind. Ihr Abonnement hat keinen API-Zugang. Nehmen Sie Kontakt mit uns auf.
- Jede Nachricht schlägt fehl. Das empfangende System weist die Nachricht ab, wahrscheinlich weil es ein altes oder falsches Geheimnis verwendet. Erzeugen Sie ein neues Geheimnis, tragen Sie es im empfangenden System ein und senden Sie die fehlgeschlagenen Nachrichten erneut.
- Wir erhalten keine Nachricht für eine neue Fahrt. Das ist so vorgesehen: Webhooks werden nur bei Änderungen gesendet. Eine neue Fahrt wird kurz nach der Verarbeitung geändert (und dann gesendet), sodass die Nachricht normalerweise innerhalb weniger Minuten folgt.
» Lesen Sie hier, wie Sie API-Schlüssel verwalten
» Lesen Sie hier mehr über Integrationen mit externer Software
War dieser Artikel hilfreich?
Das ist großartig!
Vielen Dank für das Feedback
Leider konnten wir nicht helfen
Vielen Dank für das Feedback
Feedback gesendet
Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren