---
title: Webhooks
description: 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](./feature-availability) 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

1. Attendez que le message d'initialisation soit terminé.
2. Si **L'initialisation prend plus de temps que prévu** apparaît, sélectionnez **Réessayer** une fois.
3. Attendez que le portail intégré remplace l'écran d'initialisation.
4. 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é

1. Lisez l'avis **Reconnectez votre magasin Shopify**.
2. Sélectionnez **Reconnecter Shopify**.
3. Complétez le flux de connexion sur la page d'intégration Shopify.
4. 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](./feature-availability). |
| 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. |

## Guides connexes

- [Disponibilité des fonctionnalités](./feature-availability)
- [Sécurité et sessions](../account-and-settings/security-and-sessions)
- [Dépannage des applications](../apps-and-integrations/troubleshooting)
- [Support et communauté](../help-and-reference/support-and-community)