Aller au contenu
MarcommAI

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.

  1. 1
    Dans 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.
  2. 2
    Une 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.
  3. 3
    n8n : installez le nœud communautaire n8n-nodes-marcomm depuis Settings → Community Nodes → Install, créez un identifiant d'API Marcomm AI et collez votre clé.
  4. 4
    Zapier : 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.
  5. 5
    Make : 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/v1 et ajoutez l'en-tête Authorization: Bearer YOUR_API_KEY.
  6. 6
    Power Automate : dans Custom connectors → New custom connector → Import an OpenAPI from URL, saisissez https://marcomm.works/api/v1/openapi.json. Réglez la sécurité sur clé API, le nom du paramètre sur Authorization et l'emplacement sur Header, puis saisissez Bearer suivi de votre clé lors de la connexion.
  7. 7
    Testez 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.

Outils d'IA