Koppla dina verktyg till Influences publicering

Spara utkast, granska inlägg och schemalägg publicering efter godkännande via Influences API och MCP-verktyg. Där kan du också hämta anslutna konton och läsa registrerade publiceringsresultat.

Autentiseringsuppgifter, godkännande och status för leverans

Använd autentiseringsuppgifter med begränsade behörigheter

Välj de behörigheter som en klient behöver. Influence kontrollerar arbetsytans ägarskap och åtkomst vid varje åtgärd. Varje verktyg anger om bekräftelse krävs. Servern ser till att kravet följs.

Godkänn den exakta publiceringsåtgärden

Granska konton, innehåll, medier och tid innan åtgärden utförs. En väsentlig ändring kräver ny granskning och nytt godkännande. Godkända åtgärder läggs i Influences schemaläggare.

Läs leveransstatusen

Använd de returnerade ID:na för att kontrollera varje inlägg. ”Schemalagt” betyder att det väntar på leverans. ”Publicerat” bekräftar att det har publicerats. ”Behöver granskas” betyder att resultatet är osäkert och måste klarläggas innan du skickar igen.

Läs dina anslutna konton med MCP

Det här Node.js-exemplet ansluter till Influence och listar kontona för sociala medier i din arbetsyta. Det läser kontouppgifter utan att skapa utkast eller publicera inlägg.

1. Skapa en nyckel med läsåtkomst

I Inställningar öppnar du Appar och automatiseringar → Utvecklarverktyg. Välj Läs anslutna kanaler (integrations:read), avmarkera alla andra behörigheter och skapa sedan API-nyckeln. Spara nyckeln i ditt lokala lager för hemligheter eller i miljön som INFLUENCE_API_TOKEN. Nyckeln visas bara 1 gång; håll den utanför källfiler och chattar.

Öppna inställningarna för API-nycklar

2. Kör exemplet

Installera MCP-SDK:t i ditt projekt när Node.js och npm är installerade. Spara koden nedan som accounts.mjs och kör sedan node accounts.mjs i en miljö där INFLUENCE_API_TOKEN är angiven. SDK:t hanterar MCP-anslutningen och initieringen.

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. Läs svaret

Exempelsvar med påhittade kontonamn och ID:n. Ditt svar identifierar din arbetsyta och dess anslutna konton för sociala medier.

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

Vad resultatet betyder

Konton i svaret

Använd connectionId för att identifiera varje konto. eligible samt supportsText, supportsImage och supportsVideo beskriver kontots aktuella publiceringsmöjligheter; kontrollera dem igen innan du förbereder ett inlägg.

Inga konton i svaret

ok: true med items: [] och done: true betyder att läsningen lyckades. Anslut ett konto för sociala medier i arbetsytan som visas i workspaceName och kör sedan exemplet igen.

Flera resultatsidor

När done är false anropar du accountList igen med cursor från svaret och samma limit. Fortsätt tills done är true; den första sidan kan innehålla färre än 20 konton.

Åtkomst nekad

Vid svaret 401 kontrollerar du att nyckeln är aktuell och har behörigheten integrations:read. En saknad behörighet kan också ge 401 med en API-nyckel. En OAuth-anslutning kan ge 403 insufficient_scope; anslut på nytt och godkänn läsåtkomst till konton.

ChatGPT och Claude kan ansluta via auktorisering i webbläsaren i stället för en nyckel. Följ assistentens konfigurationsguide och be den sedan lista dina anslutna konton. Exemplet ovan använder den fullständiga MCP-slutpunkten, https://influence.so/api/mcp; Claudes kärnanslutning har en egen konfiguration.

Hitta verktygen och deras behörighetskrav

GET /api/v1/tools listar de verktyg som din nyckel ger åtkomst till. Det här anropet väljer ut uppgifterna om behörigheter och bekräftelsekrav för accountList. För att skapa utkast krävs ytterligare skrivbehörigheter.

HTTP-API

GET /api/v1/tools

Din applikation läser katalogen och anropar de tillgängliga verktygen.

MCP

tools/list

En assistent som stöds hittar verktygen och följer samma granskningsflöde.

Influence
  1. 1. Förbered ett utkast

    Anropa campaignDraftSave med konton och medier från arbetsytan. Behåll versionen och anropets identitet så att du kan hämta svaret igen efter ett avbrott. Skrivningar av utkast kräver bekräftelse från servern.

  2. 2. Förbered granskningen

    Anropa campaignReview för den sparade versionen och åtgärden. Visa kontona, innehållet, medierna, inställningarna, tiden och när granskningen löper ut. Be först därefter om ett godkännande.

  3. 3. Utför den godkända åtgärden

    campaignReviewExecute kräver ett godkännande av exakt den granskningen. Textinlägg kräver ett nytt svar på hela granskningen; medier kräver ett visuellt godkännande. Servern skickar åtgärden till den beständiga schemaläggaren i stället för att anropa leverantören direkt.

  4. 4. Läs resultatet innan du försöker igen

    Läs varje kontos status och publicerade länk när den finns. En osäker sändning ligger kvar som ”Behöver granskas” tills utfallet har klarlagts. Hämta den befintliga begärans resultat innan du skapar ett nytt inlägg, annars kan du skicka en dubblett.

Välj anslutning för ditt verktyg

