Marcomm verbinden met n8n, Zapier, Make en Power Automate
Automatiseringstools roepen de Marcomm-API aan met een persoonlijke API-sleutel om persberichten, blogberichten, persevenementen en RSVP-uitnodigingen te maken, en vragen daarna goedkeuring aan, publiceren en versturen.
- 1Vraag in Marcomm API-toegang aan via Instellingen → API. Sleutels werken zodra het Marcomm AI-team de aanvraag heeft beoordeeld en goedgekeurd.
- 2Maak na de goedkeuring op hetzelfde scherm een persoonlijke sleutel en vink de scopes aan die je nodig hebt (
content,content:write,distribution,approvals). De sleutel wordt maar één keer getoond, wanneer je hem maakt. - 3n8n: installeer de communitynode
n8n-nodes-marcommvia Settings → Community Nodes → Install, maak een Marcomm AI API-referentie aan en plak je sleutel. - 4Zapier: de Marcomm AI-app staat nog niet in de openbare lijst, dus voeg hem toe met een uitnodigingslink. Kies Marcomm AI in een Zap en plak je sleutel wanneer om de verbinding wordt gevraagd.
- 5Make: onze eigen app wordt nog beoordeeld, dus gebruik Make a request van de HTTP-module. Voeg een endpoint toe na
https://marcomm.works/api/v1en voeg de headerAuthorization: Bearer YOUR_API_KEYtoe. - 6Power Automate: vul in
Custom connectors → New custom connector → Import an OpenAPI from URLhet adreshttps://marcomm.works/api/v1/openapi.jsonin. Stel de beveiliging in op API-sleutel, de parameternaam op Authorization en de locatie opHeader, en vul bij het verbindenBearerin, gevolgd door je sleutel. - 7Test eerst de leesstappen, en probeer publiceren en versturen uit op een concept voordat je erop vertrouwt.
Publiceren en versturen kun je niet ongedaan maken. Alleen persoonlijke sleutels kunnen schrijven, versturen en goedkeuren, en die acties worden vastgelegd op naam van de persoon die de sleutel heeft gemaakt.
Automatiseringstools handelen met de naam en de rechten van de persoon die de sleutel heeft gemaakt. Ze kunnen alleen wat de rol van die persoon in de workspace toestaat, en de regels voor goedkeuring en verzending en het maandelijkse verzendlimiet gelden net als in de app.
Elke workspace heeft limieten voor aanroepen per minuut en per dag. Boven een limiet vraagt het antwoord je het zo dadelijk opnieuw te proberen. Je limieten en verbruik zie je via Instellingen → API.
De apps voor n8n en Zapier voegen aan elk verzoek een unieke sleutel toe, zodat een herhaald verzoek maar één keer wordt uitgevoerd. Roep je de API zelf aan vanuit Make of Power Automate, voeg dan de header Idempotency-Key toe voor dezelfde bescherming.
Het verbinden van automatiseringstools verbruikt geen AI-tegoed van Marcomm. Schrijven en versturen gebruiken geen AI.
Veelgestelde vragen
Controleer of je aanvraag voor API-toegang is goedgekeurd, of de scopes van de sleutel de actie bevatten en of de sleutel niet is verlopen. Sleutels werken niet zolang de workspace is opgeschort door een betalingsprobleem.
Nee. Alleen persoonlijke sleutels kunnen schrijven, versturen en goedkeuren, zodat in het logboek staat wie het heeft gedaan.