Vai al contenuto
MarcommAI

Collega Marcomm a n8n, Zapier, Make e Power Automate

Gli strumenti di automazione chiamano l'API di Marcomm con una chiave API personale per creare comunicati, articoli del blog, eventi stampa e inviti RSVP, poi richiedere l'approvazione, pubblicare e inviare.

  1. 1
    In Marcomm, richiedi l'accesso all'API in Impostazioni → API. Le chiavi funzionano dopo che il team di Marcomm AI ha esaminato e approvato la richiesta.
  2. 2
    Dopo l'approvazione, crea una chiave personale nella stessa schermata e seleziona gli ambiti che ti servono (content, content:write, distribution, approvals). La chiave viene mostrata una sola volta, quando la crei.
  3. 3
    n8n: installa il nodo della community n8n-nodes-marcomm da Settings → Community Nodes → Install, crea una credenziale API di Marcomm AI e incolla la tua chiave.
  4. 4
    Zapier: l'app di Marcomm AI non è ancora nella directory pubblica, quindi aggiungila con un link di invito. Scegli Marcomm AI in uno Zap e incolla la tua chiave quando ti viene chiesto di collegarti.
  5. 5
    Make: la nostra app è in revisione, quindi usa Make a request del modulo HTTP. Aggiungi un endpoint dopo https://marcomm.works/api/v1 e aggiungi l'intestazione Authorization: Bearer YOUR_API_KEY.
  6. 6
    Power Automate: in Custom connectors → New custom connector → Import an OpenAPI from URL, inserisci https://marcomm.works/api/v1/openapi.json. Imposta la sicurezza su chiave API, il nome del parametro su Authorization e la posizione su Header, poi al collegamento inserisci Bearer seguito dalla tua chiave.
  7. 7
    Prova prima i passaggi di lettura, e prova la pubblicazione e l'invio su una bozza prima di farci affidamento.

La pubblicazione e l'invio non si possono annullare. Solo le chiavi personali possono scrivere, inviare e approvare, e queste azioni vengono registrate a nome della persona che ha creato la chiave.

Gli strumenti di automazione agiscono con il nome e i permessi della persona che ha creato la chiave. Possono fare solo ciò che il ruolo di quella persona nel workspace consente, e le regole di approvazione e invio e il limite mensile di invii valgono come nell'app.

Ogni workspace ha limiti di chiamate al minuto e al giorno. Superato un limite, la risposta ti chiede di riprovare tra poco. Vedi i tuoi limiti e il tuo utilizzo in Impostazioni → API.

Le app di n8n e Zapier aggiungono una chiave univoca a ogni richiesta, così una richiesta ripetuta viene eseguita una sola volta. Se chiami l'API da solo da Make o Power Automate, aggiungi l'intestazione Idempotency-Key per avere la stessa protezione.

Collegare gli strumenti di automazione non consuma crediti IA di Marcomm. Scrittura e invio non usano l'IA.

Domande frequenti

Verifica che la tua richiesta di accesso all'API sia approvata, che gli ambiti della chiave includano l'azione e che la chiave non sia scaduta. Le chiavi non funzionano mentre il workspace è sospeso per un problema di pagamento.

No. Solo le chiavi personali possono scrivere, inviare e approvare, così il registro mostra chi ha eseguito l'azione.

Strumenti IA