Hubungkan alatmu ke penerbitan Influence

Gunakan API atau MCP Influence untuk menyimpan draf, menampilkan postingan yang akan diterbitkan untuk diperiksa, dan menjadwalkannya setelah disetujui. Setiap permintaan memakai akun terhubung dan mengembalikan status yang bisa dipantau.

Akses terbatas, peninjauan isi, dan hasil tercatat

Berikan hanya izin yang diperlukan

Pilih izin yang dibutuhkan klien. Influence memeriksa kepemilikan ruang kerja dan akses pada setiap operasi. Setiap alat menentukan apakah konfirmasi diperlukan, dan server menerapkan ketentuan itu.

Setujui konten, akun, dan waktu kirim

Tinjau akun, konten, media, dan waktu sebelum eksekusi. Perubahan material membutuhkan peninjauan dan persetujuan baru; pekerjaan yang disetujui masuk ke penjadwal Influence.

Baca hasil yang tercatat

Simpan ID yang dikembalikan untuk memantau status. Terjadwal berarti menunggu penerbitan; Terbit berarti pengiriman sudah dipastikan. Perlu ditinjau berarti hasilnya belum terselesaikan. Periksa hasil permintaan awal sebelum mempertimbangkan pengiriman lagi.

Baca akun yang terhubung lewat MCP

Contoh Node.js ini terhubung ke Influence dan menampilkan akun media sosial di ruang kerja kamu. Contoh ini hanya membaca data akun, tanpa membuat draf atau menerbitkan postingan.

1. Buat kunci dengan izin baca

Di pengaturan, buka Aplikasi dan otomatisasi → Alat pengembang. Centang Baca kanal yang terhubung (integrations:read), hapus centang semua izin lainnya, lalu buat kunci API. Simpan kunci di pengelola rahasia lokal atau variabel lingkungan INFLUENCE_API_TOKEN. Kunci hanya ditampilkan sekali; jangan taruh di kode sumber atau chat.

Buka pengaturan kunci API

2. Jalankan contoh

Setelah Node.js dan npm terpasang, instal SDK MCP di proyek kamu. Simpan kode berikut sebagai accounts.mjs, lalu jalankan node accounts.mjs di lingkungan yang sudah memiliki INFLUENCE_API_TOKEN. SDK menangani koneksi dan inisialisasi 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. Baca responsnya

Contoh respons dengan nama dan ID akun fiktif. Respons kamu menampilkan ruang kerja dan akun media sosial yang terhubung di dalamnya.

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

Arti hasil yang diterima

Ada akun yang ditemukan

connectionId mengenali setiap akun. eligible serta supportsText, supportsImage, dan supportsVideo menunjukkan kemampuan posting akun saat ini. Periksa lagi nilainya sebelum menyiapkan postingan.

Tidak ada akun yang ditemukan

ok: true dengan items: [] dan done: true berarti pembacaan berhasil. Hubungkan akun media sosial di ruang kerja yang ditunjukkan workspaceName, lalu jalankan contoh lagi.

Hasil masih berlanjut

Jika done bernilai false, panggil accountList lagi dengan cursor yang diterima serta nilai limit yang sama. Lanjutkan sampai done bernilai true; halaman pertama bisa berisi kurang dari 20 akun.

Akses ditolak

Untuk respons 401, periksa apakah kunci masih berlaku dan memiliki izin integrations:read. Izin yang kurang juga bisa menghasilkan 401 untuk kunci API. Koneksi OAuth bisa mengembalikan 403 insufficient_scope; hubungkan ulang dan izinkan pembacaan akun.

ChatGPT dan Claude bisa terhubung melalui persetujuan di browser tanpa kunci. Ikuti panduan asisten, lalu minta asisten menampilkan akun yang terhubung. Contoh ini memakai endpoint MCP lengkap, https://influence.so/api/mcp; konektor inti Claude memiliki pengaturan tersendiri.

Daftar alat yang tersedia melalui API

GET /api/v1/tools menampilkan alat yang bisa diakses dengan kunci kamu. Permintaan ini mengambil izin dan persyaratan konfirmasi untuk accountList. Untuk membuat draf, kamu perlu izin tulis tambahan.

HTTP API

GET /api/v1/tools

Aplikasimu membaca katalog dan memanggil alat yang tersedia.

MCP

tools/list

Asisten yang didukung menemukan alat dan mengikuti proses tinjauan yang sama.

Influence
  1. 1. Siapkan draf

    Panggil campaignDraftSave dengan akun dan media dari ruang kerja. Simpan versi dan identitas permintaan untuk memulihkan respons yang terputus. Penyimpanan draf memerlukan konfirmasi server.

  2. 2. Siapkan tinjauan sebelum persetujuan

    Panggil campaignReview untuk versi tersimpan dan tindakan yang diminta. Tampilkan akun, konten, media, pengaturan, waktu, dan masa berlaku sebelum meminta persetujuan.

  3. 3. Jalankan tindakan yang disetujui

    campaignReviewExecute memerlukan persetujuan atas tinjauan yang sama persis. Postingan teks memerlukan balasan baru terhadap tinjauan lengkap; media memerlukan persetujuan visual. Server meneruskan tindakan ke penjadwal persisten, tanpa memanggil penyedia secara langsung.

  4. 4. Baca hasil sebelum mencoba ulang

    Periksa status setiap akun dan tautan postingan jika tersedia. Pengiriman yang belum pasti tetap Perlu ditinjau sampai hasilnya dikonfirmasi. Pulihkan permintaan awal sebelum membuat postingan lain agar tidak terkirim dua kali.

Pilih koneksi untuk alatmu

