Forbind dine værktøjer med udgivelse i Influence

Brug Influences API og MCP-værktøjer til at gemme kladder, gennemgå opslag og planlægge godkendte udgivelser. Hent tilsluttede konti, og tjek registrerede udgivelsesresultater med de samme værktøjer.

Adgangsoplysninger, godkendelse og udgivelsesstatus

Brug adgangsoplysninger med afgrænsede rettigheder

Vælg de rettigheder, klienten har brug for. Influence kontrollerer ejerskab og adgang til arbejdsområdet ved hver handling. Hvert værktøj angiver, om der kræves bekræftelse. Serveren håndhæver kravet.

Godkend den præcise udgivelseshandling

Gennemgå konti, indhold, medier og tidspunkt, før handlingen udføres. En væsentlig ændring kræver en ny gennemgang og en ny godkendelse; godkendt arbejde går videre til Influences udgivelsesplanlægger.

Læs udgivelsesstatus

Brug de returnerede id'er til at tjekke hvert opslag. ”Planlagt” betyder, at opslaget venter på at blive udgivet; ”Udgivet” bekræfter, at det er udgivet. ”Kræver gennemgang” betyder, at resultatet er usikkert og skal afklares, før du sender igen.

Læs dine tilsluttede konti med MCP

Dette Node.js-eksempel opretter forbindelse til Influence og viser de sociale konti i dit arbejdsområde. Det læser kontooplysninger uden at oprette en kladde eller udgive et opslag.

1. Opret en nøgle med læseadgang

Åbn Apps og automatiseringer → Udviklerværktøjer under Indstillinger. Vælg Læs forbundne kanaler (integrations:read), fjern alle andre tilladelser, og opret derefter API-nøglen. Gem nøglen i dit lokale lager til hemmelige oplysninger eller som miljøvariablen INFLUENCE_API_TOKEN. Nøglen vises kun 1 gang; medtag den ikke i kildefiler eller chats.

Åbn indstillingerne for API-nøgler

2. Kør eksemplet

Hvis Node.js og npm er installeret, skal du installere MCP-SDK’et i dit projekt. Gem koden nedenfor som accounts.mjs, og kør derefter node accounts.mjs i et miljø, hvor INFLUENCE_API_TOKEN er angivet. SDK’et håndterer MCP-forbindelsen og initialiseringen.

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

Eksempelsvar med fiktive kontonavne og id’er. Dit svar identificerer dit arbejdsområde og dets tilsluttede sociale konti.

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

Hvad resultatet betyder

Konti returneret

Brug connectionId til at identificere hver konto. eligible samt supportsText, supportsImage og supportsVideo beskriver kontoens aktuelle muligheder for at udgive. Kontrollér dem igen, før du forbereder et opslag.

Ingen konti returneret

ok: true sammen med items: [] og done: true betyder, at læsningen lykkedes. Forbind en konto på sociale medier i det arbejdsområde, der vises i workspaceName, og kør derefter eksemplet igen.

Flere sider med resultater

Når done er false, skal du kalde accountList igen med den returnerede cursor og samme limit. Fortsæt, indtil done er true; den første side kan indeholde færre end 20 konti.

Adgang afvist

Hvis du får svaret 401, skal du kontrollere, at nøglen er gyldig og har tilladelsen integrations:read. Med en API-nøgle kan en manglende tilladelse også give 401. En OAuth-forbindelse kan give 403 insufficient_scope; opret forbindelse igen, og godkend læseadgang til konti.

ChatGPT og Claude kan tilsluttes via godkendelse i browseren i stedet for en nøgle. Følg assistentens opsætningsvejledning, og bed den derefter om at vise dine tilsluttede konti. Eksemplet ovenfor bruger det fulde MCP-endpoint, https://influence.so/api/mcp; Claudes kerneconnector har sin egen opsætning.

Find værktøjer og de tilladelser, de kræver

GET /api/v1/tools viser de værktøjer, som din nøgle giver adgang til. Denne forespørgsel udtrækker tilladelserne og kravene til bekræftelse for accountList. Oprettelse af kladder kræver yderligere skrivetilladelser.

HTTP API

GET /api/v1/tools

Din applikation læser kataloget og kalder de tilgængelige værktøjer.

MCP

tools/list

En understøttet assistent finder værktøjer og følger det samme gennemgangsforløb.

Influence
  1. 1. Forbered en kladde

    Kald campaignDraftSave med konti og medier fra arbejdsområdet. Gem versionen og forespørgslens identitet, så du kan gendanne et afbrudt svar. Lagring af kladder kræver bekræftelse fra serveren.

  2. 2. Forbered gennemgangen

    Kald campaignReview for den gemte version og handling. Vis kontiene, indholdet, medierne, indstillingerne, tidspunktet og udløbstidspunktet, før du beder om godkendelse.

  3. 3. Udfør den godkendte handling

    campaignReviewExecute kræver godkendelse af præcis den gennemgang. Tekstopslag kræver et nyt svar på den fulde gennemgang; medier kræver visuel godkendelse. Serveren sender handlingen til den persistente jobplanlægger frem for at kalde udbyderen direkte.

  4. 4. Læs resultatet, før du prøver igen

    Se status for hver konto og linket til det udgivne opslag, når det er tilgængeligt. En afsendelse med ukendt resultat forbliver i status ”Kræver gennemgang”, indtil resultatet er afklaret. Gendan den eksisterende forespørgsel, før du opretter et nyt opslag, ellers risikerer du at sende et dobbeltopslag.

Vælg forbindelsen til dit værktøj

