Webhooks

Comprendre la page Webhooks du projet et récupérer quand son portail intégré n'est pas prêt.

Les webhooks permettent à un autre service de recevoir les événements sélectionnés d'un projet Runner. C'est une fonctionnalité avancée et sensible à la sécurité : utilisez-la uniquement quand vous savez quel service doit recevoir les événements et comment ce service les vérifie.

Chemin d'accès

Ouvrez la page Webhooks du projet uniquement par une entrée que Runner met à disposition de votre espace de travail. S'il n'y a pas d'entrée, ne devinez pas une URL ; consultez Disponibilité des fonctionnalités ou demandez au support si la fonctionnalité est activée.

Avant de commencer

Utilisez Webhooks uniquement quand Runner ou le support expose une entrée approuvée.
Connaissez le service destinataire prévu et comment il vérifie les événements.
Traitez les adresses de point de terminaison, les secrets de signature et les données livrées comme sensibles.

Ce que Runner affiche

Runner prépare le service webhook avant d'afficher le portail de gestion intégré.

État de la page ou contrôle	Ce qu'il signifie ou fait
Chargement…	Runner vérifie si le service webhook est prêt.
La plateforme webhook s'initialise	La configuration est toujours en cours. Attendez et gardez la page ouverte, ou revenez plus tard.
L'initialisation prend plus de temps que prévu	La configuration n'a pas été complétée après l'attente normale. Réessayer demande à Runner de provisionner le service à nouveau.
Nouvelle tentative en cours…	La nouvelle tentative est en cours ; le bouton reste indisponible jusqu'à ce que la demande soit terminée.
Message d'erreur	Runner n'a pas pu préparer le service. Conservez le message visible pour le support.
Portail webhook intégré	Le service est prêt. Les étiquettes et contrôles exacts à l'intérieur de ce portail géré par le fournisseur peuvent changer, alors suivez les instructions affichées là plutôt que de vous fier à des noms de boutons fixes dans ce guide.
Reconnecter Shopify	Ouvre la page d'intégration Shopify quand une connexion Shopify plus ancienne a besoin de nouvelles permissions de webhook. Reconnectez avant de vous attendre à ce que les événements Shopify arrivent.

Récupérer d'une initialisation longue

Attendez que le message d'initialisation soit terminé.
Si L'initialisation prend plus de temps que prévu apparaît, sélectionnez Réessayer une fois.
Attendez que le portail intégré remplace l'écran d'initialisation.
Si une erreur apparaît à nouveau, enregistrez le nom du projet et le message exact, puis contactez le support au lieu de réessayer à plusieurs reprises.

Reconnecter Shopify quand demandé

Lisez l'avis Reconnectez votre magasin Shopify.
Sélectionnez Reconnecter Shopify.
Complétez le flux de connexion sur la page d'intégration Shopify.
Revenez à Webhooks et confirmez que l'avis de reconnexion est parti avant de compter sur la livraison d'événements.

La reconnexion modifie l'autorisation d'intégration du magasin. Seule une personne autorisée à gérer cette connexion de magasin doit continuer.

Notes de sécurité

Traitez les adresses de point de terminaison, les secrets de signature et les contenus d'événements comme sensibles.
Ajoutez ou modifiez une destination uniquement quand son propriétaire a fourni l'adresse sécurisée correcte.
Examinez chaque confirmation affichée à l'intérieur du portail intégré ; ses actions peuvent affecter les livraisons futures.
Si une valeur de signature est exposée, remplacez-la dans le service webhook de Runner et le système de réception avant d'envoyer plus d'événements.

Dépannage

Problème	Étape suivante
Aucune entrée Webhooks	La fonctionnalité n'est pas exposée dans cet espace de travail. Vérifiez Disponibilité des fonctionnalités.
L'initialisation ne se termine pas	Utilisez Réessayer une fois, puis signalez l'état exact s'il se répète.
Un message d'erreur apparaît	Conservez le message complet et le nom du projet pour le support.
L'avis de reconnexion Shopify persiste	Terminez la reconnexion à partir de la page d'intégration, puis rechargez Webhooks une fois.
Le portail intégré est vide ou se comporte différemment	Rechargez une fois. S'il persiste, capturez ce qui est visible ; l'interface du fournisseur intégré peut différer selon le compte ou la version.