Подключите свои инструменты к публикации через Influence

Используйте API и инструменты MCP от Influence, чтобы сохранять черновики, проверять публикации и планировать их выход после одобрения. Через те же инструменты можно получить подключённые аккаунты и проверить зафиксированные результаты публикации.

Учётные данные, одобрение и статус отправки

Ограничить доступ с помощью прав учётных данных

Выберите разрешения, необходимые клиенту. Для каждой операции Influence проверяет принадлежность рабочего пространства и доступ к нему. Каждый инструмент указывает, требуется ли подтверждение. Сервер обеспечивает соблюдение этого требования.

Одобрить точное действие публикации

Перед выполнением проверьте аккаунты, контент, медиафайлы и время. Существенное изменение требует новой проверки и нового одобрения; одобренные действия поступают в планировщик Influence.

Проверить статус отправки

Используйте полученные идентификаторы, чтобы проверить каждую публикацию. Статус «Запланировано» означает ожидание отправки, а «Опубликовано» подтверждает выход публикации. «Требует проверки» означает неопределённый результат, который нужно выяснить до повторной отправки.

Получите данные подключённых аккаунтов через MCP

Этот пример на Node.js подключается к Influence и выводит список социальных аккаунтов рабочего пространства. Он читает сведения об аккаунтах, не создавая черновик и не размещая публикацию.

1. Создайте ключ с доступом на чтение

В разделе «Настройки» откройте Приложения и автоматизации → Инструменты разработчика. Выберите Просматривать подключённые каналы (integrations:read), снимите все остальные разрешения и создайте ключ API. Сохраните ключ в локальном хранилище секретов или в переменной окружения INFLUENCE_API_TOKEN. Ключ показывается только один раз; не добавляйте его в исходные файлы и чаты.

Открыть настройки ключей API

2. Запустите пример

Если Node.js и npm установлены, установите SDK MCP в проект. Сохраните код ниже как accounts.mjs, затем выполните node accounts.mjs в окружении с заданной переменной INFLUENCE_API_TOKEN. SDK выполняет подключение и инициализацию 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. Прочитайте ответ

Пример ответа с вымышленными именами и идентификаторами аккаунтов. Ваш ответ указывает рабочее пространство и подключённые к нему социальные аккаунты.

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

Что означает результат

Аккаунты получены

Используйте connectionId для идентификации каждого аккаунта. Поля eligible, supportsText, supportsImage и supportsVideo описывают его текущие возможности публикации; проверьте их снова перед подготовкой публикации.

Аккаунты не получены

ok: true вместе с items: [] и done: true означает успешное чтение. Подключите социальный аккаунт в рабочем пространстве, указанном в workspaceName, затем запустите пример снова.

Несколько страниц результатов

Если done равно false, вызовите accountList снова с полученным cursor и тем же limit. Продолжайте, пока done не станет true; на первой странице может быть меньше 20 аккаунтов.

Доступ отклонён

При ответе 401 проверьте, что ключ действителен и имеет доступ integrations:read. Отсутствие нужного разрешения при использовании ключа API тоже может приводить к 401. Подключение OAuth может вернуть 403 insufficient_scope; подключитесь заново и разрешите чтение аккаунтов.

ChatGPT и Claude могут подключаться через авторизацию в браузере вместо ключа. Следуйте инструкции настройки помощника, затем попросите вывести список подключённых аккаунтов. В примере выше используется полная конечная точка MCP — https://influence.so/api/mcp; у основного коннектора Claude отдельная настройка.

Найдите инструменты и необходимые для них разрешения

GET /api/v1/tools возвращает список инструментов, доступных вашему ключу. Этот запрос выбирает сведения о разрешениях и требованиях к подтверждению для accountList. Для создания черновиков нужны дополнительные разрешения на запись.

HTTP API

GET /api/v1/tools

Ваше приложение читает каталог и вызывает доступные инструменты.

MCP

tools/list

Поддерживаемый помощник находит инструменты и следует тому же процессу проверки.

Influence
  1. 1. Подготовьте черновик

    Вызовите campaignDraftSave с аккаунтами и медиафайлами рабочего пространства. Сохраните версию и идентификатор запроса, чтобы восстановить ответ, если его получение прервётся. Для записи черновиков необходимо подтверждение сервера.

  2. 2. Подготовьте данные для проверки

    Вызовите campaignReview для сохранённой версии и действия. Покажите аккаунты, контент, медиафайлы, настройки, время и срок действия, прежде чем запрашивать одобрение.

  3. 3. Выполните одобренное действие

    campaignReviewExecute требует одобрения именно этой проверки. Для текстовых публикаций нужен новый ответ на сообщение со всеми данными для проверки; для медиафайлов — визуальное одобрение. Сервер передаёт действие планировщику с сохранением состояния, а не обращается к провайдеру напрямую.

  4. 4. Прочитайте результат перед повторной попыткой

    Проверьте статус каждого аккаунта и ссылку на вышедшую публикацию, если она доступна. Отправка с неопределённым результатом остаётся в состоянии «Требует проверки», пока результат не будет выяснен. Прежде чем создавать другую публикацию, восстановите существующий запрос, иначе возможна повторная отправка.

