Conectează-ți instrumentele la publicarea din Influence

Folosește API-ul și instrumentele MCP Influence pentru a salva ciorne, a verifica postări și a programa publicarea aprobată. Preia conturile conectate și verifică rezultatele înregistrate ale publicării prin aceleași instrumente.

Date de autentificare, aprobare și starea livrării

Limitează accesul prin date de autentificare cu permisiuni definite

Alege permisiunile de care are nevoie un client. Influence verifică apartenența la spațiul de lucru și accesul pentru fiecare operațiune. Fiecare instrument precizează dacă este necesară confirmarea. Serverul impune această cerință.

Aprobă exact acțiunea de publicare

Verifică conturile, conținutul, materialele media și ora înainte de execuție. O modificare importantă necesită o nouă verificare și o aprobare nouă; acțiunile aprobate intră în planificatorul Influence.

Consultă starea livrării

Folosește identificatorii returnați pentru a verifica fiecare postare. „Programată” înseamnă că așteaptă livrarea; „Publicată” confirmă că a fost publicată. „Necesită verificare” înseamnă că rezultatul este incert și trebuie clarificat înainte de o nouă trimitere.

Citește conturile conectate prin MCP

Acest exemplu Node.js se conectează la Influence și listează conturile de pe rețelele sociale din spațiul tău de lucru. Citește detaliile conturilor fără să creeze o ciornă sau să publice o postare.

1. Creează o cheie cu acces de citire

În „Setări”, deschide Aplicații și automatizări → Instrumente pentru dezvoltatori. Selectează Citește canalele conectate (integrations:read), debifează toate celelalte permisiuni, apoi creează cheia API. Salvează cheia în depozitul local de secrete sau într-o variabilă de mediu, sub numele INFLUENCE_API_TOKEN. Cheia este afișată o singură dată; nu o include în fișierele sursă sau în conversații.

Deschide setările pentru cheia API

2. Rulează exemplul

Cu Node.js și npm instalate, instalează SDK-ul MCP în proiectul tău. Salvează codul de mai jos ca accounts.mjs, apoi rulează node accounts.mjs într-un mediu în care este setat INFLUENCE_API_TOKEN. SDK-ul gestionează conexiunea MCP și inițializarea.

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. Citește răspunsul

Exemplu de răspuns cu nume și ID-uri fictive de conturi. Răspunsul tău identifică spațiul tău de lucru și conturile de pe rețelele sociale conectate la el.

{
  "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"
}

Ce înseamnă rezultatul

Conturi returnate

Folosește connectionId pentru a identifica fiecare cont. eligible, supportsText, supportsImage și supportsVideo descriu capabilitățile sale actuale de publicare; verifică-le din nou înainte să pregătești o postare.

Niciun cont returnat

ok: true cu items: [] și done: true indică o citire reușită. Conectează un cont de pe o rețea socială în spațiul de lucru indicat de workspaceName, apoi rulează din nou exemplul.

Mai multe pagini de rezultate

Când done este false, apelează din nou accountList cu valoarea cursor returnată și aceeași valoare limit. Continuă până când done este true; prima pagină poate conține mai puțin de 20 de conturi.

Acces refuzat

Pentru un răspuns 401, verifică dacă cheia este valabilă și are acces integrations:read. Cu o cheie API, lipsa unei permisiuni poate returna tot 401. O conexiune OAuth poate returna 403 insufficient_scope; reconectează-te și aprobă accesul de citire a conturilor.

ChatGPT și Claude se pot conecta prin autorizare în browser, în locul unei chei. Urmează ghidul de configurare al asistentului, apoi cere-i să listeze conturile conectate. Exemplul de mai sus folosește endpointul MCP complet, https://influence.so/api/mcp; conectorul de bază pentru Claude are propria configurare.

Descoperă instrumentele și permisiunile necesare

GET /api/v1/tools listează instrumentele disponibile pentru cheia ta. Această cerere selectează permisiunile și cerințele de confirmare pentru accountList. Crearea ciornelor necesită permisiuni suplimentare de scriere.

API HTTP

GET /api/v1/tools

Aplicația ta citește catalogul și apelează instrumentele disponibile.

MCP

tools/list

Un asistent compatibil descoperă instrumentele și urmează același proces de verificare.

Influence
  1. 1. Pregătește o ciornă

    Apelează campaignDraftSave cu conturi și fișiere media din spațiul de lucru. Păstrează versiunea și datele de identificare ale cererii ca să poți recupera un răspuns întrerupt. Scrierea ciornelor necesită confirmare din partea serverului.

  2. 2. Pregătește verificarea

    Apelează campaignReview pentru versiunea salvată și acțiunea aleasă. Arată conturile, conținutul, fișierele media, setările, ora și momentul expirării înainte să ceri aprobarea.

  3. 3. Execută acțiunea aprobată

    Pentru campaignReviewExecute, trebuie aprobată exact verificarea respectivă. Pentru postările text este necesar un răspuns nou la prezentarea completă pentru aprobare; pentru fișierele media este necesară aprobarea vizuală. Serverul trimite acțiunea către sistemul persistent de programare a publicării, în loc să apeleze direct furnizorul.

  4. 4. Citește rezultatul înainte să încerci din nou

    Citește starea fiecărui cont și linkul către postarea publicată, când este disponibil. O trimitere cu rezultat incert rămâne în starea „Necesită verificare” până la clarificarea rezultatului. Recuperează cererea existentă înainte să creezi altă postare, altfel riști să trimiți o dublură.

