Conecte suas ferramentas à publicação pelo Influence

Use a API e as ferramentas MCP do Influence para salvar rascunhos, revisar publicações e agendar a publicação aprovada. Consulte as contas conectadas e os resultados de publicação registrados pelas mesmas ferramentas.

Credenciais, aprovação e status do envio

Limite o acesso com credenciais de escopo definido

Escolha as permissões de que o cliente precisa. O Influence verifica a titularidade do espaço de trabalho e o acesso em cada operação. Cada ferramenta informa se exige confirmação, e o servidor aplica essa exigência.

Aprove a ação exata de publicação

Confira as contas, o conteúdo, as mídias e o horário antes da execução. Uma alteração relevante exige nova revisão e aprovação; o trabalho aprovado entra no agendador do Influence.

Consulte o status do envio

Use os IDs retornados para conferir cada publicação. Agendada significa que ela está aguardando o envio; Publicada confirma que o conteúdo foi ao ar. Precisa de revisão indica resultado incerto, que deve ser esclarecido antes de outro envio.

Leia suas contas conectadas com MCP

Este exemplo em Node.js se conecta à Influence e lista as contas de redes sociais do seu espaço de trabalho. Ele lê os detalhes das contas sem criar rascunhos nem publicar.

1. Crie uma chave com acesso de leitura

Em Configurações, abra Aplicativos e automações → Ferramentas do desenvolvedor. Selecione Ler canais conectados (integrations:read), desmarque todas as outras permissões e crie a chave de API. Salve a chave no armazenamento local de segredos ou no ambiente como INFLUENCE_API_TOKEN. Ela é exibida 1 vez; mantenha-a fora de arquivos de código e conversas.

Abra as configurações de chaves de API

2. Execute o exemplo

Com Node.js e npm instalados, instale o SDK MCP no projeto. Salve o código abaixo como accounts.mjs e execute node accounts.mjs em um ambiente com INFLUENCE_API_TOKEN definido. O SDK cuida da conexão e da inicialização do 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. Leia a resposta

Resposta de exemplo com nomes e IDs de contas fictícios. Sua resposta identifica seu espaço de trabalho e as contas de redes sociais conectadas a ele.

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

O que o resultado significa

Contas retornadas

Use connectionId para identificar cada conta. eligible, supportsText, supportsImage e supportsVideo descrevem os recursos atuais de publicação; confira-os de novo antes de preparar uma publicação.

Nenhuma conta retornada

ok: true com items: [] e done: true indica uma leitura bem-sucedida. Conecte uma conta de rede social no espaço de trabalho indicado por workspaceName e execute o exemplo de novo.

Várias páginas de resultados

Quando done for false, chame accountList de novo com o cursor retornado e o mesmo limit. Continue até done ser true; a primeira página pode ter menos de 20 contas.

Acesso negado

Se a resposta for 401, confira se a chave está válida e tem acesso integrations:read. A falta desse escopo também pode retornar 401 com uma chave de API. Uma conexão OAuth pode retornar 403 insufficient_scope; reconecte e aprove o acesso de leitura das contas.

ChatGPT e Claude podem se conectar por autorização no navegador em vez de usar uma chave. Siga o guia do assistente e peça a lista das contas conectadas. O exemplo acima usa o endpoint MCP completo, https://influence.so/api/mcp; o conector básico do Claude tem sua própria configuração.

Conheça as ferramentas e as permissões que elas exigem

A chamada GET /api/v1/tools mostra as ferramentas que sua chave pode usar. O exemplo seleciona os campos de permissão e confirmação de accountList. Para criar rascunhos, são necessárias outras permissões de escrita.

API HTTP

GET /api/v1/tools

Sua aplicação lê o catálogo e chama as ferramentas disponíveis.

MCP

tools/list

Um assistente compatível descobre as ferramentas e segue o mesmo fluxo de revisão.

Influence
  1. 1. Prepare um rascunho

    Chame campaignDraftSave com contas e arquivos de mídia do espaço de trabalho. Guarde a versão e a identificação da solicitação para recuperar uma resposta interrompida. A gravação de rascunhos exige confirmação do servidor.

  2. 2. Prepare a revisão

    Chame campaignReview para a versão salva e a ação. Mostre as contas, o conteúdo, os arquivos de mídia, as configurações, o horário e a validade antes de pedir aprovação.

  3. 3. Execute a ação aprovada

    campaignReviewExecute exige a aprovação daquela revisão exata. Publicações de texto precisam de uma nova resposta à revisão completa; arquivos de mídia exigem aprovação visual. O servidor envia a ação ao agendador persistente, em vez de chamar o provedor diretamente.

  4. 4. Leia o resultado antes de tentar de novo

    Leia o status de cada conta e o link da publicação, quando disponível. Um envio incerto continua em Precisa de revisão até que seu resultado seja esclarecido. Recupere a solicitação existente antes de criar outra publicação para evitar um envio duplicado.

Escolha a conexão para sua ferramenta

