Mateflow connecte votre communauté à d'autres outils de trois façons : les applications connectées (Slack, Discord et Zapier), les webhooks vers votre propre serveur et l'Open API pour les développeurs. Les trois se trouvent sur une seule page d'administration, Admin → Paramètres → Intégrations.
Qui peut le faire : Les propriétaires et les administrateurs. · Où : Sur le web (console d'administration). · Offre : Les webhooks, l'accès à l'API et la limite quotidienne de requêtes API dépendent de votre offre de la plateforme.
Où trouver les intégrations dans la console d'administration
Accédez à Admin → Paramètres → Intégrations. La page s'intitule Intégrations & API et comporte quatre onglets :
| Onglet | Ce que vous y faites |
|---|---|
| Intégrations | Connecter Slack, Discord ou Zapier sous Applications connectées |
| Webhooks | Envoyer les événements de la communauté à votre propre point de terminaison |
| Accès API | Créer et révoquer des clés API, et ouvrir la documentation pour les développeurs |
| Journaux de livraison | Vérifier chaque requête que Mateflow a envoyée à vos webhooks, à vos applications et à vos règles d'automatisation |
Connecter Slack, Discord ou Zapier
Les applications connectées transmettent les événements de la communauté, comme les nouveaux membres, les publications ou les paiements, à un autre service :
- Slack : publie des messages dans un canal via une URL Incoming Webhook.
- Discord : publie des messages dans un canal via une URL de webhook Discord. Il envoie uniquement des messages ; il ne synchronise ni les membres ni les rôles.
- Zapier : envoie les événements à un Catch Hook Zapier, pour qu'un Zap puisse les transmettre à des milliers d'autres applications.
Pour en connecter une, ouvrez l'onglet Intégrations et cliquez sur Connecter Slack, Connecter Discord ou Connecter Zapier. Collez l'URL du webhook fournie par ce service, choisissez les Événements à transmettre, ajoutez si vous le souhaitez une Clé de signature (facultatif), puis cliquez sur Connecter. Cliquez ensuite sur Envoyer un événement de test pour vérifier que les messages arrivent.
Une carte connectée indique les événements qu'elle transmet. Utilisez son menu pour Modifier les paramètres, Envoyer un événement de test ou Déconnecter.
Envoyer des événements à votre propre serveur avec des webhooks
Les webhooks envoient une requête HTTPS à un point de terminaison que vous contrôlez chaque fois qu'un événement choisi se produit, par exemple Membre inscrit, Membre ajouté à un groupe d’accès, Publication créée ou Paiement reçu. Chaque webhook a ses propres événements, une clé de signature facultative et un interrupteur Actif. Les webhooks, ainsi que le nombre que vous pouvez en créer, dépendent de votre offre de la plateforme. Consultez Configurer des webhooks.
Créer votre propre intégration avec l'Open API
L'Open API permet à un développeur de lire et d'écrire les données de votre communauté depuis son propre code : lire les publications, les espaces et les membres, créer des publications, téléverser des médias et inviter des personnes. Chaque clé API appartient à une seule communauté, et vous choisissez ses permissions (scopes) lorsque vous la créez. Les clés API ne se gèrent pas dans le tableau de bord créateur (app.mateflow.com) : sa page Aperçu de la communauté renvoie plutôt vers cette page d'administration.
Les invitations envoyées via l'API peuvent inclure des groupes d'accès, que la personne obtient lorsqu'elle accepte. Consultez Comment fonctionnent les groupes d'accès.
La référence complète de l'API se trouve sur mateflow.com/developers. Dans l'onglet Accès API, cliquez sur Ouvrir la documentation pour y accéder, et envoyez le lien à votre développeur ; il n'a pas besoin de compte dans votre communauté. Consultez Créer une clé API.
Vérifier les requêtes sortantes dans les Journaux de livraison
L'onglet Journaux de livraison liste les requêtes sortantes envoyées par vos webhooks, vos applications connectées et les règles d'automatisation qui utilisent Trigger webhook. Filtrez par Type d'événement, par résultat et par date, et cliquez sur Afficher les détails pour voir la requête et la réponse complètes. Les journaux de livraison sont conservés 30 jours. Les livraisons de webhook qui échouent sont réessayées automatiquement ; il n'existe pas de bouton pour en renvoyer une vous-même.
Les requêtes effectuées avec vos clés API ne sont pas journalisées ici. L'onglet Accès API affiche plutôt la date de Dernière utilisation de chaque clé.
Articles associés
Ce guide vous a-t-il été utile ?