Naar inhoud springen

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.

  1. 1
    Vraag in Marcomm API-toegang aan via Instellingen → API. Sleutels werken zodra het Marcomm AI-team de aanvraag heeft beoordeeld en goedgekeurd.
  2. 2
    Maak 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.
  3. 3
    n8n: installeer de communitynode n8n-nodes-marcomm via Settings → Community Nodes → Install, maak een Marcomm AI API-referentie aan en plak je sleutel.
  4. 4
    Zapier: 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.
  5. 5
    Make: onze eigen app wordt nog beoordeeld, dus gebruik Make a request van de HTTP-module. Voeg een endpoint toe na https://marcomm.works/api/v1 en voeg de header Authorization: Bearer YOUR_API_KEY toe.
  6. 6
    Power Automate: vul in Custom connectors → New custom connector → Import an OpenAPI from URL het adres https://marcomm.works/api/v1/openapi.json in. Stel de beveiliging in op API-sleutel, de parameternaam op Authorization en de locatie op Header, en vul bij het verbinden Bearer in, gevolgd door je sleutel.
  7. 7
    Test 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.

AI-tools