Collega i tuoi strumenti alla pubblicazione con Influence

Usa le API e gli strumenti MCP di Influence per salvare bozze, rivedere i post e programmare le pubblicazioni approvate. Con gli stessi strumenti puoi recuperare gli account collegati e controllare gli esiti di pubblicazione registrati.

Credenziali, approvazione e stato di pubblicazione

Limita l’accesso con credenziali dai permessi definiti

Scegli i permessi necessari al client. Influence verifica l’appartenenza allo spazio di lavoro e l’accesso per ogni operazione. Ogni strumento specifica se serve una conferma. Il server fa rispettare questo requisito.

Approva l’azione di pubblicazione esatta

Controlla account, contenuti, file multimediali e orario prima dell’esecuzione. Una modifica sostanziale richiede una nuova revisione e una nuova approvazione; il lavoro approvato entra nel sistema di programmazione di Influence.

Leggi lo stato di pubblicazione

Usa gli ID restituiti per controllare ogni post. «Programmato» significa che è in attesa di pubblicazione; «Pubblicato» conferma che è stato pubblicato. «Da rivedere» indica un esito incerto da chiarire prima di un altro invio.

Leggi gli account collegati con MCP

Questo esempio Node.js si collega a Influence ed elenca gli account social del tuo spazio di lavoro. Legge i dettagli degli account senza creare bozze né pubblicare post.

1. Crea una chiave con accesso in lettura

Nelle Impostazioni, apri App e automazioni → Strumenti per sviluppatori. Seleziona Leggere i canali collegati (integrations:read), deseleziona tutte le altre autorizzazioni e crea la chiave API. Salva la chiave nel tuo archivio locale dei segreti o nell’ambiente come INFLUENCE_API_TOKEN. La chiave viene mostrata una sola volta; tienila fuori dai file sorgente e dalle chat.

Apri le impostazioni delle chiavi API

2. Esegui l’esempio

Con Node.js e npm installati, installa l’SDK MCP nel tuo progetto. Salva il codice qui sotto come accounts.mjs, poi esegui node accounts.mjs in un ambiente in cui è impostata INFLUENCE_API_TOKEN. L’SDK gestisce il collegamento MCP e l’inizializzazione.

npm install @modelcontextprotocol/client@2.3.1

accounts.mjs

import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";

const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");