Influence: Vælg forbindelsen til dit værktøj
ForbindelseAnvendelseAdgang
HTTP APIDin applikation læser kataloget og kalder de tilgængelige værktøjer.Brug et bearer-token med afgrænsede tilladelser fra en miljøvariabel.
MCPEn understøttet assistent finder værktøjer og følger det samme gennemgangsforløb.Følg opsætningen for assistenten under Indstillinger i Influence. Tilgængeligheden afhænger af værtsapplikationen og de tilladelser, der er givet.

Forespørgsel til kataloget

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

Eksempler på katalogfelter

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

Disse eksempelfelter stammer fra værktøjsdefinitionerne. Det aktuelle katalog, tilladelserne knyttet til dine legitimationsoplysninger og de tilsluttede konti afgør, hvilke handlinger der er tilgængelige.

Blå kabler forbinder en bakke med fotokort, klodser, et stempel, en kalender og en forseglet kuvert.

Udgivelsesforløb, du kan bygge

Opslag fra dit eget indholdsforløb

Forbered kladder ud fra en artikel, en ændringslog eller en meddelelse til fællesskabet i dine egne værktøjer. Vis de præcise konti, indholdet og tidspunktet til gennemgang, før du beder Influence om at planlægge udgivelsen.

Gendan en anmodning efter et mistet svar

Behold den oprindelige anmodning og idempotensnøglen, og slå derefter resultatet op. En afsendelse med usikkert udfald bliver i ”Kræver gennemgang”, indtil du kan bekræfte, hvad der skete. En erstatning kan medføre, at samme opslag udgives 2 gange.

Få en første kladde med Influence IQ

Giv Influence IQ en artikel, projektnoter eller nyt fra fællesskabet samt dine gemte Brandretningslinjer for at få kladder, du kan redigere. Tilgængelige AI-værktøjer, du har tilladelse til at bruge, forbruger IQ-kreditter og beholder deres krav om bekræftelse.

Giv Influence IQ dine noter og gemte brandretningslinjer for at få opslag, du kan redigere, og forslag til datoer. Kladder og billedgenerering bruger IQ-kreditter. Gennemgå prisen for billedgenerering, før du starter, og det færdige indhold, før du udgiver.

Udforsk Influence IQ

Start med en AI-assistent

Med en understøttet Influence-forbindelse kan du planlægge kampagner og rette kladder i ChatGPT eller Claude. Bed assistenten om at uploade billeder og videoer, den har adgang til, eller genbruge færdige medier fra Influence. Hvis den ikke kan tilgå filen, skal du først uploade den i Influence. Gennemgå de præcise konti, teksten, medierne, indstillingerne og tidspunktet. Godkend derefter i et understøttet kort i chatten eller med et nyt ”approved”-svar, efter at du har set hele gennemgangen. Ved TikTok Direct skal du angive dine valg for opslaget og dit samtykke i chatten og derefter godkende den opdaterede gennemgang. Kortet med gennemgangen er valgfrit. Se opsætning og forbindelsesstatus i Indstillinger.

Udgiv til dine tilknyttede konti

Vælg konti, der er tilgængelige i dit arbejdsområde. Redigér tekst og understøttede medier til hver destination, og gennemgå opslagene, før du udgiver.

Gør dine næste opslag klar

Tilføj dine konti, forbered opslagene, og vælg deres datoer. Gennemgå indholdet, før du planlægger udgivelsen.

Kom i gang

Ofte stillede spørgsmål

Hvad kan arbejdsgangen med API og MCP gøre?
Afhængigt af de aktiverede værktøjer og dine rettigheder kan en API- eller MCP-klient arbejde med tilsluttede konti, gemte kladder, understøttede medier, gennemgang af opslag, udgivelsesplaner og udgivelsesstatus.
Omgår API- eller MCP-kald godkendelsen?
Nej. Serveren håndhæver hvert værktøjs krav om bekræftelse. Udgivelse kræver godkendelse af den aktuelle gennemgang. Før udgivelsen planlægges, kontrolleres arbejdsområdet, rettighederne, kontiene og indholdet.
Hvilke medier kan assistentens arbejdsgang bruge?
Bed din assistent om at uploade billeder og videoer, den har adgang til, eller genbruge færdige medier fra Influence. Hvis den ikke har adgang til filen, skal du først uploade den i Influence. Gennemgå præcis de konti, den tekst, de medier, de indstillinger og det tidspunkt, der skal bruges. Når du har set hele gennemgangen, skal du godkende via et understøttet kort i chatten eller med et nyt svar med den ordrette tekst ”approved”. For TikTok Direct skal du angive dine valg for opslaget og give dit samtykke i chatten og derefter godkende den opdaterede gennemgang. Et kort med gennemgangen er valgfrit.
Hvordan håndterer du et mistet svar eller en afsendelse med usikkert udfald?
Hent resultatet af den oprindelige anmodning, og tjek den registrerede status. Gentag ikke en afsendelse med uklart udfald. ”Kræver gennemgang” forbliver uafklaret, indtil en afstemning har fastslået udfaldet.
Garanterer MCP-understøttelse, at alle assistentværter virker?
Nej. Log ind, og åbn ”Indstillinger → Apps og automatiseringer → Forbind din assistent” for at se opsætningsvejledningen og den aktuelle forbindelsesstatus.
Kan en integration redigere et planlagt eller udgivet opslag?
Et planlagt opslag kan gøres til en kladde igen, så det kan redigeres og gennemgås på ny, hvis udgivelsen ikke er begyndt, og ingen afsendelse har et uafklaret resultat. Assistenten kan ikke redigere eller slette indhold, der allerede er udgivet på et netværk.