Webhooks

Verstehen Sie die Webhooks-Seite des Projekts und stellen Sie wieder her, wenn sein eingebettetes Portal nicht bereit ist.

Webhooks ermöglichen es einem anderen Service, ausgewählte Ereignisse aus einem Runner-Projekt zu empfangen. Dies ist eine erweiterte, sicherheitsempfindliche Funktion: Verwenden Sie sie nur, wenn Sie wissen, welcher Service die Ereignisse empfangen soll und wie dieser Service sie überprüft.

Eingabepfad

Öffnen Sie die Webhooks-Seite des Projekts nur über einen Eintrag, den Runner für Ihren Workspace verfügbar macht. Wenn es keinen Eintrag gibt, raten Sie nicht einfach eine URL; siehe Funktionsverfügbarkeit oder fragen Sie den Support, ob die Funktion aktiviert ist.

Bevor Sie beginnen

Verwenden Sie Webhooks nur, wenn Runner oder der Support einen genehmigten Eintrag verfügbar macht.
Kennen Sie den beabsichtigten empfangenden Service und wie er Ereignisse überprüft.
Behandeln Sie Endpunktadressen, Signaturschlüssel und übermittelte Daten als vertraulich.

Was Runner anzeigt

Runner bereitet den Webhook-Service vor, bevor das eingebettete Verwaltungsportal angezeigt wird.

Seitenzustand oder Steuerelement	Was es bedeutet oder tut
Wird geladen…	Runner überprüft, ob der Webhook-Service bereit ist.
Webhook-Plattform wird initialisiert	Die Einrichtung ist noch nicht abgeschlossen. Warten Sie und halten Sie die Seite offen, oder kehren Sie später zurück.
Initialisierung dauert länger als erwartet	Die Einrichtung wurde nach der normalen Wartezeit nicht abgeschlossen. Erneut versuchen fordert Runner auf, den Service erneut bereitzustellen.
Wird erneut versucht…	Der Wiederholungsversuch ist in Bearbeitung; die Schaltfläche bleibt nicht verfügbar, bis die Anfrage abgeschlossen ist.
Fehlermeldung	Runner konnte den Service nicht vorbereiten. Behalten Sie die sichtbare Meldung für den Support.
Eingebettetes Webhook-Portal	Der Service ist bereit. Die genauen Bezeichnungen und Steuerelemente in diesem vom Anbieter verwalteten Portal können sich ändern. Folgen Sie daher den dort angezeigten Anweisungen, anstatt sich auf feste Schaltflächennamen in diesem Leitfaden zu verlassen.
Shopify erneut verbinden	Öffnet die Shopify-Integrationenseite, wenn eine ältere Shopify-Verbindung neue Webhook-Berechtigungen benötigt. Verbinden Sie erneut, bevor Sie erwarten, dass Shopify-Ereignisse ankommen.

Wiederherstellung nach einer langen Initialisierung

Warten Sie, bis die Initialisierungsmeldung abgeschlossen ist.
Wenn Initialisierung dauert länger als erwartet angezeigt wird, wählen Sie Erneut versuchen einmal aus.
Warten Sie, bis das eingebettete Portal den Initialisierungsbildschirm ersetzt.
Wenn ein Fehler erneut angezeigt wird, speichern Sie den Projektnamen und die genaue Meldung und kontaktieren Sie stattdessen den Support, anstatt wiederholt zu versuchen.

Shopify erneut verbinden, wenn aufgefordert

Lesen Sie die Mitteilung Shopify-Store erneut verbinden.
Wählen Sie Shopify erneut verbinden aus.
Schließen Sie den Verbindungsfluss auf der Shopify-Integrationenseite ab.
Kehren Sie zu Webhooks zurück und bestätigen Sie, dass die Wiederverbindungsmitteilung weg ist, bevor Sie sich auf die Ereignisbereitstellung verlassen.

Das erneute Verbinden ändert die Integrationsgenehmigung des Stores. Nur eine Person, die berechtigt ist, diese Store-Verbindung zu verwalten, sollte fortfahren.

Sicherheitshinweise

Behandeln Sie Endpunktadressen, Signaturschlüssel und Ereignisinhalte als vertraulich.
Fügen Sie ein Ziel hinzu oder ändern Sie es nur, wenn sein Besitzer die korrekte sichere Adresse angegeben hat.
Überprüfen Sie jede Bestätigung, die im eingebetteten Portal angezeigt wird; ihre Aktionen können zukünftige Lieferungen beeinflussen.
Wenn ein Signaturwert offengelegt wird, ersetzen Sie ihn sowohl im Webhook-Service von Runner als auch im empfangenden System, bevor Sie weitere Ereignisse senden.

Fehlerbehebung

Problem	Nächster Schritt
Kein Webhooks-Eintrag	Die Funktion ist in diesem Workspace nicht verfügbar. Überprüfen Sie Funktionsverfügbarkeit.
Initialisierung wird nicht abgeschlossen	Verwenden Sie Erneut versuchen einmal, melden Sie dann den genauen Zustand, wenn er sich wiederholt.
Fehlermeldung wird angezeigt	Behalten Sie die vollständige Meldung und den Projektnamen für den Support.
Shopify-Wiederverbindungsmitteilung bleibt bestehen	Schließen Sie die Wiederverbindung von der Integrationenseite ab und laden Sie Webhooks dann einmal neu.
Eingebettetes Portal ist leer oder verhält sich anders	Laden Sie einmal neu. Wenn es weiterhin besteht, erfassen Sie, was sichtbar ist; die eingebettete Anbieteroberfläche kann je nach Konto oder Version unterschiedlich sein.