Influence: Välj anslutning för ditt verktyg
AnslutningAnvänd tillÅtkomst
HTTP-APIDin applikation läser katalogen och anropar de tillgängliga verktygen.Använd en bearer-token med begränsade behörigheter från en miljövariabel.
MCPEn assistent som stöds hittar verktygen och följer samma granskningsflöde.Följ konfigurationen för assistenten i Inställningar i Influence. Tillgängligheten beror på värden och de behörigheter du har gett.

Kataloganrop

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

Exempel på katalogfält

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

Exempelfälten kommer från verktygsdefinitionerna. Den aktuella katalogen, autentiseringsuppgifternas behörigheter och de anslutna kontona avgör vilka åtgärder som är tillgängliga.

Blå kablar kopplar ihop ett fack med fotokort, klossar, en stämpel, en kalender och ett förseglat kuvert.

Publiceringsflöden du kan bygga

Inlägg från ditt eget innehållsflöde

Förbered utkast från en artikel, ändringslogg eller ett communitymeddelande i dina verktyg. Visa exakt vilka konton, vilket innehåll och vilken tid som gäller för granskning innan du ber Influence schemalägga publiceringen.

Hitta resultatet när svaret på en begäran har försvunnit

Behåll den ursprungliga begäran och idempotensnyckeln och hämta sedan resultatet. Ett utskick med osäkert resultat ligger kvar som ”Behöver granskas” tills du kan bekräfta vad som hände. En ny ersättningsbegäran kan publicera samma inlägg två gånger.

Få ett första utkast med Influence IQ

Ge Influence IQ en artikel, projektanteckningar eller en communityuppdatering och dina sparade varumärkesriktlinjer för att få redigerbara utkast. Tillgängliga AI-verktyg som du har behörighet att använda förbrukar IQ-krediter och behåller sina krav på bekräftelse.

Ge Influence IQ dina anteckningar och sparade varumärkesriktlinjer för att få redigerbara inlägg och förslag på datum. Att skapa utkast och generera bilder i Influence IQ förbrukar IQ-krediter. Granska kostnadsförslaget för bildgenereringen innan du börjar och det färdiga innehållet före publicering.

Utforska Influence IQ

Börja med en AI-assistent

Du kan planera kampanjer och ändra utkast i ChatGPT eller Claude när du har en Influence-anslutning som stöds. Be assistenten ladda upp de bilder och videor den kan komma åt eller använda färdiga medier som redan finns i Influence. Om filen inte är tillgänglig för assistenten laddar du först upp den i Influence. Kontrollera granskningens exakta uppgifter om konton, text, medier, inställningar och tid. När du har sett hela granskningen godkänner du via ett granskningskort som stöds i chatten eller genom att svara ”approved” på nytt. Vid TikTok Direct anger du först publiceringsval och samtycke i chatten och godkänner därefter den uppdaterade granskningen. Du måste inte använda ett granskningskort. Öppna Inställningar för konfiguration och anslutningsstatus.

Publicera på dina anslutna konton

Välj konton som är tillgängliga för din arbetsyta. Redigera texten och de medier som stöds för varje destination och granska sedan inläggen före publicering.

Förbered dina nästa inlägg

Lägg till dina konton, förbered inläggen och välj publiceringsdatum. Granska innehållet innan du schemalägger.

Kom igång

Vanliga frågor

Vad kan arbetsflödet med API och MCP göra?
Beroende på aktiverade verktyg och dina behörigheter kan en API- eller MCP-klient hantera anslutna konton, sparade utkast, medier som stöds, inläggsgranskningar, schemaläggningar och leveransstatus.
Kringgår API- eller MCP-anrop godkännandet?
Nej. Servern upprätthåller varje verktygs krav på bekräftelse. Publicering kräver att den aktuella granskningen godkänns. När åtgärden utförs kontrolleras arbetsyta, behörigheter, konton och innehåll innan leveransen schemaläggs.
Vilka medier kan användas i arbetsflödet med en assistent?
Be assistenten ladda upp de bilder och videor den kan komma åt eller återanvända färdiga medier från Influence. Om assistenten inte kommer åt filen laddar du först upp den i Influence. Granska de exakta uppgifterna om konton, text, medier, inställningar och tid. Godkänn sedan i ett kort som stöds i chatten eller genom att svara ”approved” på nytt efter att ha sett hela granskningen. För TikTok Direct anger du publiceringsval och samtycke i chatten och godkänner sedan den uppdaterade granskningen. Ett granskningskort är valfritt.
Vad gör du om svaret saknas eller utskickets resultat är oklart?
Hämta resultatet för den ursprungliga begäran och kontrollera den registrerade statusen. Upprepa inte ett utskick med oklart resultat. ”Behöver granskas” förblir olöst tills en avstämning bekräftar resultatet.
Innebär stöd för MCP att varje assistentmiljö fungerar?
Nej. Logga in och öppna Inställningar → Appar och automatiseringar → Anslut din assistent för att se konfigurationsanvisningar och aktuell anslutningsstatus.
Kan en integration redigera ett schemalagt eller publicerat inlägg?
Ett schemalagt inlägg kan återgå till utkast för redigering och en ny granskning om leveransen inte har börjat och inget utskick har ett olöst resultat. Assistenten kan inte redigera eller ta bort innehåll som redan har publicerats på ett nätverk.