Połącz swoje narzędzia z funkcją publikowania w Influence

Korzystaj z API i narzędzi MCP Influence, aby zapisywać wersje robocze, sprawdzać posty i planować zatwierdzone publikacje. Za pomocą tych samych narzędzi pobieraj listę połączonych kont i sprawdzaj zapisane wyniki publikacji.

Dane uwierzytelniające, zatwierdzanie i stan wysyłki

Ogranicz dostęp za pomocą danych uwierzytelniających o określonym zakresie uprawnień

Wybierz uprawnienia potrzebne klientowi. Przy każdej operacji Influence sprawdza własność obszaru roboczego i dostęp. Każde narzędzie określa, czy wymaga potwierdzenia. Serwer egzekwuje ten wymóg.

Zatwierdź konkretną czynność publikacji

Przed wykonaniem sprawdź konta, treść, materiały i termin. Istotna zmiana wymaga nowego przeglądu i ponownego zatwierdzenia; zatwierdzona publikacja trafia do mechanizmu planowania Influence.

Odczytaj stan wysyłki

Użyj zwróconych identyfikatorów, aby sprawdzić każdy post. Status „Zaplanowano” oznacza oczekiwanie na wysyłkę, a „Opublikowano” potwierdza publikację. Status „Wymaga sprawdzenia” oznacza niepewny wynik, który trzeba wyjaśnić przed kolejną wysyłką.

Odczytaj połączone konta przez MCP

Ten przykład w Node.js łączy się z Influence i wyświetla konta społecznościowe w Twoim obszarze roboczym. Odczytuje informacje o kontach bez tworzenia wersji roboczej ani publikowania posta.

1. Utwórz klucz z dostępem do odczytu

W Ustawieniach otwórz Aplikacje i automatyzacje → Narzędzia deweloperskie. Wybierz Odczyt połączonych kanałów (integrations:read), usuń zaznaczenie wszystkich pozostałych uprawnień, a następnie utwórz klucz API. Zapisz klucz w lokalnym magazynie sekretów lub w środowisku jako INFLUENCE_API_TOKEN. Klucz jest wyświetlany tylko raz; nie umieszczaj go w plikach źródłowych ani czatach.

Otwórz ustawienia kluczy API

2. Uruchom przykład

Gdy masz zainstalowane Node.js i npm, zainstaluj SDK MCP w swoim projekcie. Zapisz poniższy kod jako accounts.mjs, a następnie uruchom node accounts.mjs w środowisku z ustawioną zmienną INFLUENCE_API_TOKEN. SDK obsługuje połączenie MCP i jego inicjalizację.

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. Odczytaj odpowiedź

Przykładowa odpowiedź z fikcyjnymi nazwami i identyfikatorami kont. Twoja odpowiedź wskazuje Twój obszar roboczy i połączone z nim konta społecznościowe.

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

Co oznacza wynik

Zwrócono konta

Użyj connectionId do identyfikacji każdego konta. eligible oraz supportsText, supportsImage i supportsVideo opisują jego aktualne możliwości publikacji; sprawdź je ponownie przed przygotowaniem posta.

Nie zwrócono kont

ok: true z items: [] i done: true oznacza udany odczyt. Połącz konto społecznościowe w obszarze roboczym wskazanym przez workspaceName, a następnie uruchom przykład ponownie.

Wiele stron wyników

Gdy done ma wartość false, wywołaj accountList ponownie ze zwróconą wartością cursor oraz tą samą wartością limit. Kontynuuj, aż done będzie mieć wartość true; pierwsza strona może zawierać mniej niż 20 kont.

Odmowa dostępu

Przy odpowiedzi 401 sprawdź, czy klucz jest aktualny i ma uprawnienie integrations:read. W przypadku klucza API brak zakresu uprawnień również może skutkować odpowiedzią 401. Połączenie OAuth może zwrócić 403 insufficient_scope; połącz się ponownie i zatwierdź dostęp do odczytu kont.

ChatGPT i Claude mogą łączyć się przez autoryzację w przeglądarce zamiast klucza. Skorzystaj z instrukcji konfiguracji asystenta, a potem poproś go o listę połączonych kont. Powyższy przykład używa pełnego punktu końcowego MCP, https://influence.so/api/mcp; podstawowy konektor Claude ma osobną konfigurację.

