Webhooks

Bekijk webhookbestemmingen en afleveractiviteit, of herstel wanneer het aanbiederportaal 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 Bouwen → Webhooks wanneer Runner deze optie aan uw werkruimte aanbiedt. Raad geen URL als de optie ontbreekt; zie Functiebeschikbaarheid of vraag ondersteuning of de functie is ingeschakeld.

Voordat u 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

Uw werkruimte kan Runners webhookwerkbank of een ingesloten aanbiederportaal tonen. Volg de sectie die overeenkomt met uw scherm.

Bekijk de Runner-werkbank

Voorwaardelijk: wanneer de eigen werkbank is ingeschakeld, gebruikt u deze tabbladen:

Tabblad	Wat u controleert
Eindpunten	Ingestelde ontvangende bestemmingen en hun status.
Catalogus	Beschikbare gebeurtenistypen voordat u kiest wat een bestemming ontvangt.
Logboeken	Vastgelegde afleveringen en hun retourstatus.
Activiteit	Recente webhookactiviteit.

Open Eindpunten en zoek de bestemming die u wilt bekijken.
Lees Catalogus om het relevante gebeurtenistype te controleren.
Open Logboeken en bekijk een beschikbare aflevering voor die bestemming.
Vergelijk de status met de registratie van de ontvangende dienst voordat u de aflevering geslaagd noemt.

Controlepunt: een opgeslagen eindpunt bevestigt de configuratie; een geslaagde aflevering plus een overeenkomende registratie bij de ontvanger bevestigen die specifieke gebeurtenis. Een leeg logboek bewijst niet dat afleveren werkt. Test-, opnieuw-versturen- en herhaalacties verzenden gebeurtenissen; gebruik deze alleen voor een bedoelde test.

Ingesloten aanbiederportaal

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.