Vai al contenuto
MarcommAI

Collegare Zapier con una chiave API personale

Con l'app Marcomm AI per Zapier avvii Zap da comunicati stampa, articoli del blog ed eventi stampa, e li crei, pubblichi e invii. L'app è disponibile su invito.

  1. 1
    In Marcomm vai su Impostazioni → Integrazioni → Zapier per vedere lo stato e i valori che servono.
    Impostazioni, Integrazioni, Zapier, con lo stato, i passaggi di collegamento, gli ambiti da selezionare e lo stato dell'accesso all'API
    La pagina di Zapier 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
    Apri il link di invito ricevuto da Marcomm AI e aggiungi l'app Marcomm AI al tuo account Zapier.
  5. 5
    Crea uno Zap, scegli Marcomm AI come trigger o azione e incolla la chiave in API Key (chiave API) quando Zapier chiede il collegamento.

Prova prima i passaggi di pubblicazione e invio con una bozza, perché non si possono annullare.

L'app non è ancora nella directory pubblica di Zapier, quindi ti serve un link di invito da Marcomm AI. Ha sette trigger: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event e RSVP Invite Updated. Le sue azioni creano, aggiornano, mandano in approvazione, pubblicano e inviano comunicati stampa, creano e pubblicano articoli del blog, creano eventi stampa, e creano, completano e inviano inviti RSVP. Due ricerche trovano un comunicato stampa o un articolo del blog.

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. Ogni passaggio di scrittura invia una chiave di idempotenza costruita dallo Zap e dai suoi dati. Se uno Zap deve ripetere di proposito lo stesso identico passaggio entro 24 ore, inserisci in Repeat Key un valore che cambia a ogni esecuzione.

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 Zapier 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 Zapier come connessa. In Impostazioni → API vedi quando ogni chiave è stata usata l'ultima volta.

No. L'app Zapier può richiedere l'approvazione, e chi approva decide in Marcomm. Con l'API, una chiave personale con l'ambito Approvazioni può approvare o rifiutare.

Integrazioni