Connecter Zapier avec une clé d'API personnelle
Avec l'app Marcomm AI pour Zapier, lancez des Zaps à partir de communiqués de presse, d'articles de blog et d'événements presse, et créez, publiez et envoyez-les. L'app est accessible sur invitation.
- 1Dans Marcomm, ouvrez Paramètres → Intégrations → Zapier pour voir l'état et les valeurs nécessaires.

La page Zapier 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.
- 4Ouvrez le lien d'invitation reçu de Marcomm AI et ajoutez l'app Marcomm AI à votre compte Zapier.
- 5Créez un Zap, choisissez Marcomm AI comme déclencheur ou comme action, et collez la clé dans API Key (clé d'API) quand Zapier demande la connexion.
Testez d'abord les étapes de publication et d'envoi avec un brouillon, car elles sont irréversibles.
L'app n'est pas encore dans l'annuaire public de Zapier : il vous faut un lien d'invitation de Marcomm AI. Elle propose sept déclencheurs : New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event et RSVP Invite Updated. Ses actions créent, mettent à jour, soumettent à validation, publient et envoient des communiqués de presse, créent et publient des articles de blog, créent des événements presse, et créent, complètent et envoient des invitations RSVP. Deux recherches trouvent un communiqué de presse ou un article de blog.
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. Chaque étape d'écriture envoie une clé d'idempotence construite à partir du Zap et de ses données. Si un Zap doit répéter volontairement exactement la même étape dans les 24 heures, saisissez dans Repeat Key une valeur qui change à chaque exécution.
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 Zapier, 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 Zapier comme connectée. Paramètres → API indique quand chaque clé a été utilisée pour la dernière fois.
Non. L'app Zapier peut demander une validation, et la personne qui valide décide dans Marcomm. Avec l'API, une clé personnelle dotée de la portée Validations peut valider ou refuser.