Alege conexiunea pentru instrumentul tău

Influence: Alege conexiunea pentru instrumentul tău
ConexiuneLa ce o foloseștiAcces
API HTTPAplicația ta citește catalogul și apelează instrumentele disponibile.Folosește date de autentificare de tip Bearer cu permisiuni limitate, dintr-o variabilă de mediu.
MCPUn asistent compatibil descoperă instrumentele și urmează același proces de verificare.Urmează configurarea pentru asistent din „Setări” în Influence. Disponibilitatea depinde de aplicația gazdă și de permisiunile acordate.

Cerere pentru catalog

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}]}'

Exemple de câmpuri din catalog

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

Aceste câmpuri de exemplu provin din definițiile instrumentelor. Catalogul curent, permisiunile asociate datelor de autentificare și conturile conectate determină operațiunile disponibile.

Cabluri albastre conectează o tavă cu fotografii, blocuri, o ștampilă, un calendar și un plic sigilat.

Fluxuri de publicare pe care le poți construi

Postări din propriul flux de lucru cu conținutul

Pregătește ciorne dintr-un articol, jurnal de modificări sau anunț pentru comunitate, folosind propriile instrumente. Arată conturile, conținutul și ora exacte pentru verificare înainte să ceri ca Influence să programeze publicarea.

Recuperează o cerere după pierderea răspunsului

Păstrează cererea inițială și cheia de idempotență, apoi caută rezultatul ei. O trimitere cu rezultat incert rămâne în starea „Necesită verificare” până când poți confirma ce s-a întâmplat. Crearea unei cereri înlocuitoare ar putea publica aceeași postare de 2 ori.

Obține o primă ciornă cu Influence IQ

Oferă-i lui Influence IQ un articol, notițe despre proiect sau noutăți pentru comunitate și Regulile de brand salvate pentru ciorne editabile. Instrumentele AI disponibile și autorizate folosesc credite IQ și își păstrează cerințele de confirmare.

Oferă-i lui Influence IQ notițele și Regulile de brand salvate pentru postări editabile și date sugerate. Redactarea ciornelor și generarea imaginilor consumă credite IQ. Verifică oferta de preț pentru generarea imaginilor înainte să începi și conținutul final înainte să publici.

Explorează Influence IQ

Începe cu un asistent AI

Cu o conexiune Influence compatibilă, poți planifica campanii și revizui ciorne în ChatGPT sau Claude. Cere-i asistentului să încarce imagini și videoclipuri la care are acces sau să reutilizeze materiale media pregătite în Influence. Dacă nu are acces la fișier, încarcă-l mai întâi în Influence. Verifică exact conturile, textul, materialele media, setările și ora. Aprobă apoi într-un card compatibil din conversație sau printr-un răspuns nou „aprobat”, după ce ai văzut verificarea completă. Pentru TikTok Direct, precizează în conversație opțiunile de publicare și exprimă-ți consimțământul, apoi aprobă verificarea actualizată. Cardul de verificare este opțional. Consultă Setări pentru configurare și starea conexiunii.

Publică în conturile conectate

Alege conturi disponibile în spațiul de lucru. Editează textul și materialele media compatibile pentru fiecare destinație, apoi verifică postările înainte să publici.

Pregătește următoarele postări

Adaugă conturile, pregătește postările și alege-le datele. Verifică conținutul înainte să programezi publicarea.

Începe

Întrebări frecvente

Ce poate face un flux de lucru cu API și MCP?
În funcție de instrumentele activate și de permisiunile tale, un client API sau MCP poate lucra cu conturi conectate, ciorne salvate, materiale media compatibile, verificări de postări, programări și starea livrării.
Apelurile API sau MCP ocolesc aprobarea?
Nu. Serverul impune cerințele de confirmare ale fiecărui instrument. Publicarea necesită aprobarea verificării actuale. Înainte să programeze livrarea, execuția verifică spațiul de lucru, permisiunile, conturile și conținutul.
Ce materiale media acceptă fluxul de lucru cu asistentul?
Cere-i asistentului să încarce imagini și videoclipuri la care are acces sau să reutilizeze materiale media pregătite în Influence. Dacă nu are acces la fișier, încarcă-l mai întâi în Influence. Verifică exact conturile, textul, materialele media, setările și ora. Aprobă apoi într-un card compatibil din conversație sau printr-un răspuns nou „aprobat”, după ce ai văzut verificarea completă. Pentru TikTok Direct, precizează în conversație opțiunile de publicare și exprimă-ți consimțământul, apoi aprobă verificarea actualizată. Cardul de verificare este opțional.
Cum gestionezi un răspuns pierdut sau o trimitere incertă?
Recuperează rezultatul cererii inițiale și verifică starea înregistrată. Nu repeta o trimitere cu rezultat neclar. Starea „Necesită verificare” rămâne nerezolvată până când reconcilierea confirmă rezultatul.
Suportul MCP garantează funcționarea în orice aplicație care găzduiește asistentul?
Nu. Autentifică-te și deschide Setări → Aplicații și automatizări → Conectează-ți asistentul pentru instrucțiunile de configurare și starea actuală a conexiunii.
Poate o integrare să editeze o postare programată sau publicată?
O postare programată poate reveni la starea de ciornă pentru editare și o nouă verificare, dacă livrarea nu a început și nu există o trimitere nerezolvată. Asistentul nu poate edita sau șterge conținut deja publicat pe o rețea.