const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("https://influence.so/api/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);

try {
  await client.connect(transport);
  const result = await client.callTool({
    name: "accountList",
    arguments: { limit: 20 }
  });
  console.log(JSON.stringify(result.structuredContent, null, 2));
  if (result.isError) process.exitCode = 1;
} finally {
  await client.close();
}

3. Leggi la risposta

Risposta di esempio con nomi e ID di account fittizi. La tua risposta identifica il tuo spazio di lavoro e i suoi account social collegati.

{
  "ok": true,
  "output": {
    "cursor": null,
    "done": true,
    "items": [
      {
        "connectionId": "account_example_01",
        "eligible": true,
        "name": "Example studio",
        "platform": "bluesky",
        "supportsImage": true,
        "supportsText": true,
        "supportsVideo": true
      }
    ],
    "workspaceId": "workspace_example_01",
    "workspaceName": "Example workspace"
  },
  "toolName": "accountList"
}

Cosa significa il risultato

Account restituiti

Usa connectionId per identificare ogni account. Le proprietà eligible, supportsText, supportsImage e supportsVideo descrivono le sue attuali capacità di pubblicazione; ricontrollale prima di preparare un post.

Nessun account restituito

ok: true con items: [] e done: true indica una lettura riuscita. Collega un account social nello spazio di lavoro indicato da workspaceName, poi esegui di nuovo l’esempio.

Più pagine di risultati

Quando done è false, chiama di nuovo accountList con il cursor restituito e lo stesso limit. Continua finché done è true; la prima pagina può contenere meno di 20 account.

Accesso negato

Se ricevi una risposta 401, controlla che la chiave sia ancora valida e abbia accesso integrations:read. Con una chiave API, anche uno scope mancante può causare una risposta 401. Un collegamento OAuth può restituire 403 insufficient_scope: ricollegalo e approva l’accesso in lettura agli account.

ChatGPT e Claude possono collegarsi tramite autorizzazione nel browser anziché con una chiave. Segui la guida di configurazione dell’assistente, poi chiedigli di elencare gli account collegati. L’esempio qui sopra usa l’endpoint MCP completo, https://influence.so/api/mcp; il connettore principale di Claude ha una configurazione dedicata.

Scopri gli strumenti e le autorizzazioni richieste

GET /api/v1/tools elenca gli strumenti disponibili per la tua chiave. Questa richiesta estrae dal catalogo le autorizzazioni e i requisiti di conferma di accountList. Per creare bozze servono ulteriori autorizzazioni di scrittura.

API HTTP

GET /api/v1/tools

La tua applicazione legge il catalogo e chiama gli strumenti disponibili.

MCP

tools/list

Un assistente supportato scopre gli strumenti e segue lo stesso processo di revisione.

Influence
  1. 1. Prepara una bozza

    Chiama campaignDraftSave con account e contenuti multimediali dello spazio di lavoro. Conserva la versione e l’identificativo della richiesta per recuperare una risposta interrotta. Le scritture delle bozze richiedono la conferma del server.

  2. 2. Prepara il riepilogo da approvare

    Chiama campaignReview per la versione salvata e l’azione scelta. Mostra account, contenuto del post, contenuti multimediali, impostazioni, orario e scadenza prima di chiedere l’approvazione.

  3. 3. Esegui l’azione approvata

    campaignReviewExecute richiede l’approvazione di quello specifico riepilogo. Per i post di testo serve una nuova risposta al riepilogo completo; i contenuti multimediali richiedono un’approvazione visiva. Il server inoltra l’azione al sistema di programmazione persistente, anziché chiamare direttamente il provider.

  4. 4. Leggi l’esito prima di riprovare

    Leggi lo stato di ogni account e, se disponibile, il link al post pubblicato. Un invio dall’esito incerto resta nello stato «Da rivedere» finché l’esito non viene chiarito. Recupera la richiesta esistente prima di creare un altro post, per evitare duplicati.

Scegli il collegamento per il tuo strumento

Influence: Scegli il collegamento per il tuo strumento
CollegamentoQuando usarloAccesso
API HTTPLa tua applicazione legge il catalogo e chiama gli strumenti disponibili.Usa una credenziale bearer con ambiti limitati, letta da una variabile d’ambiente.
MCPUn assistente supportato scopre gli strumenti e segue lo stesso processo di revisione.Segui la configurazione dell’assistente nelle Impostazioni di Influence. La disponibilità dipende dall’app che lo ospita e dalle autorizzazioni concesse.

Richiesta del catalogo

curl --fail-with-body 'https://influence.so/api/v1/tools' \
  --header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
  | jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'

Campi di esempio del catalogo

{
  "tools": [
    {
      "confirmation": "none",
      "mutability": "read",
      "name": "accountList",
      "scopes": [
        "integrations:read"
      ]
    }
  ]
}

Questi campi di esempio provengono dalle definizioni degli strumenti. Il catalogo effettivo, gli ambiti delle credenziali e gli account collegati determinano le operazioni disponibili.

Cavi blu collegano un vassoio di schede fotografiche, blocchi, un timbro, un calendario e una busta sigillata.

Flussi di pubblicazione che puoi creare

Post dal tuo flusso di gestione dei contenuti

Prepara bozze da un articolo, un registro delle modifiche o un avviso alla community nei tuoi strumenti. Mostra gli account esatti, i contenuti e l’orario per la revisione prima di chiedere a Influence di programmare la pubblicazione.

Recupera una richiesta dopo una risposta persa

Conserva la richiesta originale e la chiave di idempotenza, poi cercane il risultato. Un invio con esito incerto resta «Da rivedere» finché non puoi confermare cosa è successo. Creare una richiesta sostitutiva potrebbe pubblicare lo stesso post 2 volte.

Ottieni una prima bozza con Influence IQ

Fornisci a Influence IQ un articolo, appunti sul progetto o un aggiornamento per la community insieme alle Linee guida del marchio salvate per ottenere bozze modificabili. Gli strumenti IA disponibili e autorizzati usano crediti IQ e mantengono i rispettivi requisiti di conferma.

Fornisci a Influence IQ i tuoi appunti e le Linee guida del marchio salvate per ottenere post modificabili e date suggerite. La creazione di bozze e la generazione di immagini usano crediti IQ. Prima di iniziare, controlla il costo in crediti proposto per la generazione dell’immagine; prima di pubblicare, controlla il contenuto finito.

Scopri Influence IQ

Inizia con un assistente IA

Con una connessione supportata a Influence, puoi pianificare campagne e rivedere bozze in ChatGPT o Claude. Chiedi all’assistente di caricare immagini e video a cui può accedere oppure di riutilizzare contenuti multimediali già pronti in Influence. Se non può accedere al file, caricalo prima in Influence. Controlla gli account esatti, il testo, i contenuti multimediali, le impostazioni e l’orario. Poi approva in una scheda supportata nella chat oppure con una nuova risposta «approved» dopo aver visto la revisione completa. Per TikTok Direct, indica in chat le tue scelte di pubblicazione ed esprimi il consenso, poi approva la revisione aggiornata. La scheda di revisione è facoltativa. Controlla le Impostazioni per la configurazione e lo stato della connessione.

Pubblica sui tuoi account collegati

Scegli gli account disponibili nel tuo spazio di lavoro. Modifica il testo e i contenuti multimediali supportati per ogni destinazione, poi controlla i post prima di pubblicare.

Prepara i tuoi prossimi post

Aggiungi i tuoi account, prepara i post e scegli le date. Controlla i contenuti prima di programmare la pubblicazione.

Inizia

Domande frequenti

Cosa possono fare i flussi API e MCP?
In base agli strumenti abilitati e ai tuoi permessi, un client API o MCP può gestire account collegati, bozze salvate, contenuti multimediali supportati, revisioni dei post, programmazioni e stato di pubblicazione.
Le chiamate API o MCP aggirano l’approvazione?
No. Il server fa rispettare i requisiti di conferma di ogni strumento. Per pubblicare serve l’approvazione della revisione attuale. Prima di programmare l’invio, l’esecuzione verifica spazio di lavoro, permessi, account e contenuti.
Quali contenuti multimediali accetta il flusso con l’assistente?
Chiedi all’assistente di caricare immagini e video a cui può accedere oppure di riutilizzare contenuti multimediali già pronti in Influence. Se non può accedere al file, caricalo prima in Influence. Controlla gli account esatti, il testo, i contenuti multimediali, le impostazioni e l’orario. Poi approva in una scheda supportata nella chat oppure con una nuova risposta «approved» dopo aver visto la revisione completa. Per TikTok Direct, indica in chat le tue scelte di pubblicazione ed esprimi il consenso, poi approva la revisione aggiornata. La scheda di revisione è facoltativa.
Come gestire una risposta persa o un invio dall’esito incerto?
Recupera il risultato della richiesta originale e controlla lo stato registrato. Non ripetere un invio dall’esito incerto. «Da rivedere» resta irrisolto finché la riconciliazione non ne accerta l’esito.
Il supporto MCP garantisce il funzionamento con ogni app che ospita un assistente?
No. Accedi e apri Impostazioni → App e automazioni → Collega il tuo assistente per verificare le istruzioni di configurazione e lo stato attuale della connessione.
Un’integrazione può modificare un post programmato o pubblicato?
Un post programmato può tornare in bozza per essere modificato e rivisto, se la pubblicazione non è iniziata e non ci sono invii irrisolti. L’assistente non può modificare o eliminare contenuti già pubblicati su una piattaforma.