Ouvrir les webhooks
Un webhook envoie un événement à l’adresse d’une application externe. Cet écran s’adresse à l’administrateur des intégrations du client sélectionné. Ouvrez Webhooks, directement ou depuis l’onglet de la page API. La lecture et la modification ont des droits distincts.
La liste affiche nom, URL cible, événements, état, dernière réussite et échecs sur 24 heures. Recherchez un nom, une URL, un identifiant ou un événement ; choisissez tous, actifs ou inactifs. Ces filtres portent sur la page chargée, de cinquante destinations au maximum. Parcourez les autres pages si nécessaire.
Créer ou modifier une destination
- Cliquez sur Ajouter un webhook, ou sur Modifier dans une ligne.
- Remplissez la destination et choisissez les événements.
- Ouvrez les options avancées seulement si votre destinataire les exige.
- Cliquez sur Enregistrer et attendez le retour à la liste. Annuler revient à la liste sans enregistrer le brouillon.
| Champ | À quoi ça sert | Valeurs possibles | Exemple |
|---|---|---|---|
| Actif | Autoriser les envois | Activé au départ | Désactivé pendant la préparation |
| Nom | Repérer la destination ; facultatif | Texte, 120 caractères au maximum | Suivi des appels |
| URL cible | Adresse du destinataire ; obligatoire | URL HTTP ou HTTPS avec hôte, sans utilisateur ni mot de passe dans l’URL | https://integration.exemple.test/evenements |
| Clé secrète | Protéger la signature des envois | Secret ; vide en modification conserve celui enregistré | Secret conservé dans votre gestionnaire |
| Tous (y compris futurs) | Recevoir tous les événements proposés, actuels et futurs | Sélectionné au départ | Tous |
| Choisir | Limiter les événements | Au moins un événement coché | Événements d’appels nécessaires |
| Méthode | Verbe HTTP utilisé | POST au départ, PUT ou PATCH | POST |
| Type de contenu | Format de la requête | application/json au départ, text/plain | application/json |
| Corps personnalisé | Modèle optionnel du corps | Texte, au maximum 32 768 caractères | Modèle préparé par votre intégrateur |
Générer prépare une clé aléatoire dans le champ, mais ne l’enregistre pas. La commande d’affichage permet de révéler puis masquer la saisie. Le secret existant n’est jamais prérempli. Dans Choisir, recherchez un événement, dépliez un thème et cochez une ligne ou Tout le groupe. Un événement signalé comme non émis ne doit pas être considéré comme une source de notifications actives.
Une URL invalide ou une sélection d’événements vide bloque l’enregistrement. Cliquez sur l’explication affichée pour revenir au champ à corriger.
Envoyer un test
Envoyer un test contacte réellement le destinataire. Depuis la fiche, le bouton n’est disponible que pour une destination déjà enregistrée, sans modification en attente. Il teste la version enregistrée, jamais le brouillon. La fenêtre de résultat donne le statut HTTP, la durée, la réponse et l’éventuelle erreur. Fermez-la après lecture ; un statut sans réponse n’est pas une réussite.
Consulter l’historique et reprendre un envoi
- Ouvrez l’historique depuis la ligne de la destination.
- Repérez la date, l’événement, le code HTTP, la durée et le numéro de tentative.
- Si nécessaire, utilisez Copier les références d’envoi pour transmettre les références à l’intégrateur.
- Utilisez Renvoyer uniquement lorsqu’il est proposé sur une livraison rejouable. Une reprise déjà planifiée est signalée.
- Si l’envoi a déjà été livré, relisez Renvoyer un envoi déjà livré ? : la confirmation peut créer un doublon chez le destinataire. Annulez pour éviter le nouvel envoi.
L’historique est paginé par cinquante tentatives. Désactiver la destination demande une confirmation ; après succès, le badge devient inactif. Cela conserve la destination pour une correction ultérieure.
Supprimer et vérifier le résultat
Supprimer demande confirmation avec le nom ou l’adresse cible. Relisez la destination avant de confirmer ; une erreur conserve la confirmation et permet de lire le motif. La sélection de plusieurs lignes propose également la suppression avec les droits d’écriture.
Si la liste ne se charge pas, utilisez la reprise affichée. Si une recherche est vide, retirez les filtres. Si un test échoue, corrigez le destinataire à partir du code et de la réponse, enregistrez, puis testez à nouveau. Ne concluez pas à une intégration fonctionnelle uniquement parce que l’enregistrement a réussi.