Power Automate verbinden met een aangepaste connector
Importeer de connector van Marcomm AI vanuit het OpenAPI-bestand in uw Power Automate-omgeving en voer daarna acties van Marcomm AI uit in uw flows met een persoonlijke API-sleutel.
- 1Ga in Marcomm naar Instellingen → Integraties → Power Automate om de status en de benodigde waarden te zien.

De pagina van Power Automate 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 in Power Automate Custom connectors, kies New custom connector, dan Import an OpenAPI from URL, en vul
https://marcomm.works/api/v1/openapi.jsonin. - 5Kies in de stap Security (Beveiliging) API Key, stel de parameternaam in op
Authorizationen de locatie op Header, en maak de connector. - 6Vraagt een flow om een verbinding, vul dan
Bearer, een spatie en uw sleutel in.
Test publiceer- en verzendstappen eerst met een concept, want ze zijn onomkeerbaar.
De connector staat niet in de connectorlijst van Microsoft. U importeert hem vanuit het OpenAPI-bestand in uw eigen omgeving, dus de acties volgen de API: nieuws en goedkeuringen lezen, persberichten, blogberichten, persevenementen en RSVP-uitnodigingen maken en bijwerken, goedkeuring aanvragen, goedkeuren of afwijzen, en publiceren en versturen. Hij heeft alleen acties, geen triggers.
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. In de connector hebben deze acties een veld confirm en een veld Idempotency-Key.
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 Power Automate 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 Power Automate niet als verbonden. In Instellingen → API ziet u wanneer elke sleutel voor het laatst is gebruikt.
Niet met deze connector, want die heeft alleen acties. Start de flow met een andere trigger, zoals een planning, en lees de nieuwste items met een lijstactie.