Outils pour développeurs
Make dans votre produit et vos agents IA, via une API
Le toolkit Make couvre les organisations, équipes, scénarios, journaux d'exécution et exécutions incomplètes d'une zone Make. Votre client se connecte une fois avec une API key, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke l'identifiant et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/make_activate_scenario/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"scenarioId": 1
}
}Fonctionnement
Du client connecté au premier appel à Make.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Make. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Make.
Déclencher des automatisations depuis votre produit
Lancez le scénario d'un client quand un événement survient dans votre SaaS et attendez le statut et les sorties avec responsive true.
Piloter les scénarios depuis une page de réglages
Affichez les scénarios d'un client, renommez-les et activez-les ou désactivez-les, pour que l'utilisateur gère ses automatisations sans ouvrir Make.
Reprise des exécutions en échec par un agent
Laissez un agent IA lister les journaux et les exécutions incomplètes d'un scénario, lire l'erreur et le module en cause et relancer l'exécution.
Tools
12 tools Make
- Lister les organisationsGETListe les organisations de l'utilisateur, chacune avec id et name. L'id est l'organizationId que demandent les autres outils.
- Lister les équipesGETListe les équipes d'une organisation, chacune avec id et name. L'id est le teamId de List scenarios.
- Lister les scénariosGETListe les scénarios d'une équipe ou de toute une organisation : envoyez teamId ou organizationId, jamais les deux. Chaque élément contient l'id et le name du scénario.
- Obtenir un scénarioGETRenvoie les détails d'un scénario, comme son nom, son équipe, sa planification et s'il est actif.
- Mettre à jour un scénarioPATCHRenomme un scénario. Le nom n'a pas besoin d'être unique.
- Activer un scénarioPOSTActive un scénario pour qu'il s'exécute selon sa planification. Un scénario planifié à intervalles réguliers s'exécute aussi tout de suite.
- Désactiver un scénarioPOSTDésactive un scénario, ce qui arrête sa planification et l'exécution en cours, s'il y en a une.
- Exécuter un scénarioPOSTExécute un scénario actif maintenant, ce qui consomme des opérations de l'organisation. Renvoie l'executionId ; avec responsive true il attend jusqu'à 40 secondes et renvoie aussi le statut et les sorties du scénario. Une organisation ou équipe en pause répond 429 avec le code IM310.
- Lister les journaux d'un scénarioGETListe les journaux d'exécution d'un scénario, du plus récent au plus ancien, chacun avec l'id de l'exécution, le statut, la durée, les opérations et le transfert.
- Obtenir une exécution de scénarioGETRenvoie le statut d'une exécution d'un scénario, avec les sorties du scénario, ou l'erreur et le module qui l'a causée.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
À la connexion, votre client indique aussi {zone} : l'adresse de son compte sur l'API de l'app.
Questions sur le toolkit Make
Dois-je intégrer l'API Make moi-même ?
Non. Connect fournit 12 tools Make décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Make ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
