Vai al contenuto
MarcommAI

Collegare Make con il modulo HTTP

L'app Marcomm AI per Make è in revisione. Finché non viene approvata, chiama l'API di Marcomm AI da uno scenario Make con il modulo HTTP e una chiave API personale.

  1. 1
    In Marcomm vai su Impostazioni → Integrazioni → Make per vedere lo stato e i valori che servono.
    Impostazioni, Integrazioni, Make, con lo stato, i passaggi di collegamento, gli ambiti da selezionare e lo stato dell'accesso all'API
    La pagina di Make 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 uno scenario Make aggiungi il modulo HTTP e scegli Make a request.
  5. 5
    Inserisci un endpoint della documentazione per sviluppatori dopo https://marcomm.works/api/v1 e aggiungi l'intestazione Authorization con Bearer seguito dalla tua chiave.

Inizia con GET /me per verificare la chiave prima di costruire il resto dello scenario.

L'app Marcomm AI per Make è in revisione e non si può ancora aggiungere. Una volta approvata, il suo modulo Make an API call chiamerà qualsiasi endpoint del riferimento API con la stessa chiave personale. Fino ad allora il modulo HTTP fa lo stesso lavoro. Gli eventi di Marcomm AI possono anche andare a un indirizzo webhook di Make che aggiungi nella scheda Webhook di Impostazioni → API.

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. Nel modulo HTTP aggiungi tu l'intestazione Idempotency-Key a ogni richiesta di scrittura.

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

Inserisci https://marcomm.works/api/v1 seguito da un percorso della documentazione per sviluppatori, per esempio /press-releases per l'elenco dei comunicati stampa.

Integrazioni