Poznaj narzędzia i wymagane uprawnienia

GET /api/v1/tools wyświetla narzędzia dostępne dla Twojego klucza. To żądanie wybiera z katalogu informacje o uprawnieniach i wymaganiach dotyczących potwierdzenia dla accountList. Tworzenie wersji roboczych wymaga dodatkowych uprawnień do zapisu.

HTTP API

GET /api/v1/tools

Twoja aplikacja odczytuje katalog i wywołuje dostępne narzędzia.

MCP

tools/list

Obsługiwany asystent wykrywa narzędzia i stosuje ten sam proces sprawdzania przed zatwierdzeniem.

Influence
  1. 1. Przygotuj wersję roboczą

    Wywołaj campaignDraftSave z kontami i multimediami z obszaru roboczego. Zachowaj wersję i identyfikator żądania, aby odzyskać przerwaną odpowiedź. Zapis wersji roboczych wymaga potwierdzenia przez serwer.

  2. 2. Przygotuj podsumowanie do sprawdzenia

    Wywołaj campaignReview dla zapisanej wersji i działania. Zanim poprosisz o zatwierdzenie, pokaż konta, treść, multimedia, ustawienia, termin i czas wygaśnięcia.

  3. 3. Wykonaj zatwierdzone działanie

    campaignReviewExecute wymaga zatwierdzenia dokładnie tego podsumowania. Posty tekstowe wymagają nowej odpowiedzi na pełne podsumowanie, a multimedia — zatwierdzenia po obejrzeniu. Serwer przekazuje działanie do mechanizmu trwałego planowania zadań, zamiast bezpośrednio wywoływać dostawcę.

  4. 4. Odczytaj wynik przed ponowną próbą

    Odczytaj status każdego konta i link do opublikowanego posta, jeśli jest dostępny. Wysłanie o niepewnym wyniku pozostaje w stanie Wymaga sprawdzenia do czasu wyjaśnienia rezultatu. Odzyskaj istniejące żądanie przed utworzeniem kolejnego posta, aby nie wysłać duplikatu.

Wybierz połączenie dla swojego narzędzia

Influence: Wybierz połączenie dla swojego narzędzia
PołączenieZastosowanieDostęp
HTTP APITwoja aplikacja odczytuje katalog i wywołuje dostępne narzędzia.Użyj danych uwierzytelniających typu Bearer z ograniczonym zakresem uprawnień, pobieranych ze zmiennej środowiskowej.
MCPObsługiwany asystent wykrywa narzędzia i stosuje ten sam proces sprawdzania przed zatwierdzeniem.Postępuj zgodnie z instrukcją konfiguracji asystenta w Ustawieniach Influence. Dostępność zależy od hosta i przyznanych uprawnień.

Żądanie katalogu

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

Przykładowe pola katalogu

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

Te przykładowe pola pochodzą z definicji narzędzi. Dostępne operacje zależą od aktualnego katalogu, zakresów uprawnień danych uwierzytelniających i połączonych kont.

Niebieskie przewody łączą tackę na karty ze zdjęciami, klocki, stempel, kalendarz i zaklejoną kopertę.

Procesy publikacji, które możesz zbudować

Posty z własnego procesu tworzenia treści

Przygotuj we własnych narzędziach wersje robocze na podstawie artykułu, listy zmian lub ogłoszenia dla społeczności. Pokaż dokładne konta, treść i termin do sprawdzenia, zanim poprosisz Influence o zaplanowanie publikacji.

Odzyskaj wynik żądania po utracie odpowiedzi

Zachowaj oryginalne żądanie i klucz idempotencji, a następnie odszukaj jego wynik. Wysyłka o niepewnym wyniku pozostaje w stanie „Wymaga sprawdzenia”, dopóki nie potwierdzisz, co się stało. Utworzenie żądania zastępczego może opublikować ten sam post dwukrotnie.

Przygotuj pierwszą wersję roboczą z Influence IQ

Przekaż Influence IQ artykuł, notatki projektowe lub aktualności dla społeczności wraz z zapisanymi Wytycznymi marki, aby otrzymać wersje robocze do edycji. Dostępne narzędzia AI, do których masz uprawnienia, zużywają kredyty IQ i zachowują swoje wymagania dotyczące potwierdzenia.

