Propojte své nástroje s publikováním v Influence

Pomocí API a nástrojů MCP v Influence ukládejte koncepty, kontrolujte příspěvky a plánujte schválené publikování. Stejnými nástroji získáte seznam připojených účtů a ověříte zaznamenané výsledky publikování.

Přístupové údaje, schválení a stav odeslání

Omezit přístup pomocí přístupových údajů s vymezenými oprávněními

Vyberte oprávnění, která klientská aplikace potřebuje. Influence u každé operace ověřuje vlastnictví pracovního prostoru a přístup. Každý nástroj uvádí, zda vyžaduje potvrzení. Server tento požadavek vynucuje.

Schválit přesnou publikační akci

Před provedením zkontrolujte účty, obsah, média a čas. Podstatná změna vyžaduje novou kontrolu a nové schválení; schválená práce přechází do plánovače Influence.

Zkontrolovat stav odeslání

Pomocí vrácených ID zkontrolujte každý příspěvek. Stav „Naplánováno“ znamená, že čeká na odeslání; „Publikováno“ potvrzuje, že byl publikován. „Vyžaduje kontrolu“ znamená nejistý výsledek, který je nutné vyřešit před dalším odesláním.

Načtěte připojené účty pomocí MCP

Tento příklad v Node.js se připojí k Influence a vypíše účty sociálních sítí ve vašem pracovním prostoru. Načte údaje o účtech, aniž by vytvořil koncept nebo publikoval příspěvek.

1. Vytvořte klíč s oprávněním ke čtení

V Nastavení otevřete Aplikace a automatizace → Nástroje pro vývojáře. Vyberte Číst připojené kanály (integrations:read), zrušte výběr všech ostatních oprávnění a vytvořte klíč API. Uložte jej do místního úložiště tajných údajů nebo do prostředí jako INFLUENCE_API_TOKEN. Klíč se zobrazí jen 1×. Nedávejte jej do zdrojových souborů ani chatů.

Otevřít nastavení klíčů API

2. Spusťte příklad

Pokud máte nainstalované Node.js a npm, nainstalujte do projektu SDK pro MCP. Kód níže uložte jako accounts.mjs a spusťte node accounts.mjs v prostředí s nastavenou proměnnou INFLUENCE_API_TOKEN. SDK zajistí připojení a inicializaci MCP.

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. Přečtěte odpověď

Ukázková odpověď s fiktivními názvy a identifikátory účtů. Vaše odpověď identifikuje váš pracovní prostor a připojené účty sociálních sítí.

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

Co výsledek znamená

Účty byly vráceny

Každý účet identifikujte pomocí connectionId. Pole eligible, supportsText, supportsImage a supportsVideo popisují jeho aktuální možnosti publikování. Před přípravou příspěvku je znovu ověřte.

Nebyly vráceny žádné účty

ok: true spolu s items: [] a done: true znamená úspěšné načtení. V pracovním prostoru uvedeném v workspaceName připojte účet sociální sítě a spusťte příklad znovu.

Výsledky na více stránkách

Pokud má done hodnotu false, zavolejte accountList znovu s vrácenou hodnotou cursor a se stejnou hodnotou limit. Pokračujte, dokud done nebude mít hodnotu true. První stránka může obsahovat méně než 20 účtů.

Přístup odmítnut

Při odpovědi 401 zkontrolujte, zda je klíč aktuální a má oprávnění integrations:read. Chybějící rozsah oprávnění může při použití klíče API také způsobit odpověď 401. Propojení přes OAuth může vrátit 403 insufficient_scope. Navažte propojení znovu a schvalte oprávnění ke čtení účtů.

ChatGPT a Claude se mohou připojit prostřednictvím autorizace v prohlížeči místo klíče. Postupujte podle průvodce nastavením asistenta a pak jej požádejte o výpis připojených účtů. Příklad výše používá úplný koncový bod MCP https://influence.so/api/mcp. Základní konektor Claude má vlastní postup nastavení.

Prozkoumat nástroje a potřebná oprávnění

GET /api/v1/tools vypíše nástroje dostupné vašemu klíči. Tento požadavek vybírá informace o oprávněních a požadavcích na potvrzení pro accountList. Vytváření konceptů vyžaduje další oprávnění k zápisu.

HTTP API

GET /api/v1/tools

Vaše aplikace čte katalog a volá dostupné nástroje.

MCP

tools/list

Podporovaný asistent vyhledá nástroje a postupuje podle stejného procesu kontroly.

Influence
  1. 1. Připravte koncept

    Zavolejte campaignDraftSave s účty a médii z pracovního prostoru. Uchovejte verzi a identitu požadavku pro obnovení po přerušené odpovědi. Zápis konceptů vyžaduje potvrzení serveru.

  2. 2. Připravte přehled ke kontrole

    Pro uloženou verzi a zvolenou akci zavolejte campaignReview. Než požádáte o schválení, zobrazte účty, obsah, média, nastavení, čas a dobu platnosti.

  3. 3. Proveďte schválenou akci

    campaignReviewExecute vyžaduje schválení přesně toho přehledu, který byl předložen ke kontrole. Textové příspěvky potřebují novou odpověď na úplný přehled, média vizuální schválení. Server předá akci plánovači s trvalým uložením, místo aby přímo volal poskytovatele.

  4. 4. Před dalším pokusem přečtěte výsledek

    Přečtěte stav každého účtu a odkaz na publikovaný příspěvek, pokud je dostupný. Nejisté odeslání zůstává ve stavu Vyžaduje kontrolu, dokud se výsledek nevyjasní. Než vytvoříte další příspěvek, obnovte stávající požadavek, jinak můžete odeslat duplicitu.

