Page Intégrations

Adresse : https://botillon.fr/integrations

La page Intégrations explique comment connecter un service partenaire à un bot Botillon. Elle s’adresse aux développeurs qui veulent recevoir les événements vote, like et commentaire, et aux propriétaires de bots qui activent une intégration.

Fonctionnement

1. Le propriétaire clique sur Connecter dans l’onglet Outils du bot.
2. Botillon crée une connexion et un secret whs_….
3. Botillon envoie integration.create à l’URL de configuration du service.
4. Le service renvoie ses informations.
5. Les événements sont livrés à l’endpoint, signés en HMAC SHA-256.

Événements

• vote.create
• like.create
• comment.create
• webhook.test

Sécurité

Vérifiez la signature avec le secret de connexion. Utilisez HTTPS. Ne stockez pas le secret en clair. Une connexion peut être révoquée depuis l’espace projet.

Devenir partenaire

Envoyez une documentation technique, une URL de configuration, une URL d’événement et un contact à [email protected]. L’équipe vérifie le service avant de l’ajouter à la liste approuvée.

Signature et test

Chaque livraison contient une signature HMAC SHA-256 calculée avec le secret whs_…. Vérifiez la signature avant de traiter l’événement. Le bouton Tester envoie webhook.test pour valider la connexion sans attendre un vrai vote.

Révocation

Une connexion peut être retirée depuis l’onglet Outils du bot. Le service doit alors cesser d’envoyer des événements et supprimer le secret. Une connexion révoquée ne reçoit plus rien.

Voir aussi

• Guide : Outils et API
• Webhooks de votes et likes
• Documentation API
• Partenaires