Webhooks

Begrijp de projectwebhooks-pagina en herstel wanneer de ingebedde portal niet gereed is.

Webhooks laten een ander service geselecteerde gebeurtenissen van een Runner-project ontvangen. Dit is een geavanceerde, beveiligingsgevoelige functie: gebruik het alleen wanneer je weet welke service de gebeurtenissen moet ontvangen en hoe die service ze verifieert.

Invoerpad

Open de projectwebhooks-pagina alleen via een invoer die Runner beschikbaar maakt voor je werkruimte. Als er geen invoer is, gis niet naar een URL; zie Beschikbaarheid van functies of vraag ondersteuning of de functie is ingeschakeld.

Voordat je begint

Gebruik Webhooks alleen wanneer Runner of ondersteuning een goedgekeurde invoer blootstelt.
Ken de beoogde ontvangende service en hoe deze gebeurtenissen verifieert.
Behandel eindpuntadressen, ondertekeningsgeheimen en geleverde gegevens als gevoelig.

Wat Runner toont

Runner bereidt de webhookservice voor voordat de ingebedde beheersportal wordt weergegeven.

Paginastatus of besturingselement	Wat het betekent of doet
Laden…	Runner controleert of de webhookservice gereed is.
Webhookplatform wordt geïnitialiseerd	Setup is nog in uitvoering. Wacht en houd de pagina open, of kom later terug.
Initialisatie duurt langer dan verwacht	Setup is niet voltooid na de normale wacht. Opnieuw proberen vraagt Runner om de service opnieuw in te richten.
Opnieuw proberen…	Het opnieuw proberen is in uitvoering; de knop blijft niet beschikbaar totdat het verzoek is voltooid.
Foutbericht	Runner kon de service niet voorbereiden. Houd het zichtbare bericht voor ondersteuning.
Ingebedde webhookportal	De service is gereed. De exacte labels en besturingselementen in deze door provider beheerde portal kunnen veranderen, dus volg de instructies die daar worden weergegeven in plaats van je op vaste knopnamen in deze handleiding te verlaten.
Shopify opnieuw verbinden	Opent de Shopify-integratiepagina wanneer een oudere Shopify-verbinding nieuwe webhookmachtigingen nodig heeft. Verbind opnieuw voordat je Shopify-gebeurtenissen verwacht.

Herstel van een lange initialisatie

Wacht tot het initialisatiebericht is voltooid.
Als Initialisatie duurt langer dan verwacht verschijnt, selecteer Opnieuw proberen eenmaal.
Wacht tot de ingebedde portal het initialisatiescherm vervangt.
Als een fout opnieuw verschijnt, sla de projectnaam en exact bericht op en neem contact op met ondersteuning in plaats van herhaaldelijk opnieuw te proberen.

Verbind Shopify opnieuw wanneer gevraagd

Lees de melding Verbind je Shopify-winkel opnieuw.
Selecteer Shopify opnieuw verbinden.
Voltooi de verbindingsstroom op de Shopify-integratiepagina.
Keer terug naar Webhooks en bevestig dat de herverbindingsmelding weg is voordat je op gebeurtenislevering vertrouwt.

Herverbinding wijzigt de integratieautorisatie van de winkel. Alleen een persoon die de winkelverbinding mag beheren, mag doorgaan.

Beveiligingsopmerkingen

Behandel eindpuntadressen, ondertekeningsgeheimen en gebeurtenisinhoud als gevoelig.
Voeg een bestemming alleen toe of wijzig deze wanneer de eigenaar het juiste beveiligde adres heeft opgegeven.
Bekijk elke bevestiging die in de ingebedde portal wordt weergegeven; de acties kunnen toekomstige leveringen beïnvloeden.
Als een ondertekeningswaarde wordt blootgesteld, vervang deze in zowel de webhookservice van Runner als het ontvangende systeem voordat je meer gebeurtenissen verzendt.

Probleemoplossing

Probleem	Volgende stap
Geen Webhooks-invoer	De functie is niet blootgesteld in deze werkruimte. Controleer Beschikbaarheid van functies.
Initialisatie is niet voltooid	Gebruik Opnieuw proberen eenmaal en rapporteer vervolgens de exacte status als deze zich herhaalt.
Foutbericht verschijnt	Houd het volledige bericht en projectnaam voor ondersteuning.
Shopify-herverbindingsmelding blijft	Voltooi het opnieuw verbinden vanuit de integratiepagina en laad Webhooks vervolgens eenmaal opnieuw.
Ingebedde portal is leeg of gedraagt zich anders	Laad eenmaal opnieuw. Als het aanhoudt, leg vast wat zichtbaar is; de ingebedde providerinterface kan per account of release verschillen.