Conecta tus herramientas con la publicación en Influence

Usa la API y las herramientas MCP de Influence para guardar borradores, revisar la publicación exacta y programar el envío aprobado. Reúne cuentas conectadas y resultados registrados en un solo flujo.

Credenciales, aprobación y estado de publicación

Asigna solo los permisos necesarios

Elige los permisos que necesita el cliente. Influence comprueba la propiedad del espacio de trabajo y el acceso en cada operación. Cada herramienta indica si requiere confirmación y el servidor aplica ese requisito.

Aprueba el contenido, la cuenta y la hora

Revisa cuentas, contenido, archivos y hora antes de ejecutar. Un cambio material exige otra revisión y nueva aprobación; el trabajo aprobado entra en el programador de Influence.

Consulta el estado de publicación

Usa los identificadores recibidos para consultar cada post. Programado significa que está pendiente de envío; Publicado confirma que salió. Requiere revisión indica un resultado incierto que hay que resolver antes de otro envío.

Consulta tus cuentas conectadas mediante MCP

Este ejemplo de Node.js conecta con Influence y muestra las cuentas sociales de tu espacio de trabajo. Lee sus datos sin crear borradores ni publicar nada.

1. Crea una clave con permiso de lectura

En Configuración, abre Apps y automatizaciones → Herramientas para desarrolladores. Selecciona Consultar canales conectados (integrations:read), desmarca todos los demás permisos y crea la clave API. Guarda la clave en tu gestor local de secretos o como variable de entorno INFLUENCE_API_TOKEN. Solo se muestra una vez; no la incluyas en archivos de código ni en chats.

Abrir la configuración de claves API

2. Ejecuta el ejemplo

Con Node.js y npm instalados, instala el SDK de MCP en tu proyecto. Guarda el código siguiente en accounts.mjs y ejecuta node accounts.mjs en un entorno donde esté definida INFLUENCE_API_TOKEN. El SDK se encarga de conectar e inicializar 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. Interpreta la respuesta

Respuesta de ejemplo con nombres e identificadores ficticios. Tu respuesta identifica tu espacio de trabajo y sus cuentas sociales conectadas.

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

Qué significa el resultado

Hay cuentas disponibles

connectionId identifica cada cuenta. eligible y supportsText, supportsImage y supportsVideo indican las funciones de publicación disponibles en ese momento; vuelve a consultarlas antes de preparar una publicación.

No aparece ninguna cuenta

ok: true con items: [] y done: true indica que la consulta se ha completado correctamente. Conecta una cuenta social en el espacio de trabajo que indica workspaceName y vuelve a ejecutar el ejemplo.

Hay más páginas

Si done es false, vuelve a llamar a accountList con el cursor recibido y el mismo valor de limit. Continúa hasta que done sea true; la primera página puede contener menos de 20 cuentas.

Acceso rechazado

Ante una respuesta 401, comprueba que la clave siga vigente y tenga el permiso integrations:read. Una clave API sin ese permiso también puede devolver 401. Una conexión OAuth puede devolver 403 insufficient_scope; vuelve a conectar y autoriza la lectura de cuentas.

ChatGPT y Claude pueden conectarse mediante autorización en el navegador, sin clave. Sigue la guía del asistente y pídele que enumere tus cuentas conectadas. El ejemplo anterior usa el endpoint MCP completo, https://influence.so/api/mcp; el conector básico de Claude tiene su propia configuración.

Herramientas disponibles y permisos necesarios

GET /api/v1/tools enumera las herramientas a las que puede acceder tu clave. Esta consulta muestra los permisos y requisitos de confirmación de accountList. Para crear borradores hacen falta permisos de escritura adicionales.

HTTP API

GET /api/v1/tools

Tu aplicación lee el catálogo y llama a las herramientas disponibles.

MCP

tools/list

Un asistente compatible descubre las herramientas y sigue el mismo proceso de revisión.

Influence
  1. 1. Prepara un borrador

    Llama a campaignDraftSave con cuentas y archivos del espacio de trabajo. Conserva la versión y el identificador de la solicitud para recuperar una respuesta interrumpida. Guardar un borrador requiere confirmación del servidor.

  2. 2. Prepara la revisión

    Llama a campaignReview con la versión guardada y la acción solicitada. Muestra las cuentas, el contenido, los archivos, los ajustes, la hora y la caducidad antes de pedir aprobación.

  3. 3. Ejecuta la acción aprobada

    campaignReviewExecute exige la aprobación de esa revisión exacta. Los posts de texto necesitan una respuesta nueva a la revisión completa; los archivos requieren aprobación visual. El servidor envía la acción al programador persistente, sin llamar directamente al proveedor.

  4. 4. Lee el resultado antes de reintentar

    Consulta el estado de cada cuenta y el enlace de la publicación cuando esté disponible. Un envío incierto permanece en Requiere revisión hasta confirmar su resultado. Recupera la solicitud original antes de crear otra publicación, para evitar duplicarla.

Elige la conexión para tu herramienta

