Publiez depuis vos outils avec l’API et le MCP d’Influence

L’API et les outils MCP d’Influence permettent d’enregistrer des brouillons, de vérifier les posts et de programmer leur publication après approbation. Vos outils peuvent accéder aux comptes connectés et aux résultats enregistrés.

Identifiants, approbation et état de publication

Limitez les droits du client

Choisissez les autorisations nécessaires au client. Influence vérifie la propriété de l’espace de travail et l’accès à chaque opération. Chaque outil précise s’il exige une confirmation, et le serveur applique cette exigence.

Approuvez l’action exacte de publication

Vérifiez comptes, contenu, médias et heure avant l’exécution. Un changement important exige une nouvelle vérification et approbation ; le travail approuvé passe par le système de programmation d’Influence.

Consulter l’état de publication

Utilisez les identifiants reçus pour consulter chaque post. Programmé signifie qu’il attend son envoi ; Publié confirme que l’envoi a abouti. À vérifier indique un résultat incertain à résoudre avant tout nouvel envoi.

Consultez vos comptes connectés avec MCP

Cet exemple Node.js se connecte à Influence et affiche les comptes sociaux de votre espace de travail. Il lit leurs informations sans créer de brouillon ni publier de contenu.

1. Créez une clé avec un accès en lecture

Dans les paramètres, ouvrez Applications et automatisations → Outils de développement. Cochez Consulter les canaux connectés (integrations:read), décochez toutes les autres autorisations, puis créez la clé API. Enregistrez-la dans votre gestionnaire local de secrets ou dans la variable d’environnement INFLUENCE_API_TOKEN. La clé ne s’affiche qu’une fois ; ne la placez ni dans le code ni dans un chat.

Ouvrir les paramètres des clés API

2. Exécutez l’exemple

Avec Node.js et npm installés, installez le SDK MCP dans votre projet. Enregistrez le code ci-dessous dans accounts.mjs, puis lancez node accounts.mjs dans un environnement où INFLUENCE_API_TOKEN est défini. Le SDK gère la connexion et l’initialisation 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. Lisez la réponse

Exemple de réponse avec des noms et identifiants fictifs. Votre réponse indique votre espace de travail et les comptes sociaux qui y sont connectés.

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

Comprendre le résultat

Des comptes sont renvoyés

connectionId identifie chaque compte. eligible et supportsText, supportsImage et supportsVideo décrivent ses capacités de publication actuelles ; vérifiez-les de nouveau avant de préparer une publication.

Aucun compte n’est renvoyé

ok: true avec items: [] et done: true indique une lecture réussie. Connectez un compte social dans l’espace indiqué par workspaceName, puis relancez l’exemple.

Plusieurs pages de résultats

Si done vaut false, rappelez accountList avec le cursor renvoyé et la même valeur de limit. Continuez jusqu’à ce que done vaille true ; la première page peut contenir moins de 20 comptes.

Accès refusé

Pour une réponse 401, vérifiez que la clé est encore valide et possède l’autorisation integrations:read. Une clé API sans cette autorisation peut aussi renvoyer 401. Une connexion OAuth peut renvoyer 403 insufficient_scope ; reconnectez-la et autorisez la lecture des comptes.

ChatGPT et Claude peuvent se connecter par autorisation dans le navigateur, sans clé. Suivez le guide de l’assistant, puis demandez-lui de lister vos comptes connectés. Cet exemple utilise l’endpoint MCP complet, https://influence.so/api/mcp ; le connecteur de base de Claude possède sa propre configuration.

Outils disponibles et autorisations nécessaires

GET /api/v1/tools liste les outils accessibles avec votre clé. Cette requête affiche les autorisations et les exigences de confirmation pour accountList. La création de brouillons nécessite des autorisations d’écriture supplémentaires.

HTTP API

GET /api/v1/tools

Votre application lit le catalogue et appelle les outils disponibles.

MCP

tools/list

Un assistant compatible découvre les outils et suit le même parcours de validation.

Influence
  1. 1. Préparez un brouillon

    Utilisez campaignDraftSave avec les comptes et fichiers de votre espace. Conservez la version et l’identifiant de la requête pour retrouver le résultat si la réponse se perd. L’enregistrement d’un brouillon modifie les données et nécessite une confirmation côté serveur.

  2. 2. Préparez la vérification

    Utilisez campaignReview pour la version enregistrée et l’action demandée. Affichez les comptes, le contenu, les fichiers, les paramètres, l’heure et la date d’expiration. Cette vérification n’approuve ni n’exécute l’action.

  3. 3. Exécutez l’action approuvée

    campaignReviewExecute exige l’approbation de cette vérification précise. Pour le texte, une nouvelle réponse doit confirmer la vérification complète ; les fichiers nécessitent une approbation visuelle. L’action passe par le planificateur persistant, sans appel direct au fournisseur.

  4. 4. Lisez le résultat avant de réessayer

    Consultez le statut de chaque destination et son lien de publication vérifié lorsqu’il est disponible. Un envoi incertain reste À vérifier jusqu’à ce que le résultat soit établi. Ne créez pas un nouveau post pour récupérer une réponse manquante.

