Publiceer met Influence vanuit je tools

Met de API en MCP-tools van Influence kun je concepten opslaan, berichten controleren en publicatie na goedkeuring inplannen. Je tools kunnen de gekoppelde accounts en opgeslagen publicatieresultaten opvragen.

Aan de slag Zo werkt het

Toegangssleutels, goedkeuring en publicatiestatus

Beperk de rechten van je toegangssleutels

Kies de rechten die een client nodig heeft. Eigendom van de werkruimte en toegang worden bij elke actie gecontroleerd; wijzigingen vereisen ook bevestiging die de server afdwingt.

Keur de exacte publicatieactie goed

Controleer accounts, inhoud, media en tijd vóór uitvoering. Een belangrijke wijziging vereist nieuwe controle en goedkeuring; goedgekeurd werk gaat naar de planner van Influence.

De publicatiestatus opvragen

Gebruik de ontvangen ID’s om elk bericht op te vragen. Gepland betekent dat het wacht op verzending; Gepubliceerd bevestigt dat het is verstuurd. Controle nodig betekent dat de uitkomst onzeker is en eerst moet worden opgehelderd voordat je opnieuw verstuurt.

Lees je gekoppelde accounts uit via MCP

Dit Node.js-voorbeeld maakt verbinding met Influence en toont de socialmedia-accounts in je werkruimte. Het leest accountgegevens zonder een concept te maken of een bericht te publiceren.

1. Maak een sleutel met leestoegang

Open in de instellingen Apps en automatiseringen → Ontwikkelaarstools. Vink Gekoppelde kanalen lezen (integrations:read) aan, vink alle andere toestemmingen uit en maak daarna de API-sleutel. Bewaar de sleutel in je lokale geheimenbeheerder of als omgevingsvariabele INFLUENCE_API_TOKEN. Je ziet de sleutel maar één keer; zet hem niet in broncode of chats.

API-sleutelinstellingen openen

2. Voer het voorbeeld uit

Installeer Node.js en npm en voeg de MCP-SDK toe aan je project. Sla de onderstaande code op als accounts.mjs en voer node accounts.mjs uit in een omgeving waarin INFLUENCE_API_TOKEN is ingesteld. De SDK regelt de MCP-verbinding en initialisatie.

npm install @modelcontextprotocol/sdk@1.31.0

accounts.mjs

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

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: { kind: "social", limit: 20 }
  });
  console.log(JSON.stringify(result.structuredContent, null, 2));
  if (result.isError) process.exitCode = 1;
} finally {
  await client.close();
}

3. Bekijk het antwoord

Voorbeeldantwoord met fictieve accountnamen en ID’s. Jouw antwoord toont je werkruimte en de daaraan gekoppelde socialmedia-accounts.

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

Wat het resultaat betekent

Er zijn accounts gevonden

connectionId identificeert elk account. eligible en supportsText, supportsImage en supportsVideo geven aan wat je er op dit moment kunt publiceren. Controleer deze waarden opnieuw voordat je een bericht voorbereidt.

Geen accounts gevonden

ok: true met items: [] en done: true betekent dat het uitlezen is gelukt. Koppel een socialmedia-account in de werkruimte die workspaceName aangeeft en voer het voorbeeld opnieuw uit. kind: social sluit WhatsApp-accounts uit.

Meer pagina’s met resultaten

Als done false is, roep je accountList opnieuw aan met de ontvangen cursor en dezelfde waarden voor kind en limit. Ga door tot done true is; de eerste pagina kan minder dan 20 accounts bevatten.

Toegang geweigerd

Controleer bij een 401-antwoord of de sleutel nog geldig is en integrations:read toestaat. Een ontbrekende toestemming kan bij een API-sleutel ook 401 opleveren. Een OAuth-verbinding kan 403 insufficient_scope teruggeven. Maak opnieuw verbinding en geef toestemming om accounts te lezen.

ChatGPT en Claude kunnen via toestemming in de browser verbinden, zonder sleutel. Volg de handleiding voor je assistent en vraag hem daarna je gekoppelde accounts te tonen. Dit voorbeeld gebruikt het volledige MCP-endpoint https://influence.so/api/mcp; de Claude-coreconnector heeft een eigen instelling.

ChatGPT Claude

Beschikbare tools en vereiste rechten

GET /api/v1/tools toont de tools die je sleutel mag gebruiken. Dit verzoek selecteert de toestemmingen en bevestigingsvereisten voor accountList. Voor het maken van concepten heb je extra schrijfrechten nodig.

HTTP API

GET /api/v1/tools

Je toepassing leest de catalogus en roept de beschikbare tools aan.

MCP

tools/list

Een ondersteunde assistent ontdekt tools en volgt dezelfde controleprocedure.

Influence

1. Bereid een concept voor
Gebruik campaignDraftSave met de accounts en media uit je werkruimte. Bewaar de versie en de identificatie van het verzoek om het resultaat terug te vinden als een antwoord verloren gaat. Een concept opslaan wijzigt gegevens en vereist bevestiging door de server.
2. Bereid de controle voor
Gebruik campaignReview voor de opgeslagen versie en de gewenste actie. Toon de accounts, inhoud, media, instellingen, tijd en vervaldatum. Hiermee wordt de actie nog niet goedgekeurd of uitgevoerd.
3. Voer de goedgekeurde actie uit
campaignReviewExecute vereist goedkeuring van precies deze controle. Voor tekst is een nieuw antwoord op de volledige controle nodig; media vereisen visuele goedkeuring. De actie gaat naar de persistente scheduler, niet rechtstreeks naar de provider.
4. Lees het resultaat voordat je opnieuw probeert
Lees de status van elke bestemming en de geverifieerde publicatielink als die beschikbaar is. Een onzekere verzending blijft in Controle nodig totdat de uitkomst is vastgesteld. Maak geen vervangend bericht om een ontbrekend antwoord te herstellen.

