Zapier verbinden met een persoonlijke API-sleutel
Met de Marcomm AI-app voor Zapier start u Zaps vanuit persberichten, blogberichten en persevenementen, en maakt, publiceert en verstuurt u ze. De app is alleen op uitnodiging beschikbaar.
- 1Ga in Marcomm naar Instellingen → Integraties → Zapier om de status en de benodigde waarden te zien.

De pagina van Zapier toont de huidige status, de stappen, de waarden om te kopiëren en of API-toegang voor deze werkruimte is goedgekeurd. - 2Open Instellingen → API. Heeft de werkruimte nog geen API-toegang, dan vult een eigenaar of beheerder API-toegang aanvragen in en kiest Aanvraag indienen.
- 3Open na goedkeuring Sleutel maken, kies Persoonlijke sleutel, vink de nodige Scopes aan en kies Sleutel maken. Kopieer de sleutel meteen, want hij wordt maar één keer getoond.
- 4Open de uitnodigingslink van Marcomm AI en voeg de Marcomm AI-app toe aan uw Zapier-account.
- 5Maak een Zap, kies Marcomm AI als trigger of actie en plak de sleutel bij API Key (API-sleutel) wanneer Zapier om de verbinding vraagt.
Test publiceer- en verzendstappen eerst met een concept, want ze zijn onomkeerbaar.
De app staat nog niet in de openbare Zapier-directory, dus u hebt een uitnodigingslink van Marcomm AI nodig. Hij heeft zeven triggers: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event en RSVP Invite Updated. De acties maken, wijzigen, publiceren en versturen persberichten en vragen er goedkeuring voor aan, maken en publiceren blogberichten, maken persevenementen, en maken, vullen en versturen RSVP-uitnodigingen. Twee zoekacties vinden een persbericht of een blogbericht.
Scopes bepalen wat een sleutel mag. Content (content) leest persberichten, blogberichten en persevenementen, Inhoud schrijven (content:write) maakt en bewerkt concepten, Publiceren en versturen (distribution) publiceert en verstuurt per e-mail, en Goedkeuringen (approvals) dekt goedkeuringsstappen. De laatste drie werken alleen met een Persoonlijke sleutel, omdat de actie wordt vastgelegd op naam van wie de sleutel heeft gemaakt. Een Werkruimtesleutel kan alleen lezen, en elke sleutel werkt met de rol en rechten van wie hem heeft gemaakt.
Publiceren en versturen zijn onomkeerbaar. De API voert ze alleen uit als het verzoek confirm: true of een Idempotency-Key-header bevat, en publiceert niets en antwoordt met 409 zolang goedkeuring nog nodig is of het item gepland of onder embargo is. Een nieuwe poging met dezelfde Idempotency-Key en hetzelfde verzoek geeft 24 uur lang het eerste resultaat terug in plaats van opnieuw te draaien. Elke schrijfstap stuurt een idempotentiesleutel mee die is gemaakt uit de Zap en de invoer. Moet een Zap precies dezelfde stap binnen 24 uur bewust herhalen, vul dan bij Repeat Key een waarde in die bij elke run verandert.
De API is beschikbaar vanaf het Team-abonnement. Het team van Marcomm AI beoordeelt elke aanvraag, en sleutels werken pas na goedkeuring. Een sleutel kan alleen de scopes gebruiken die voor de werkruimte zijn goedgekeurd, en iedereen kan tot 10 sleutels hebben. Standaard kan een werkruimte 60 verzoeken per minuut en 10.000 per dag doen; daarboven antwoordt de API met 429 en een Retry-After-header. Gebruik Hogere limieten nodig? in Instellingen → API om de limieten te verhogen. Kies Intrekken naast de sleutel om Zapier los te koppelen; systemen die hem gebruiken verliezen meteen de toegang.
Veelgestelde vragen
Roep
GET https://marcomm.works/api/v1/meaan met de headerAuthorization: Bearergevolgd door uw sleutel. Dat werkt met elke goedgekeurde sleutel, welke scopes hij ook heeft, en geeft de werkruimte, de naam van de sleutel en de scopes terug.Een sleutel legt niet vast welke dienst hem gebruikt, dus Marcomm markeert de kaart van Zapier niet als verbonden. In Instellingen → API ziet u wanneer elke sleutel voor het laatst is gebruikt.
Nee. De Zapier-app kan goedkeuring aanvragen, en de goedkeurder beslist in Marcomm. Via de API kan een persoonlijke sleutel met de scope Goedkeuringen goedkeuren of afwijzen.