Connecter Marcomm à n8n, Zapier, Make et Power Automate
Les outils d'automatisation appellent l'API de Marcomm avec une clé API personnelle pour créer des communiqués, des articles de blog, des événements presse et des invitations RSVP, puis demander la validation, publier et envoyer.
- 1Dans Marcomm, demandez l'accès à l'API dans Paramètres → API. Les clés fonctionnent une fois que l'équipe Marcomm AI a examiné et approuvé la demande.
- 2Une fois la demande approuvée, créez une clé personnelle sur le même écran et cochez les portées nécessaires (
content,content:write,distribution,approvals). La clé ne s'affiche qu'une seule fois, à sa création. - 3n8n : installez le nœud communautaire
n8n-nodes-marcommdepuis Settings → Community Nodes → Install, créez un identifiant d'API Marcomm AI et collez votre clé. - 4Zapier : l'application Marcomm AI n'est pas encore dans l'annuaire public, ajoutez-la donc avec un lien d'invitation. Choisissez Marcomm AI dans un Zap et collez votre clé quand la connexion est demandée.
- 5Make : notre propre application est en cours d'examen, utilisez donc Make a request du module HTTP. Ajoutez un point de terminaison après
https://marcomm.works/api/v1et ajoutez l'en-têteAuthorization: Bearer YOUR_API_KEY. - 6Power Automate : dans
Custom connectors → New custom connector → Import an OpenAPI from URL, saisissezhttps://marcomm.works/api/v1/openapi.json. Réglez la sécurité sur clé API, le nom du paramètre sur Authorization et l'emplacement surHeader, puis saisissezBearersuivi de votre clé lors de la connexion. - 7Testez d'abord les étapes de lecture, et essayez la publication et l'envoi sur un brouillon avant de vous y fier.
La publication et l'envoi sont irréversibles. Seules les clés personnelles peuvent écrire, envoyer et valider, et ces actions sont consignées au nom de la personne qui a créé la clé.
Les outils d'automatisation agissent avec le nom et les autorisations de la personne qui a créé la clé. Ils ne peuvent faire que ce que le rôle de cette personne dans l'espace de travail permet, et les règles de validation et d'envoi ainsi que la limite d'envoi mensuelle s'appliquent comme dans l'application.
Chaque espace de travail a des limites d'appels par minute et par jour. Au-delà d'une limite, la réponse vous invite à réessayer un peu plus tard. Consultez vos limites et votre utilisation dans Paramètres → API.
Les applications n8n et Zapier ajoutent une clé unique à chaque requête pour qu'une requête répétée ne s'exécute qu'une fois. Si vous appelez l'API vous-même depuis Make ou Power Automate, ajoutez l'en-tête Idempotency-Key pour bénéficier de la même protection.
Connecter des outils d'automatisation ne consomme pas de crédits d'IA Marcomm. L'écriture et l'envoi n'utilisent pas d'IA.
FAQ
Vérifiez que votre demande d'accès à l'API est approuvée, que les portées de la clé incluent l'action et que la clé n'a pas expiré. Les clés ne fonctionnent pas tant que l'espace de travail est suspendu pour un problème de paiement.
Non. Seules les clés personnelles peuvent écrire, envoyer et valider, pour que l'historique indique qui a agi.