Kies de koppeling voor je tool

Influence: Kies de koppeling voor je tool
Koppeling	Gebruik	Toegang
HTTP API	Je toepassing leest de catalogus en roept de beschikbare tools aan.	Gebruik een bearer-sleutel met beperkte rechten vanuit een omgevingsvariabele.
MCP	Een ondersteunde assistent ontdekt tools en volgt dezelfde controleprocedure.	Volg de configuratie van je assistent in de Influence-instellingen. Beschikbaarheid hangt af van de client en verleende rechten.

Catalogusverzoek

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

Voorbeeldvelden uit de catalogus

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

De voorbeeldvelden komen uit de tooldefinities. De huidige catalogus, sleutelrechten en gekoppelde accounts bepalen welke acties beschikbaar zijn.

Blauwe kabels verbinden een bakje met fotokaarten, blokken, een stempel, een kalender en een verzegelde envelop.

Codex koppelen en een productupdate voorbereiden Publicatie-API’s en tools vergelijken

Publicatieworkflows voor je tools

Posts uit je eigen contentworkflow

Maak in je tools concepten vanuit een artikel, wijzigingslogboek of communitybericht. Toon de exacte accounts, inhoud en tijd voor controle voordat je Influence vraagt de publicatie te plannen.

Publiceer een projectupdate met Codex Vergelijk tools voor je accounts en maandelijkse berichten Vergelijk de API- en automatiseringsabonnementen van Publer

Een aanvraag terugvinden na een verloren antwoord

Bewaar de oorspronkelijke aanvraag en idempotentiesleutel en bekijk het vastgelegde resultaat. Onzekere verzending blijft Controle nodig totdat verificatie het resultaat bewijst; maak geen vervangende publicatie.

Schrijf concepten met Influence IQ

Geef Influence IQ een artikel, projectnotities of communitynieuws en je opgeslagen Merkrichtlijnen voor bewerkbare concepten. Beschikbare AI-tools waarvoor je toegang hebt gebruiken IQ-credits en vereisen nog steeds bevestiging.

Geef Influence IQ je notities en opgeslagen merkrichtlijnen. IQ stelt berichten en datums voor die je kunt aanpassen. Tekst- en beeldgeneratie gebruiken IQ-credits. Bekijk de prijsopgave voordat je een afbeelding laat maken en controleer de inhoud voordat je publiceert.

Bekijk Influence IQ

Begin met een AI-assistent

Met een ondersteunde Influence-koppeling kun je in ChatGPT of Claude campagnes plannen en concepten aanpassen. Maak tekstposts, afbeeldingsgalerijen en video's voor je verbonden accounts. Gebruik de postinstellingen van elk account voor Stories, Reels, artikelen en andere ondersteunde formats. Upload je afbeeldingen en video's in Influence en vraag je assistent daarna om ze te gebruiken. Bekijk de bijgevoegde media in Influence en keur de exacte post goed voordat je die publiceert of inplant. Bij Instellingen vind je informatie over het koppelen en de verbindingsstatus.

Bekijk ChatGPT Bekijk Claude

Publiceer op je gekoppelde accounts

Kies accounts die beschikbaar zijn in je werkruimte. Pas de tekst en ondersteunde media aan voor elke bestemming en controleer de berichten voordat je ze publiceert.

Bereid je volgende berichten voor

Voeg je accounts toe, bereid de berichten voor en kies de datums. Controleer de inhoud voordat je de publicatie inplant.

Aan de slag

Veelgestelde vragen

Wat kunnen de API en MCP doen?: De beschikbare tools kunnen accounts opvragen, concepten en ondersteunde media beheren, berichten ter controle tonen, datums wijzigen en de status opvragen. De ingeschakelde functies en je rechten bepalen welke tools je kunt gebruiken.
Omzeilen API- of MCP-calls de goedkeuring?: Nee. Wijzigingen vereisen bevestiging die de server afdwingt. Publiceren vereist goedkeuring van de actuele controle. Voor het inplannen controleert de uitvoering de werkruimte, rechten, accounts en inhoud.
Welke media accepteert de assistentworkflow?: Maak tekstposts, afbeeldingsgalerijen en video's voor je verbonden accounts. Gebruik de postinstellingen van elk account voor Stories, Reels, artikelen en andere ondersteunde formats. Upload je afbeeldingen en video's in Influence en vraag je assistent daarna om ze te gebruiken. Bekijk de bijgevoegde media in Influence en keur de exacte post goed voordat je die publiceert of inplant.
Hoe behandel ik een verloren antwoord of onzekere verzending?: Haal het resultaat van de oorspronkelijke aanvraag op en controleer de opgeslagen status. Herhaal geen onduidelijke verzending. Controle nodig blijft onopgelost totdat verificatie bewijst wat er is gebeurd.
Garandeert MCP dat elke assistenthost werkt?: Nee. Bekijk de handleiding voor Assistentverbindingen na het inloggen voor de instellingen en huidige status.
Kan een integratie een ingeplande of gepubliceerde post bewerken?: Een gepland bericht kan terug naar concept voor bewerking en een nieuwe controle als de verzending nog niet is begonnen en er geen onzekere verzending openstaat. De assistent kan inhoud die al op een netwerk is gepubliceerd niet bewerken of verwijderen.