Vai al contenuto
MarcommAI

Collegare n8n con una chiave API personale

Il nodo della community n8n-nodes-marcomm scrive comunicati stampa, articoli del blog, eventi stampa e inviti RSVP, li manda in approvazione e li pubblica. Il pacchetto non è ancora pubblicato.

  1. 1
    In Marcomm vai su Impostazioni → Integrazioni → n8n per vedere lo stato e i valori che servono.
    Impostazioni, Integrazioni, n8n, con lo stato, i passaggi di collegamento, gli ambiti da selezionare e lo stato dell'accesso all'API
    La pagina di n8n mostra lo stato attuale, i passaggi, i valori da copiare e se l'accesso all'API è approvato per questo workspace.
  2. 2
    Apri Impostazioni → API. Se il workspace non ha ancora l'accesso all'API, un proprietario o un amministratore compila Richiedi l’accesso all’API e seleziona Invia richiesta.
  3. 3
    Dopo l'approvazione apri Crea una chiave, scegli Chiave personale, spunta gli Ambiti che servono e seleziona Crea chiave. Copia subito la chiave, perché viene mostrata una sola volta.
  4. 4
    In n8n Cloud, cerca Marcomm AI nel pannello dei nodi (se non compare, attiva Verified Community Nodes nel pannello di amministrazione e riavvia l'istanza). In un n8n installato sul tuo server, apri Settings (Impostazioni), poi Community Nodes, poi Install (Installa), e inserisci n8n-nodes-marcomm.
  5. 5
    Crea una credenziale Marcomm AI API, incolla la chiave in API Key (chiave API) e aggiungi a un workflow il nodo Marcomm AI o Marcomm AI Trigger.

Il nodo trigger ha bisogno dell'ambito Contenuti e al primo controllo non invia nulla, così non ripropone elementi vecchi.

Il nodo copre comunicati stampa, articoli del blog, eventi stampa, inviti RSVP e approvazioni, compresi approvare, rifiutare e l'elenco delle approvazioni in attesa. Il nodo trigger avvia un workflow quando un comunicato stampa viene creato, mandato in approvazione o pubblicato, quando un articolo del blog viene creato o pubblicato, o quando viene creato un evento stampa.

Gli ambiti stabiliscono cosa può fare una chiave. Contenuti (content) legge comunicati stampa, articoli del blog ed eventi stampa, Scrivere contenuti (content:write) crea e modifica bozze, Pubblicare e inviare (distribution) pubblica e invia per e-mail, e Approvazioni (approvals) copre i passaggi di approvazione. Gli ultimi tre funzionano solo con una Chiave personale, perché l'azione viene registrata a nome di chi ha creato la chiave. Una Chiave del workspace può solo leggere, e ogni chiave agisce con il ruolo e i permessi di chi l'ha creata.

Pubblicare e inviare non si possono annullare. L'API li esegue solo se la richiesta contiene confirm: true o un'intestazione Idempotency-Key, e non pubblica nulla e risponde 409 finché serve un'approvazione o il contenuto è programmato o sotto embargo. Un nuovo tentativo con lo stesso Idempotency-Key e la stessa richiesta restituisce il primo risultato per 24 ore invece di essere eseguito di nuovo. Il nodo invia una chiave di idempotenza a ogni scrittura, costruita da esecuzione, nodo ed elemento, e conferma da solo le operazioni di pubblicazione e invio.

L'API è disponibile dal piano Team in su. Il team di Marcomm AI esamina ogni richiesta, e le chiavi funzionano solo dopo l'approvazione. Una chiave può usare solo gli ambiti approvati per il workspace, e ogni persona può avere fino a 10 chiavi. Per impostazione predefinita un workspace può fare 60 richieste al minuto e 10.000 al giorno; oltre, l'API risponde 429 con un'intestazione Retry-After. Per alzare i limiti usa Servono limiti più alti? in Impostazioni → API. Per scollegare n8n seleziona Revoca accanto alla chiave; i sistemi che la usano perdono subito l'accesso.

Domande frequenti

Chiama GET https://marcomm.works/api/v1/me con l'intestazione Authorization: Bearer seguita dalla tua chiave. Funziona con qualsiasi chiave approvata, qualunque siano i suoi ambiti, e restituisce il workspace, il nome della chiave e i suoi ambiti.

Una chiave non registra quale servizio la usa, quindi Marcomm non segna la scheda di n8n come connessa. In Impostazioni → API vedi quando ogni chiave è stata usata l'ultima volta.

Sì, con il nodo integrato HTTP Request. Chiama https://marcomm.works/api/v1 con l'intestazione Authorization: Bearer seguita dalla tua chiave e aggiungi un'intestazione Idempotency-Key a ogni scrittura.

Integrazioni