Influence: Escolha a conexão para sua ferramenta
ConexãoQuando usarAcesso
API HTTPSua aplicação lê o catálogo e chama as ferramentas disponíveis.Use uma credencial Bearer com permissões limitadas, obtida de uma variável de ambiente.
MCPUm assistente compatível descobre as ferramentas e segue o mesmo fluxo de revisão.Siga a configuração do assistente em Configurações na Influence. A disponibilidade depende do aplicativo e das permissões concedidas.

Solicitação do 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}]}'

Exemplos de campos do catálogo

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

Estes campos de exemplo vêm das definições das ferramentas. O catálogo atual, as permissões da credencial e as contas conectadas determinam quais operações estão disponíveis.

Cabos azuis conectam uma bandeja de cartões com fotos, blocos, um carimbo, um calendário e um envelope fechado.

Fluxos de publicação que você pode criar

Publicações a partir do seu próprio fluxo de conteúdo

Prepare rascunhos a partir de um artigo, registro de alterações ou aviso da comunidade nas suas ferramentas. Mostre as contas exatas, o conteúdo e o horário para revisão antes de pedir ao Influence que agende a publicação.

Recupere uma solicitação após perder a resposta

Preserve a solicitação original e a chave de idempotência e consulte o resultado. Um envio de resultado incerto permanece em Precisa de revisão até que seja possível confirmar o que aconteceu. Criar uma solicitação substituta pode publicar o mesmo conteúdo 2 vezes.

Crie um rascunho inicial com o Influence IQ

Envie ao Influence IQ um artigo, anotações do projeto ou novidades da comunidade e suas Diretrizes da marca salvas para criar rascunhos editáveis. As ferramentas de IA disponíveis e autorizadas usam créditos IQ e mantêm suas exigências de confirmação.

Envie suas anotações e Diretrizes da marca salvas ao Influence IQ para criar publicações editáveis e receber sugestões de datas. A criação de rascunhos e imagens usa créditos IQ. Confira o orçamento da geração de imagens antes de começar e revise o conteúdo final antes de publicar.

Conheça o Influence IQ

Comece com um assistente de IA

Com uma conexão compatível do Influence, você pode planejar campanhas e revisar rascunhos no ChatGPT ou no Claude. Peça ao assistente para enviar imagens e vídeos aos quais ele tenha acesso ou reutilizar mídias prontas do Influence. Se ele não conseguir acessar o arquivo, envie-o primeiro no Influence. Revise as contas exatas, o texto, as mídias, as configurações e o horário. Depois, aprove em um cartão compatível no chat ou envie uma nova resposta “aprovado” após ver a revisão completa. No TikTok Direct, informe suas opções de publicação e dê seu consentimento no chat; em seguida, aprove a revisão atualizada. O cartão de revisão é opcional. Consulte Configurações para ver a configuração e o status da conexão.

Publique nas suas contas conectadas

Escolha as contas disponíveis no seu espaço de trabalho. Edite o texto e as mídias compatíveis de cada destino e revise as publicações antes de publicar.

Prepare suas próximas publicações

Adicione suas contas, prepare as publicações e escolha as datas. Revise o conteúdo antes de agendar.

Começar

Perguntas frequentes

O que um fluxo com API e MCP pode fazer?
Conforme as ferramentas habilitadas e suas permissões, um cliente de API ou MCP pode trabalhar com contas conectadas, rascunhos salvos, mídias compatíveis, revisões de publicações, agendamentos e status do envio.
Chamadas de API ou MCP dispensam aprovação?
Não. O servidor aplica as exigências de confirmação de cada ferramenta. Publicar exige a aprovação da revisão atual. Antes de agendar o envio, a execução verifica o espaço de trabalho, as permissões, as contas e o conteúdo.
Quais mídias o fluxo com assistente aceita?
Peça ao assistente para enviar imagens e vídeos aos quais ele tenha acesso ou reutilizar mídias prontas do Influence. Se ele não conseguir acessar o arquivo, envie-o primeiro no Influence. Revise as contas exatas, o texto, as mídias, as configurações e o horário. Depois, aprove em um cartão compatível no chat ou envie uma nova resposta “aprovado” após ver a revisão completa. No TikTok Direct, informe suas opções de publicação e dê seu consentimento no chat; em seguida, aprove a revisão atualizada. O cartão de revisão é opcional.
Como lidar com uma resposta perdida ou um envio incerto?
Recupere o resultado da solicitação original e confira o status registrado. Não repita um envio de resultado ambíguo. O estado Precisa de revisão continua sem resolução até que a reconciliação comprove o resultado.
O suporte a MCP garante que todo aplicativo de assistente funcione?
Não. Entre na conta e abra Configurações → Aplicativos e automações → Conecte seu assistente para conferir as instruções e o status atual da conexão.
Uma integração pode editar uma publicação agendada ou já publicada?
Uma publicação agendada pode voltar a rascunho para edição e outra revisão se o envio ainda não começou e nenhum envio estiver sem resolução. O assistente não pode editar nem excluir conteúdo já publicado em uma rede.