Influence: Pilih koneksi untuk alatmu
KoneksiKegunaanAkses
HTTP APIAplikasimu membaca katalog dan memanggil alat yang tersedia.Gunakan kredensial bearer dengan izin terbatas dari variabel lingkungan.
MCPAsisten yang didukung menemukan alat dan mengikuti proses tinjauan yang sama.Ikuti petunjuk koneksi asisten di Pengaturan Influence. Ketersediaannya bergantung pada asisten yang dipakai dan izin yang diberikan.

Permintaan daftar alat

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

Contoh kolom dalam katalog alat

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

Ini contoh respons. Alat yang tersedia pada koneksimu bergantung pada katalog yang dikembalikan, izin kredensial, dan kelayakan akun.

Kabel biru menghubungkan wadah kartu foto, balok, stempel, kalender, dan amplop bersegel.

Alur penerbitan yang bisa kamu bangun

Postingan dari alur kontenmu

Siapkan draf dari artikel, catatan perubahan, atau pengumuman komunitas di alatmu. Tampilkan akun, konten, dan waktu yang tepat untuk ditinjau sebelum meminta Influence menjadwalkan publikasi.

Pulihkan permintaan saat respons hilang

Simpan permintaan awal dan kunci idempotensi untuk memeriksa hasilnya. Jika pengiriman belum pasti, statusnya tetap Perlu ditinjau. Pastikan hasil pengiriman awal sebelum mencoba mengirim lagi.

Buat draf pertama dengan Influence IQ

Berikan artikel, catatan proyek, atau kabar komunitas serta Panduan Merek tersimpan kepada Influence IQ untuk draf yang bisa diedit. Alat AI yang tersedia dan diizinkan memakai kredit IQ dan tetap memerlukan konfirmasi.

Influence IQ memakai catatanmu dan Panduan Merek yang tersimpan untuk mengusulkan postingan dan tanggal yang bisa kamu ubah. Draf dan pembuatan gambar memakai kredit IQ. Periksa estimasi kredit sebelum membuat gambar, lalu tinjau konten sebelum menerbitkannya.

Cara kerja Influence IQ

Siapkan postingan lewat ChatGPT atau Claude

Dengan koneksi Influence yang didukung, kamu bisa merencanakan kampanye dan memperbaiki draf di ChatGPT atau Claude. Minta asistenmu mengunggah gambar dan video yang bisa diaksesnya, atau memakai kembali media yang sudah siap di Influence. Jika asisten tidak bisa mengakses file, unggah dulu di Influence. Periksa akun, teks, media, pengaturan, dan waktu yang persis akan digunakan. Setelah melihat tinjauan lengkap, setujui lewat kartu chat yang didukung atau kirim persetujuan tegas dalam pesan baru. Untuk TikTok Direct, sampaikan pilihan penerbitan dan persetujuanmu di chat, lalu setujui tinjauan yang diperbarui. Kartu tinjauan bersifat opsional. Buka Pengaturan untuk melihat cara menghubungkan asisten dan status koneksinya.

Publikasikan ke akun yang terhubung

Pilih akun yang tersedia di ruang kerja kamu. Sesuaikan teks dan media yang didukung untuk setiap tujuan, lalu periksa postingan sebelum dipublikasikan.

Siapkan postingan berikutnya

Tambahkan akun, siapkan postingan, dan pilih tanggalnya. Periksa konten sebelum menjadwalkan publikasi.

Mulai

Pertanyaan umum

Apa yang bisa dilakukan alur API dan MCP?
Alat yang tersedia bisa dipakai untuk melihat akun yang terhubung, menyimpan draf, memakai media yang didukung, meninjau postingan, mengubah jadwal, dan memeriksa status. Aksesnya bergantung pada fitur yang diaktifkan dan izin koneksi.
Apakah panggilan API atau MCP melewati persetujuan?
Tidak. Server menerapkan ketentuan konfirmasi setiap alat. Penerbitan memerlukan persetujuan atas tinjauan terkini. Sebelum menjadwalkan pengiriman, Influence memeriksa ruang kerja, izin, akun, dan konten.
Media apa yang diterima alur asisten?
Minta asistenmu mengunggah gambar dan video yang bisa diaksesnya, atau memakai kembali media yang sudah siap di Influence. Jika asisten tidak bisa mengakses file, unggah dulu di Influence. Periksa akun, teks, media, pengaturan, dan waktu yang persis akan digunakan. Setelah melihat tinjauan lengkap, setujui lewat kartu chat yang didukung atau kirim persetujuan tegas dalam pesan baru. Untuk TikTok Direct, sampaikan pilihan penerbitan dan persetujuanmu di chat, lalu setujui tinjauan yang diperbarui. Kartu tinjauan bersifat opsional.
Bagaimana menangani respons hilang atau pengiriman belum pasti?
Periksa hasil permintaan awal dan statusnya. Jangan ulangi pengiriman yang hasilnya belum pasti; statusnya tetap Perlu ditinjau sampai hasil pengiriman dikonfirmasi.
Apakah dukungan MCP menjamin setiap host asisten berfungsi?
Tidak. Masuk lalu buka Pengaturan → Aplikasi dan otomatisasi → Hubungkan asistenmu untuk melihat petunjuk penyiapan dan status koneksi terkini.
Bisakah integrasi mengedit postingan terjadwal atau sudah terbit?
Postingan terjadwal bisa dikembalikan ke draf untuk diedit dan ditinjau lagi jika pengiriman belum dimulai dan tidak ada pengiriman yang hasilnya belum pasti. Asisten tidak bisa mengedit atau menghapus konten yang sudah terbit di jaringan sosial.