Vyberte propojení pro svůj nástroj

Influence: Vyberte propojení pro svůj nástroj
PropojeníK čemu sloužíPřístup
HTTP APIVaše aplikace čte katalog a volá dostupné nástroje.Použijte přístupový údaj typu bearer s omezeným rozsahem oprávnění z proměnné prostředí.
MCPPodporovaný asistent vyhledá nástroje a postupuje podle stejného procesu kontroly.Postupujte podle pokynů pro propojení asistenta v Nastavení Influence. Dostupnost závisí na hostitelské aplikaci a udělených oprávněních.

Požadavek na katalog

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

Ukázková pole katalogu

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

Tato ukázková pole pocházejí z definic nástrojů. Dostupné operace určuje aktuální katalog, rozsah oprávnění přístupových údajů a připojené účty.

Modré kabely propojují přihrádku s fotografiemi, kostky, razítko, kalendář a zalepenou obálku.

Publikační postupy, které můžete vytvořit

Příspěvky z vašeho vlastního obsahového procesu

Ve svých nástrojích připravte koncepty z článku, přehledu změn nebo oznámení pro komunitu. Než požádáte Influence o naplánování publikování, ukažte ke kontrole přesné účty, obsah a čas.

Obnovit požadavek po ztrátě odpovědi

Uchovejte původní požadavek a klíč idempotence a vyhledejte jeho výsledek. Odeslání s nejistým výsledkem zůstává ve stavu „Vyžaduje kontrolu“, dokud nepotvrdíte, co se stalo. Vytvoření náhradního požadavku by mohlo publikovat stejný příspěvek dvakrát.

Připravte první koncept s Influence IQ

Předejte Influence IQ článek, poznámky k projektu nebo novinku pro komunitu spolu s uloženými pravidly značky a požádejte o upravitelné koncepty. Dostupné nástroje AI, k jejichž použití máte oprávnění, čerpají kredity IQ a zachovávají své požadavky na potvrzení.

Předejte Influence IQ své poznámky a uložená pravidla značky. Získáte upravitelné příspěvky a návrhy termínů. Tvorba konceptů a generování obrázků využívají kredity IQ. Před zahájením generování zkontrolujte cenovou nabídku a před publikováním hotový obsah.

Zjistit více o Influence IQ

Začněte s asistentem s umělou inteligencí

S podporovaným připojením k Influence můžete plánovat kampaně a upravovat koncepty v ChatGPT nebo Claude. Požádejte asistenta, aby nahrál obrázky a videa, ke kterým má přístup, nebo znovu použil připravená média z Influence. Pokud ke souboru nemá přístup, nejprve ho nahrajte do Influence. Zkontrolujte přesné účty, text, média, nastavení a čas. Poté akci schvalte na podporované kartě v chatu nebo novou odpovědí „schváleno“, až uvidíte úplný přehled ke kontrole. U TikTok Direct zadejte v chatu své volby publikování a souhlas a pak schvalte aktualizovaný přehled. Kontrolní karta je volitelná. Informace o nastavení a stavu připojení najdete v části „Nastavení“.

Publikujte na své připojené účty

Vyberte účty dostupné v pracovním prostoru. Upravte text a podporovaná média pro každý cíl a před publikováním příspěvky zkontrolujte.

Připravte své další příspěvky

Přidejte účty, připravte příspěvky a vyberte jejich termíny. Před naplánováním zkontrolujte obsah.

Začít

Časté dotazy

Co umožňuje postup s API a MCP?
Podle zapnutých nástrojů a vašich oprávnění může klient API nebo MCP pracovat s připojenými účty, uloženými koncepty, podporovanými médii, kontrolami příspěvků, plánováním a stavem odeslání.
Obcházejí volání API nebo MCP schválení?
Ne. Server vynucuje požadavky každého nástroje na potvrzení. Publikování vyžaduje schválení aktuálního přehledu ke kontrole. Před naplánováním odeslání se ověřuje pracovní prostor, oprávnění, účty a obsah.
Jaká média přijímá postup s asistentem?
Požádejte asistenta, aby nahrál obrázky a videa, ke kterým má přístup, nebo znovu použil připravená média z Influence. Pokud k souboru nemá přístup, nejdřív jej nahrajte do Influence. Zkontrolujte přesné účty, text, média, nastavení a čas. Po zobrazení úplného přehledu ke kontrole vše schvalte v podporované kartě v chatu nebo novou odpovědí „schváleno“. U TikTok Direct zadejte v chatu své volby publikování a souhlas a pak schvalte aktualizovaný přehled. Kontrolní karta je volitelná.
Jak postupovat při ztracené odpovědi nebo nejistém výsledku odeslání?
Obnovte výsledek původního požadavku a zkontrolujte zaznamenaný stav. Neopakujte odeslání s nejasným výsledkem. Stav „Vyžaduje kontrolu“ zůstává nevyřešený, dokud ověření a porovnání záznamů nepotvrdí výsledek.
Zaručuje podpora MCP fungování každého hostitele asistenta?
Ne. Přihlaste se a otevřete Nastavení → Aplikace a automatizace → Připojte svého asistenta. Zde najdete pokyny k nastavení a aktuální stav připojení.
Může integrace upravit naplánovaný nebo publikovaný příspěvek?
Naplánovaný příspěvek lze vrátit do konceptu k úpravám a další kontrole, pokud odesílání ještě nezačalo a žádné odeslání nemá nevyřešený výsledek. Asistent nemůže upravovat ani mazat obsah, který už byl v síti publikován.