Influence: Elige la conexión para tu herramienta
ConexiónPara qué sirveAcceso
HTTP APITu aplicación lee el catálogo y llama a las herramientas disponibles.Usa una credencial bearer con permisos limitados desde una variable de entorno.
MCPUn asistente compatible descubre las herramientas y sigue el mismo proceso de revisión.Sigue la configuración de tu asistente en Configuración de Influence. La disponibilidad depende del cliente y de los permisos concedidos.

Solicitud del catálogo

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

Ejemplo de campos del catálogo

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

Los campos de ejemplo proceden de las definiciones de herramientas. El catálogo actual, los permisos de la credencial y las cuentas conectadas determinan las operaciones disponibles.

Unos cables azules conectan una bandeja de tarjetas con fotos, bloques, un sello, un calendario y un sobre sellado.

Flujos de publicación que puedes crear

Publicaciones desde tu propio flujo de contenido

Prepara borradores a partir de un artículo, registro de cambios o aviso a la comunidad en tus herramientas. Muestra las cuentas, el contenido y la hora exactos para revisión antes de pedir a Influence que programe el envío.

Recupera una solicitud si se pierde la respuesta

Conserva la solicitud original y la clave de idempotencia para consultar el resultado registrado. Si no se confirma el envío, permanece en Requiere revisión. Comprueba qué ocurrió antes de intentar otro envío.

Consigue un primer borrador con Influence IQ

Dale a Influence IQ un artículo, notas de proyecto o novedades de tu comunidad y la Guía de marca guardada para obtener borradores editables. Las herramientas de IA autorizadas disponibles consumen créditos IQ y mantienen sus requisitos de confirmación.

Influence IQ usa tus notas y la guía de marca guardada para proponer publicaciones y fechas que puedes editar. Los borradores y la generación de imágenes consumen créditos IQ. Antes de generar una imagen, consulta su presupuesto. Revisa el contenido antes de publicarlo.

Cómo funciona Influence IQ

Prepara publicaciones desde ChatGPT o Claude

Con una conexión compatible de Influence, puedes planificar campañas y modificar borradores en ChatGPT o Claude. Pide a tu asistente que suba imágenes y vídeos a los que pueda acceder o que reutilice archivos listos de Influence. Si no puede acceder al archivo, súbelo primero en Influence. Revisa las cuentas, el texto, los archivos, los ajustes y la hora exactos. Después de ver la revisión completa, aprueba en una tarjeta compatible dentro del chat o con un nuevo mensaje de aprobación explícita. Para TikTok Direct, indica tus opciones de publicación y tu consentimiento en el chat; después, aprueba la revisión actualizada. La tarjeta de revisión es opcional. Consulta la configuración y el estado de la conexión en Configuración.

Publica en tus cuentas conectadas

Elige las cuentas disponibles en tu espacio de trabajo. Edita el texto y los archivos multimedia compatibles para cada destino y revisa las publicaciones antes de publicarlas.

Prepara tus próximas publicaciones

Añade tus cuentas, prepara las publicaciones y elige las fechas. Revisa el contenido antes de programarlo.

Empezar

Preguntas frecuentes

¿Qué puede hacer el flujo API y MCP?
Las herramientas disponibles permiten consultar cuentas conectadas, guardar borradores, usar archivos compatibles, revisar la publicación, cambiar fechas y consultar el estado. El acceso depende de las funciones habilitadas y los permisos de la conexión.
¿Evitan la aprobación las llamadas API o MCP?
No. El servidor aplica los requisitos de confirmación de cada herramienta. Publicar requiere la aprobación de la revisión actual. Antes de programar el envío, Influence comprueba el espacio de trabajo, los permisos, las cuentas y el contenido.
¿Qué archivos admite el flujo de asistentes?
Pide a tu asistente que suba imágenes y vídeos a los que pueda acceder o que reutilice archivos listos de Influence. Si no puede acceder al archivo, súbelo primero en Influence. Revisa las cuentas, el texto, los archivos, los ajustes y la hora exactos. Después de ver la revisión completa, aprueba en una tarjeta compatible dentro del chat o con un nuevo mensaje de aprobación explícita. Para TikTok Direct, indica tus opciones de publicación y tu consentimiento en el chat; después, aprueba la revisión actualizada. La tarjeta de revisión es opcional.
¿Cómo gestionas una respuesta perdida o envío incierto?
Consulta el resultado de la solicitud original y su estado registrado. No repitas un envío cuyo resultado siga sin confirmarse: permanece en Requiere revisión hasta que se compruebe qué ocurrió.
¿Garantiza MCP que funcione cualquier asistente?
No. Inicia sesión y abre Configuración → Apps y automatizaciones → Conecta tu asistente para consultar las instrucciones y el estado actual de la conexión.
¿Puede una integración editar un post programado o publicado?
Una publicación programada puede volver a borrador para editarla y revisarla de nuevo si el envío no ha empezado ni hay un envío sin resolver. El asistente no puede editar ni eliminar contenido ya publicado en una red social.