Выберите подключение для своего инструмента

Influence: Выберите подключение для своего инструмента
ПодключениеДля чего использоватьДоступ
HTTP APIВаше приложение читает каталог и вызывает доступные инструменты.Возьмите учётные данные Bearer с ограниченными правами доступа из переменной окружения.
MCPПоддерживаемый помощник находит инструменты и следует тому же процессу проверки.Следуйте инструкции настройки помощника в разделе «Настройки» Influence. Доступность зависит от хоста и предоставленных разрешений.

Запрос каталога

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

Примеры полей каталога

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

Эти примеры полей взяты из определений инструментов. Доступные операции определяются действующим каталогом, правами учётных данных и подключёнными аккаунтами.

Синие кабели соединяют лоток с фотокарточками, блоки, штамп, календарь и запечатанный конверт.

Какие процессы публикации можно создать

Публикации из вашего процесса работы с контентом

Готовьте в своих инструментах черновики на основе статьи, списка изменений или объявления для сообщества. Покажите точные аккаунты, контент и время для проверки, прежде чем попросить Influence запланировать публикацию.

Восстановить запрос после потери ответа

Сохраните исходный запрос и ключ идемпотентности, затем найдите его результат. Отправка с неопределённым исходом остаётся в статусе «Требует проверки», пока вы не сможете подтвердить, что произошло. Создание замены может привести к повторной публикации того же контента.

Подготовьте первый черновик с Influence IQ

Передайте Influence IQ статью, заметки о проекте или новость сообщества и сохранённые «Правила бренда», чтобы получить редактируемые черновики. Доступные инструменты ИИ, на использование которых у вас есть разрешение, расходуют кредиты IQ и сохраняют свои требования к подтверждению.

Передайте Influence IQ заметки и сохранённые «Правила бренда», чтобы получить редактируемые публикации и предлагаемые даты. Подготовка черновиков и генерация изображений расходуют IQ-кредиты. Перед запуском проверьте стоимость генерации, а перед публикацией — готовый контент.

Подробнее об Influence IQ

Начните с ИИ-помощника

С поддерживаемым подключением Influence можно планировать кампании и редактировать черновики в ChatGPT или Claude. Попросите помощника загрузить доступные ему изображения и видео либо повторно использовать готовые медиа из Influence. Если файл ему недоступен, сначала загрузите его в Influence. Проверьте точные аккаунты, текст, медиа, настройки и время. Затем подтвердите действие в поддерживаемой карточке чата или новым ответом «approved» после просмотра полной сводки для проверки. Для TikTok Direct укажите параметры публикации и согласие в чате, затем подтвердите обновлённую сводку для проверки. Карточка проверки необязательна. Порядок подключения и его статус смотрите в разделе «Настройки».

Публикуйте в подключённых аккаунтах

Выберите аккаунты, доступные вашему рабочему пространству. Отредактируйте текст и поддерживаемые медиа для каждого места назначения, затем проверьте публикации перед отправкой.

Подготовьте следующие публикации

Добавьте аккаунты, подготовьте публикации и выберите даты. Проверьте контент перед планированием.

Начать работу

Частые вопросы

Что можно делать через API и MCP?
В зависимости от включённых инструментов и ваших разрешений клиент API или MCP может работать с подключёнными аккаунтами, сохранёнными черновиками, поддерживаемыми медиафайлами, проверкой публикаций, расписанием и статусом отправки.
Позволяют ли вызовы API или MCP обойти одобрение?
Нет. Сервер обеспечивает соблюдение требований к подтверждению для каждого инструмента. Публикация требует одобрения текущих данных проверки. Перед планированием отправки проверяются рабочее пространство, разрешения, аккаунты и контент.
Какие медиафайлы можно использовать через помощника?
Попросите помощника загрузить изображения и видео, к которым у него есть доступ, или повторно использовать готовые материалы из Influence. Если у него нет доступа к файлу, сначала загрузите его в Influence. Проверьте точные аккаунты, текст, медиафайлы, настройки и время. Затем одобрите публикацию в поддерживаемой карточке в чате или новым ответом «approved» после просмотра полной информации для проверки. Для TikTok Direct укажите в чате параметры публикации и дайте согласие, затем одобрите обновлённую информацию для проверки. Карточка проверки необязательна.
Что делать при потере ответа или неопределённом результате отправки?
Получите результат исходного запроса и проверьте зафиксированный статус. Не повторяйте отправку с неясным результатом. Статус «Требует проверки» остаётся неразрешённым, пока сверка не подтвердит исход.
Гарантирует ли поддержка MCP работу любого приложения с помощником?
Нет. Войдите в аккаунт и откройте «Настройки → Приложения и автоматизации → Подключить помощника», чтобы посмотреть инструкции по настройке и текущее состояние подключения.
Может ли интеграция изменить запланированную или опубликованную публикацию?
Запланированную публикацию можно вернуть в черновик для редактирования и повторной проверки, если отправка ещё не началась и нет отправок с невыясненным результатом. Помощник не может редактировать или удалять контент, уже опубликованный в соцсети.