Créer un point de réception

Un webhook envoie un événement de votre espace (« un membre a été invité »…) à une adresse de vos propres systèmes, dès qu'il se produit. L'écran les appelle endpoints.

Avant de commencer

• Il vous faut la permission webhooks:manage.
• Votre système doit exposer une adresse HTTPS joignable depuis Internet ; les adresses de réseaux privés sont refusées.
• La personne qui développe la réception doit lire Vérifier la signature.

Les événements publiés

Événement	Quand	Données envoyées
member.invited	une invitation part	email, organizationName, inviterEmail
member.approved	une demande d'adhésion est acceptée	email
member.rejected	une demande d'adhésion est refusée	email

Étapes

1. Ouvrez Webhooks.
2. Cliquez sur Ajouter un endpoint.
3. Saisissez l'URL de l'endpoint.
4. Sous Événements, laissez Tous les événements publiés, ou décochez-le et choisissez les événements voulus.
5. Cliquez sur Créer.
6. La fenêtre Secret de signature affiche le secret une seule fois : cliquez sur Copier, remettez-le à votre développeur, puis cliquez sur Terminé.

Résultat

L'endpoint apparaît dans la liste avec le statut Actif. Chaque événement abonné lui est désormais envoyé, signé avec ce secret. La création figure au journal d'activité.

Le secret ne se réaffiche jamais. S'il est perdu, faites-le tourner (voir Faire tourner le secret).

Supprimer un endpoint

Cliquez sur Supprimer sur sa ligne et confirmez : les envois s'arrêtent immédiatement.

Si ça ne marche pas

Vous voyez	Ce que ça veut dire	Que faire
« Choisissez au moins un type d'événement. »	Aucun événement n'est coché.	Cochez-en un, ou Tous les événements publiés.
« Impossible de créer l'endpoint. »	L'adresse est refusée (pas en HTTPS, ou mal formée).	Vérifiez l'URL.

Voir aussi

• Surveiller les envois