Choisissez la connexion adaptée à votre outil

Influence: Choisissez la connexion adaptée à votre outil
ConnexionUsageAccès
HTTP APIVotre application lit le catalogue et appelle les outils disponibles.Utilisez un jeton bearer à permissions limitées depuis une variable d’environnement.
MCPUn assistant compatible découvre les outils et suit le même parcours de validation.Suivez la configuration de votre assistant dans les paramètres d’Influence. La disponibilité dépend du client et des droits accordés.

Requête du catalogue

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 champs du catalogue

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

Ces champs d’exemple proviennent des définitions d’outils. Le catalogue actuel, les autorisations liées à vos identifiants et les comptes connectés déterminent les opérations disponibles.

Des câbles bleus relient un bac de cartes photo, des blocs, un tampon, un calendrier et une enveloppe scellée.

Intégrez la publication à vos outils

Publier depuis vos outils de contenu

Préparez des brouillons à partir d’un article, journal des modifications ou annonce communautaire dans vos outils. Présentez comptes, contenu et heure exacts pour vérification avant de demander la programmation à Influence.

Retrouver une demande après une réponse perdue

Conservez la demande originale et la clé d’idempotence, puis consultez le résultat enregistré. Un envoi incertain reste À vérifier jusqu’à confirmation du résultat ; ne créez pas de publication de remplacement.

Rédigez vos brouillons avec Influence IQ

Donnez à Influence IQ un article, des notes de projet ou des nouvelles de la communauté avec votre Charte de marque enregistrée pour des brouillons modifiables. Les outils IA autorisés disponibles utilisent des crédits IQ et conservent leurs exigences de confirmation.

Donnez à Influence IQ vos notes et votre charte de marque enregistrée pour obtenir des brouillons et des propositions de dates. La rédaction et la génération d’images utilisent des crédits IQ. Vérifiez le coût proposé avant de créer une image, puis le contenu final avant publication.

Découvrir Influence IQ

Commencez avec un assistant IA

Avec une connexion Influence compatible, vous pouvez planifier des campagnes et modifier des brouillons dans ChatGPT ou Claude. Demandez à votre assistant d’importer les images et vidéos auxquelles il a accès, ou de réutiliser les médias prêts dans Influence. S’il ne peut pas accéder au fichier, importez-le d’abord dans Influence. Vérifiez les comptes, le texte, les médias, les réglages et l’heure exacts. Après avoir consulté l’ensemble, approuvez dans une carte compatible du chat ou par un nouveau message d’accord explicite. Pour TikTok Direct, indiquez vos choix de publication et votre consentement dans le chat, puis approuvez la version mise à jour. La carte de validation est facultative. Consultez la configuration et l’état de la connexion dans Paramètres.

Publiez sur vos comptes connectés

Choisissez les comptes disponibles dans votre espace de travail. Adaptez le texte et les médias pris en charge pour chaque destination, puis vérifiez les publications avant de les publier.

Préparez vos prochaines publications

Ajoutez vos comptes, préparez les publications et choisissez les dates. Vérifiez le contenu avant de le programmer.

Commencer

Questions fréquentes

Que peuvent faire les outils API et MCP ?
Les outils disponibles permettent de consulter les comptes, de gérer les brouillons et les médias compatibles, de vérifier les posts, de modifier les dates et de consulter l’état de publication. Les fonctions activées et vos autorisations déterminent les outils utilisables.
Les appels API ou MCP évitent-ils l’approbation ?
Non. Le serveur applique les exigences de confirmation de chaque outil. Pour publier, vous devez approuver la version actuelle présentée pour vérification. Avant de programmer l’envoi, Influence contrôle l’espace de travail, les droits, les comptes et le contenu.
Quels médias les assistants acceptent-ils ?
Demandez à votre assistant d’importer les images et vidéos auxquelles il a accès, ou de réutiliser les médias prêts dans Influence. S’il ne peut pas accéder au fichier, importez-le d’abord dans Influence. Vérifiez les comptes, le texte, les médias, les réglages et l’heure exacts. Après avoir consulté l’ensemble, approuvez dans une carte compatible du chat ou par un nouveau message d’accord explicite. Pour TikTok Direct, indiquez vos choix de publication et votre consentement dans le chat, puis approuvez la version mise à jour. La carte de validation est facultative.
Comment gérer une réponse perdue ou un envoi incertain ?
Récupérez le résultat original et vérifiez l’état. Ne répétez pas un envoi ambigu. L’état À vérifier reste non résolu jusqu’à ce qu’une vérification confirme ce qui s’est passé.
MCP garantit-il que tous les assistants fonctionnent ?
Non. Connectez-vous, puis ouvrez Paramètres → Applications et automatisations → Connectez votre assistant pour consulter les instructions et l’état actuel de la connexion.
Une intégration peut-elle modifier un contenu programmé ou publié ?
Un post programmé peut revenir à l’état de brouillon pour être modifié et revérifié si l’envoi n’a pas commencé et qu’aucun envoi ne reste incertain. L’assistant ne peut ni modifier ni supprimer un contenu déjà publié sur un réseau.