Przekaż Influence IQ notatki i zapisane Wytyczne marki, aby otrzymać posty do edycji i propozycje terminów. Tworzenie wersji roboczych i generowanie obrazów zużywa kredyty IQ. Przed rozpoczęciem sprawdź wycenę generowania obrazów, a przed publikacją — gotową treść.

Poznaj Influence IQ

Zacznij od asystenta AI

Korzystając z obsługiwanego połączenia z Influence, możesz planować kampanie i poprawiać wersje robocze w ChatGPT lub Claude. Poproś asystenta o przesłanie obrazów i filmów, do których ma dostęp, albo o ponowne użycie gotowych multimediów z Influence. Jeśli nie ma dostępu do pliku, najpierw prześlij go w Influence. Sprawdź konkretne konta, tekst, multimedia, ustawienia i termin. Następnie zatwierdź je na obsługiwanej karcie w rozmowie albo nową odpowiedzią „zatwierdzam” po zapoznaniu się z pełnym przeglądem. W przypadku TikTok Direct podaj w rozmowie opcje publikowania i zgodę, a potem zatwierdź zaktualizowany przegląd. Karta przeglądu jest opcjonalna. Konfigurację i stan połączenia sprawdzisz w Ustawieniach.

Publikuj na połączonych kontach

Wybierz konta dostępne w obszarze roboczym. Dostosuj tekst i obsługiwane multimedia do każdego miejsca docelowego, a następnie sprawdź posty przed publikacją.

Przygotuj kolejne posty

Dodaj konta, przygotuj posty i wybierz daty ich publikacji. Przed zaplanowaniem publikacji sprawdź treść.

Zacznij

Najczęściej zadawane pytania

Co umożliwia proces korzystający z API i MCP?
Zależnie od włączonych narzędzi i uprawnień klient API lub MCP może korzystać z połączonych kont, zapisanych wersji roboczych, obsługiwanych materiałów, przeglądów postów, harmonogramów i stanu wysyłki.
Czy wywołania API lub MCP omijają zatwierdzanie?
Nie. Serwer egzekwuje wymagania dotyczące potwierdzenia dla każdego narzędzia. Publikacja wymaga zatwierdzenia aktualnego przeglądu. Przed zaplanowaniem wysyłki system sprawdza obszar roboczy, uprawnienia, konta i treść.
Jakie materiały obsługuje proces publikacji przez asystenta?
Poproś asystenta o przesłanie obrazów i filmów, do których ma dostęp, lub o ponowne użycie gotowych materiałów z Influence. Jeśli nie ma dostępu do pliku, najpierw prześlij go w Influence. Sprawdź dokładnie konta, tekst, materiały, ustawienia i termin. Następnie zatwierdź publikację na obsługiwanej karcie w czacie lub w nowej odpowiedzi „zatwierdzam” po zapoznaniu się z pełnym przeglądem. W przypadku TikTok Direct podaj w czacie wybrane ustawienia publikacji i zgodę, a potem zatwierdź zaktualizowany przegląd. Karta przeglądu jest opcjonalna.
Jak postąpić po utracie odpowiedzi lub przy niepewnym wyniku wysyłki?
Odzyskaj wynik oryginalnego żądania i sprawdź zapisany status. Nie ponawiaj wysyłki o niejasnym wyniku. Stan „Wymaga sprawdzenia” pozostaje nierozwiązany, dopóki uzgodnienie danych nie potwierdzi wyniku.
Czy obsługa MCP gwarantuje działanie każdego środowiska asystenta?
Nie. Zaloguj się i otwórz Ustawienia → Aplikacje i automatyzacje → Połącz swojego asystenta, aby sprawdzić instrukcje konfiguracji oraz aktualny stan połączenia.
Czy integracja może edytować zaplanowany lub opublikowany post?
Zaplanowany post może wrócić do wersji roboczej do edycji i ponownego przeglądu, jeśli wysyłka się nie rozpoczęła i nie ma żadnej wysyłki o niewyjaśnionym wyniku. Asystent nie może edytować ani usuwać treści już opublikowanych w sieci społecznościowej.