Connecter Make avec le module HTTP
L'app Marcomm AI pour Make est en cours d'examen. En attendant, appelez l'API de Marcomm AI depuis un scénario Make avec le module HTTP et une clé d'API personnelle.
- 1Dans Marcomm, ouvrez Paramètres → Intégrations → Make pour voir l'état et les valeurs nécessaires.

La page Make affiche l'état actuel, les étapes, les valeurs à copier et indique si l'accès à l'API est approuvé pour cet espace de travail. - 2Ouvrez Paramètres → API. Si l'espace de travail n'a pas encore d'accès à l'API, un propriétaire ou un admin remplit Demander l'accès à l'API et sélectionne Envoyer la demande.
- 3Après l'approbation, ouvrez Créer une clé, choisissez Clé personnelle, cochez les Portées nécessaires et sélectionnez Créer la clé. Copiez la clé tout de suite, elle n'est affichée qu'une fois.
- 4Dans un scénario Make, ajoutez le module HTTP et choisissez Make a request.
- 5Saisissez un endpoint de la documentation développeur après
https://marcomm.works/api/v1, et ajoutez l'en-têteAuthorizationavecBearersuivi de votre clé.
Commencez par GET /me pour vérifier la clé avant de construire le reste du scénario.
L'app Marcomm AI pour Make est en cours d'examen et ne peut pas encore être ajoutée. Une fois approuvée, son module Make an API call appellera n'importe quel endpoint de la référence de l'API avec la même clé personnelle. D'ici là, le module HTTP fait le même travail. Les événements de Marcomm AI peuvent aussi être envoyés à une adresse webhook Make ajoutée dans l'onglet Webhooks de Paramètres → API.
Les portées définissent ce qu'une clé peut faire. Contenu (content) lit les communiqués de presse, les articles de blog et les événements presse, Écrire du contenu (content:write) crée et modifie des brouillons, Publier et envoyer (distribution) publie et envoie par e-mail, et Validations (approvals) couvre les étapes de validation. Les trois dernières ne fonctionnent qu'avec une Clé personnelle, car l'action est enregistrée au nom de la personne qui a créé la clé. Une Clé d'espace de travail ne fait que lire, et chaque clé agit avec le rôle et les droits de la personne qui l'a créée.
La publication et l'envoi sont irréversibles. L'API ne les exécute que si la requête contient confirm: true ou un en-tête Idempotency-Key, et elle ne publie rien et répond 409 tant qu'une validation est requise ou que le contenu est programmé ou sous embargo. Une nouvelle tentative avec le même Idempotency-Key et la même requête renvoie le premier résultat pendant 24 heures au lieu de s'exécuter à nouveau. Dans le module HTTP, ajoutez vous-même l'en-tête Idempotency-Key à chaque requête d'écriture.
L'API est disponible à partir du forfait Team. L'équipe de Marcomm AI examine chaque demande, et les clés ne fonctionnent qu'après l'approbation. Une clé ne peut utiliser que les portées approuvées pour l'espace de travail, et chaque personne peut avoir jusqu'à 10 clés. Par défaut, un espace de travail peut faire 60 requêtes par minute et 10 000 par jour ; au-delà, l'API répond 429 avec un en-tête Retry-After. Pour relever les limites, utilisez Besoin de limites plus élevées ? dans Paramètres → API. Pour déconnecter Make, sélectionnez Révoquer à côté de la clé ; les systèmes qui l'utilisent perdent l'accès aussitôt.
FAQ
Appelez
GET https://marcomm.works/api/v1/meavec l'en-têteAuthorization: Bearersuivi de votre clé. Cela fonctionne avec toute clé approuvée, quelles que soient ses portées, et renvoie l'espace de travail, le nom de la clé et ses portées.Une clé n'enregistre pas le service qui l'utilise, donc Marcomm ne marque pas la carte Make comme connectée. Paramètres → API indique quand chaque clé a été utilisée pour la dernière fois.
Saisissez
https://marcomm.works/api/v1suivi d'un chemin de la documentation développeur, par exemple/press-releasespour lister les communiqués de presse.