Comment recevoir des notifications avec les webhooks ?
Un webhook est une notification automatique : chaque fois qu'un client fait quelque chose (il vous écrit dans le chat, termine une séance, commente un exercice…), TrainerStudio appelle une adresse web (une URL) que vous lui indiquez. Votre agent IA, votre automatisation Zapier ou Make, ou votre propre système sont ainsi prévenus aussitôt, sans avoir à interroger TrainerStudio toutes les quelques minutes.
Vous n'avez pas besoin de savoir programmer : l'outil que vous voulez connecter vous donne une URL et vous la collez dans TrainerStudio. Les détails techniques se trouvent dans la documentation pour les développeurs (en anglais).
1. Ouvrez l'onglet Webhooks
Allez dans Votre app → Développeurs dans le menu latéral (elle se trouve aussi dans Paramètres → Développeurs) et ouvrez l'onglet Webhooks.
Seul le titulaire du compte peut gérer les webhooks.
2. Ajoutez un endpoint
Un endpoint est l'URL qui reçoit les notifications.
- Cliquez sur Ajouter un endpoint.
- Dans URL de l'endpoint, collez l'adresse fournie par votre outil. Elle doit commencer par
https://. - Dans Description, écrivez de quoi le reconnaître : « Zapier, nouveaux messages », « Agent IA ».
- Choisissez ce que vous voulez recevoir :
- Tous les événements : vous recevez tout, y compris les types d'événements que nous ajouterons plus tard.
- Uniquement les événements que je choisis : vous cochez ceux qui vous intéressent.
- Enregistrez.
Vous pouvez avoir jusqu'à 10 endpoints. Créez-en un par outil : si vous arrêtez d'utiliser un outil, vous ne supprimez que le sien.
Événements disponibles
| Événement | Quand il est envoyé |
|---|---|
| Message de chat reçu | Un client vous écrit dans le chat de l'app |
| Séance terminée | Un client termine la séance du jour |
| Commentaire sur une séance | Un client laisse un commentaire, une photo ou une vidéo sur un exercice |
| Mesure enregistrée | Une valeur est enregistrée pour une mesure d'un client |
| Tâche terminée | Un client termine une tâche |
| Photo de progression ajoutée | Un client ajoute une photo de progression |
| Formulaire rempli | Un client répond à un formulaire |
La notification indique ce qui s'est passé et pour quel client, mais ne contient pas le contenu (ni le texte du message ni les mesures). Votre outil consulte les détails avec son propre accès à votre compte.
3. Copiez le secret de signature
À la création de l'endpoint, la fenêtre Copiez votre secret de signature s'affiche. Le secret (il commence par whsec_) permet à votre outil de vérifier que la notification vient bien de TrainerStudio.
- Il n'est affiché que cette fois. Copiez-le et collez-le dans votre outil avant de cliquer sur Je l'ai copié.
- Si votre outil ne demande pas de secret (c'est le cas de nombreuses automatisations simples), vous pouvez continuer sans l'utiliser.
- Si vous le perdez, faites une rotation du secret pour en obtenir un nouveau.
4. Envoyez un événement de test
Sur la page de l'endpoint, cliquez sur Envoyer un événement de test. En quelques secondes, vous voyez comment votre outil a répondu :
- Réussi : tout fonctionne.
- En échec : vous voyez la raison (l'URL ne répond pas, elle met plus de 10 secondes, elle renvoie une erreur…). Vérifiez l'URL dans votre outil et réessayez.
5. Consultez les envois
La page de chaque endpoint affiche :
- Les statistiques des 7 ou 30 derniers jours : taux de réussite, temps de réponse et envois par jour.
- Le Journal des envois : chaque notification envoyée ces 30 derniers jours. Ouvrez-en une pour voir ses tentatives, la réponse de votre outil et le contenu exact envoyé.
- Renvoyer : renvoie une notification en échec, par exemple après avoir corrigé votre outil.
Si un envoi échoue, TrainerStudio le retente tout seul jusqu'à 8 fois pendant un peu plus d'une journée, en attendant plus longtemps à chaque fois. Vous n'avez rien à faire.
6. Faites une rotation du secret si vous le perdez
Sur la page de l'endpoint, cliquez sur Rotation du secret. Vous recevez un nouveau secret et, pendant 24 heures, les notifications sont signées avec le nouveau et avec le précédent : vous avez ce délai pour le changer dans votre outil sans perdre de notifications.
7. Désactivez ou supprimez un endpoint
- Désactiver arrête l'envoi de notifications à cet endpoint et annule celles en attente. Vous pouvez l'Activer de nouveau quand vous voulez. Les événements survenus pendant qu'il est désactivé ne sont pas envoyés après coup.
- Supprimer l'endpoint le supprime définitivement. Cette action est irréversible.
Si TrainerStudio le désactive tout seul
Un endpoint est désactivé automatiquement quand :
- il n'a accepté aucun envoi depuis 3 jours, ou
- votre outil répond que cette adresse n'existe plus.
Un message en indique la raison sur la page de l'endpoint. Corrigez le problème dans votre outil et cliquez sur Réactiver.
Bon à savoir
- Traitez l'URL et le secret comme un mot de passe. Ne les partagez pas et ne les publiez pas.
- Un endpoint par outil, avec une description claire.
- Une même notification peut arriver deux fois s'il y a eu une nouvelle tentative. Les outils robustes en tiennent compte ; gardez-le en tête si vous utilisez une automatisation simple.
- Les notifications peuvent arriver dans le désordre. Chacune indique l'heure à laquelle l'événement s'est produit.
- Vous voulez seulement interroger vos données depuis ChatGPT ou Claude ? Vous n'avez pas besoin de webhooks : suivez les guides dédiés.