Panduan pengaturan
Panduan pengaturan SosoAPI
Hubungkan agen AI, tautkan akun sosial, dan siapkan postingan pertama Anda.
Baca sebagai MarkdownDitinjau tim SosoAPI ·
Pilih titik awal Anda
SosoAPI memberi agen yang sudah Anda gunakan satu koneksi ke akun sosial. Agen membantu menulis dan meninjau konten; SosoAPI menangani operasi akun yang didukung, penjadwalan, dan hasil penerbitan. Anda dapat meninjau postingan yang sama di aplikasi atau memakai API dari kode sendiri.
Panduan ini dimulai dengan satu orang dan satu akun sosial. Anda akan menghubungkan klien MCP lokal atau terhosting, memilih akses, memeriksa akun sosial, menyiapkan dan menyetujui postingan, lalu membaca hasil aktualnya. Panduan lanjutan membahas CLI dan HTTP API. Pengaturan sendiri tidak memerlukan postingan uji.
Sebelum memulai
Anda memerlukan klien AI yang kompatibel dengan MCP, akun SosoAPI, dan akun sosial yang boleh Anda kelola. Anda dapat membuat akun SosoAPI saat halaman masuk terbuka. Siapkan satu konten nyata yang ingin dibuat.
MCP lokal memerlukan Node.js 20 atau lebih baru dengan npm/npx dan klien AI pilihan Anda. MCP terhosting memerlukan klien yang mendukung MCP jarak jauh, OAuth, dan registrasi klien otomatis; tidak perlu instalasi Node.js lokal. Fitur klien dapat bergantung pada paket dan pengaturan administrator.
SosoAPI menghubungkan Instagram, Threads, Facebook Pages, YouTube, dan X. Pilih akun yang jenis, izin, dan format postingannya sesuai dengan tugas Anda. Akun Threads yang memenuhi syarat adalah contoh awal yang berguna untuk teks saja. Instagram dan YouTube memerlukan media yang sesuai dengan format penerbitan yang didukung. Platform dalam menu koneksi tidak berarti setiap tindakan tersedia untuk setiap akun.
Periksa kemampuan khusus akun saat pengaturan. Baca paket dan kuota terkini di aplikasi sebelum menjadwalkan batch; X memiliki kuota kredit Organization terpisah. Contoh satu platform tidak membuktikan dukungan pada platform lain.
1. Beri agen permintaan pengaturan
Tempel ini ke percakapan Claude Code atau Codex yang sudah ada.
Agen harus memeriksa koneksi SosoAPI yang berfungsi dahulu dan menggunakannya kembali. Jika tidak, ikuti panduan pengaturan dan beri tahu kapan perlu masuk browser atau mulai ulang klien. Hasil yang diharapkan: alat SosoAPI dapat digunakan dalam percakapan ini. Pesan instalasi saja bukan bukti. Lanjutkan dengan masuk dan pemeriksaan akun, atau gunakan langkah 3 untuk konfigurasi manual.
Siapkan SosoAPI dari https://sosoapi.ai/setup.md. Pertahankan konten dan tugas saya saat ini. Saya akan masuk dan menyetujui akses saat diminta. Jangan publikasikan apa pun selama pengaturan.
2. Masuk dan pilih akses agen Anda
Gunakan akun yang dituju: lanjutkan dengan Google, atau daftar lewat email dan selesaikan verifikasi. Selesaikan pengaturan akun atau Workspace yang ditampilkan. Jika tergabung dalam beberapa Workspaces, pilih merek atau proyek yang dituju. Tinjau Workspaces dan tindakan yang diminta sebelum menyetujui, lalu kembali ke percakapan yang sama.
Simpan tautan masuk dari agen agar browser dapat kembali ke otorisasi tertunda. Anda dapat memulai di aplikasi dahulu, lalu kembali ke agen. Jangan mengganti tautan persetujuan tertunda dengan tautan masuk lain.
Peran Workspace dan izin platform tetap berlaku: viewer tidak menjadi editor karena agen memiliki akses penerbitan. Akses penerbitan berlanjut dalam cakupan yang Anda berikan; SosoAPI tidak memerlukan persetujuan browser baru untuk setiap postingan. Beri tahu agen kapan harus berhenti untuk tinjauan konten. Pengaturan OAuth biasa tidak memerlukan menempelkan kata sandi sosial atau kunci API ke agen.
Hasil yang diharapkan: masuk selesai dengan identitas yang dituju, dan agen dapat mengambil Workspaces yang Anda izinkan. Gunakan pemecahan masalah jika profil browser yang salah terbuka.
| Pilihan akses | Kegunaannya |
|---|---|
| Baca, buat, dan edit | Baca informasi akun yang tersedia dan siapkan pekerjaan. |
| Jadwalkan dan terbitkan | Kirim dan kelola pekerjaan penerbitan dalam cakupan yang dipilih. |
| Izin tambahan | Aktifkan hanya untuk kebutuhan tertentu. Posting biasa tidak memerlukan pengelolaan kunci API. |
3. Hubungkan agen secara manual bila perlu
Pilih satu metode koneksi. Lewati bagian ini jika agen sudah mengonfigurasi koneksi yang berfungsi. Untuk MCP lokal, periksa Node.js dan npx dahulu. Node.js harus versi 20 atau lebih baru.
node --version
npx --versionMCP lokal: Claude Code atau Codex
Jalankan hanya perintah untuk klien Anda: pertama untuk Claude Code dan kedua untuk Codex. Profil core mencakup penerbitan sehari-hari. Profil mengubah alat yang ditampilkan, bukan memberikan izin. Pertahankan koneksi full-profile yang berfungsi jika sudah ada.
Hubungkan ulang atau mulai ulang jika diminta klien, lalu periksa alat SosoAPI tersedia dalam percakapan saat ini. Panggilan terautentikasi pertama memulai login browser bila perlu.
claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapicodex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapiKlien MCP lokal lain
Untuk klien yang memakai JSON mcpServers, tambahkan entri ini ke konfigurasi yang ada dan pertahankan server lain. Format konfigurasi lain harus menerima perintah, argumen, dan variabel lingkungan yang sama melalui pengaturan MCP klien sendiri.
{
"mcpServers": {
"sosoapi": {
"command": "npx",
"args": [
"-y",
"sosoapi"
],
"env": {
"SOSOAPI_TOOL_PROFILE": "core"
}
}
}
}MCP terhosting: browser atau klien jarak jauh yang kompatibel
Di pengaturan konektor khusus atau MCP jarak jauh klien, tambahkan koneksi bernama SosoAPI memakai URL server di bawah. Pilih OAuth dengan registrasi klien otomatis jika ditawarkan. Masuk ke SosoAPI, pilih Workspaces dan tindakan yang diizinkan, kembali ke percakapan, dan aktifkan koneksi bila diperlukan. Minta agen memeriksa akun berizin.
Gunakan https://sosoapi.ai untuk koneksi terhosting baru. Endpoint lama https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp tetap didukung. Pertahankan koneksi lokal atau terhosting yang berfungsi; tidak perlu menggantinya hanya untuk mengubah URL.
Tidak perlu menempelkan kunci API, ID klien, atau rahasia klien. Aplikasi MCP khusus ChatGPT bergantung pada paket klien, mode pengembang, dan pengaturan administrator. Petunjuk ini menjelaskan koneksi khusus, bukan entri direktori aplikasi. MCP terhosting tidak dapat membaca file lokal; gunakan impor URL publik atau MCP lokal untuk unggahan file lokal.
https://sosoapi.aiPemeriksaan masuk terminal opsional
Untuk koneksi lokal, jalankan auth status dahulu. Jalankan auth login hanya jika dilaporkan belum masuk. Selesaikan alur browser dan periksa status lagi. Token tidak dicetak. Ini memeriksa autentikasi CLI lokal, bukan login konektor terhosting terpisah.
npx -y sosoapi auth statusnpx -y sosoapi auth login4. Hubungkan akun sosial Anda
Buka Hubungkan akun, atau gunakan perintah lokal di bawah. Ganti threads dengan instagram, facebook, youtube, atau x sesuai kebutuhan. Ini membuka alur koneksi; tidak menerbitkan konten.
Periksa Organization dan Workspace yang ditampilkan. Pilih platform, masuk melalui halaman otorisasinya, dan pilih akun, Page, atau channel yang tepat. Selesaikan persetujuan dan konfirmasi pemilihan akun saat kembali. Lalu minta agen menyegarkan akun terhubung untuk Workspace tujuan.
Gunakan kembali koneksi sehat yang ada. Jika milik Organization atau Workspace lain, selesaikan pilihan itu di aplikasi; pengaturan rutin tidak boleh memutus atau memindahkannya. Hasil yang diharapkan: akun yang benar muncul di Workspace tujuan dengan informasi kesehatan dan kemampuan terkini. Callback berhasil saja bukan bukti izin penerbitan.
| Tujuan | Yang perlu diperiksa |
|---|---|
| Threads | Profil yang dituju dan izin untuk format teks atau media yang diminta. |
| Pengaturan akun profesional yang didukung dan izin penerbitan untuk format yang diminta. | |
| Page yang Anda kelola dan izin yang diperlukan untuk Page tersebut. | |
| YouTube | Channel yang dituju, terutama jika satu akun Google mengelola beberapa channel. |
| X | Kemampuan teks atau video akun dan sisa kredit X Organization. |
npx -y sosoapi connect threads5. Verifikasi akses tanpa menerbitkan
Tempel yang berikut ke percakapan agen terhubung.
Agen dapat memakai sosoapi_get_workspace_context dan sosoapi_list_connected_accounts, menggunakan kembali konteks yang diketahui, dan memberikan workspace_id pilihan secara eksplisit. Inisialisasi akun dapat membuat Workspace pertama Anda; pemeriksaan pengaturan ini tidak membuat postingan sosial.
Sebelum melanjutkan, konfirmasikan Workspace dan tujuan, peran serta akses agen, dan dukungan tujuan untuk format yang diusulkan. Gunakan pemecahan masalah jika pemeriksaan gagal. Menginstal ulang paket tidak memperbaiki izin platform yang tidak ada.
Periksa pengaturan SosoAPI saya tanpa menerbitkan atau menjadwalkan apa pun. Tampilkan Workspaces yang dapat saya gunakan dan akun sosial di Workspace yang saya pilih. Untuk akun pilihan saya, tampilkan platform, label akun, kesehatan koneksi, dan kemampuan penerbitan untuk format yang saya usulkan. Jika beberapa Workspaces atau akun mungkin cocok, tanyakan mana yang harus digunakan. Simpan ID internal untuk panggilan alat; jangan minta saya mencari atau mengarangnya.
6. Siapkan dan setujui postingan pertama Anda
Mulai dengan satu postingan nyata dan satu tujuan. Ganti bidang dalam kurung siku pada prompt draf ini. Agen menulis; SosoAPI menyediakan koneksi dan operasi penerbitan. Tinjau sendiri klaim, ejaan, tautan, dan media.
Gunakan tanggal, waktu lokal, dan zona waktu IANA yang eksplisit untuk postingan mendatang. Jika waktu musim panas membuat waktu lokal ambigu, pilih kejadian yang dimaksud sebelum mengirim. Hasil yang diharapkan pada tahap ini: draf tepat untuk ditinjau, tanpa permintaan penerbitan terkirim.
Bantu saya menyiapkan satu pengumuman produk memakai SosoAPI. Produk: [nama produk publik] Fakta terverifikasi: [yang tersedia saat ini] Audiens: [siapa yang terbantu] Tujuan: [label akun dan platform] Bahasa: [bahasa] Tanggal dan waktu lokal pilihan: [YYYY-MM-DD HH:mm] Zona waktu: [zona waktu IANA, misalnya Asia/Hong_Kong] Media: [tidak ada, file lokal, atau URL media publik] Gunakan hanya fakta yang saya berikan. Periksa persyaratan format tujuan. Tampilkan draf, media, tujuan, tanggal, waktu, dan zona waktu yang tepat untuk ditinjau. Jangan menjadwalkan atau menerbitkan dahulu.
Setujui postingan tepat sebelum menjadwalkan
Jika semua detail benar, berikan instruksi spesifik memakai prompt di bawah. Ini membuat jadwal sungguhan yang dapat diterbitkan secara publik. Gunakan konten dan akun yang memang ingin Anda tuju. Penerbitan langsung juga memerlukan instruksi eksplisit setelah meninjau detail yang sama.
Hasil yang diharapkan: ID Scheduled Post, tujuan yang dimaksud, waktu diterima, dan status terkini. Jadwal diterima tidak berarti penyedia sudah menerbitkannya.
Jadwalkan postingan persis yang disetujui di bawah ke akun yang disebut pada tanggal, waktu, dan zona waktu yang ditetapkan. [Tempel konten final, media, tujuan, tanggal, waktu, dan zona waktu.] Periksa jadwal cocok yang sudah ada terlebih dahulu. Kirim postingan ini sekali dan baca kembali hasil tersimpan. Kembalikan ID, tujuan, waktu diterima, dan status terkini. Jika hasil tidak pasti, periksa permintaan yang ada sebelum tindakan lain.
7. Periksa hasil, jadwal ulang, atau batalkan
Minta agen membaca Scheduled Post yang sama memakai sosoapi_get_scheduled_post. Anda juga dapat membuka https://app.sosoapi.ai/scheduled-posts/<post-id> setelah masuk dengan akun berizin. Periksa setiap tujuan secara terpisah jika permintaan menargetkan beberapa akun; sebagian dapat berhasil sementara yang lain memerlukan perhatian.
Baca hasil terkini Scheduled Post [ID yang dikembalikan]. Tampilkan tujuannya, waktu terjadwal, status saat ini, dan hasil penerbitan. Jika penerbitan dikonfirmasi, sertakan tautan langsung bila tersedia. Jangan mencoba ulang, menjadwal ulang, atau membuat postingan lain.
| Hasil | Arti | Langkah berikutnya |
|---|---|---|
| Terjadwal | Diterima untuk waktu mendatang. | Simpan ID dan periksa setelah waktunya tiba. |
| Sedang menyiapkan, menerbitkan, atau merekonsiliasi | Pekerjaan sedang berjalan atau hasil akhir penyedia belum diketahui. | Baca postingan yang sama nanti; hindari pengiriman lain. |
| Dipublikasikan | Bukti dari penyedia mengonfirmasi penerbitan. | Buka permalink yang dikembalikan bila tersedia. |
| Gagal atau perlu perhatian | Diperlukan perbaikan tertentu atau tindakan yang diizinkan. | Baca alasan dan tindakan yang tersedia. |
| Perlu dijadwal ulang atau kedaluwarsa | Jadwal asli tidak dapat berjalan sesuai permintaan. | Tinjau penjelasan dan pilih tindakan yang tersedia. |
| Dibatalkan | Pembatalan dikonfirmasi. | Jangan mengharapkan jadwal ini diterbitkan. |
Kelola postingan tertunda dan kembali nanti
Untuk mengubah postingan tertunda, berikan ID dan detail baru. Agen harus membaca versi terkini dan tindakan tersedia sebelum menggunakan pembaruan atau pembatalan yang didukung. Pembatalan bergantung pada tahap pengiriman dan dapat tidak tersedia setelah pengiriman dimulai. Membatalkan jadwal tidak menghapus postingan yang sudah diterbitkan penyedia.
Setelah menerima detail tersimpan untuk jadwal mendatang, Anda dapat meninggalkan percakapan dan kembali ke postingan yang sama nanti. Percakapan agen tertutup tidak menjanjikan bangun sendiri atau memberi tahu Anda kecuali hal itu dikonfigurasi terpisah.
8. Tambahkan gambar atau video, lalu gunakan kembali alurnya
Pastikan alur satu postingan berfungsi sebelum menyiapkan batch lebih besar. Beri tahu agen apakah medianya file lokal, URL publik, atau aset SosoAPI yang ada.
File lokal: MCP lokal dapat memakai sosoapi_upload_asset. File harus berada dalam folder unggahan yang diizinkan; alat menjelaskan lokasi yang diizinkan untuk jalur di luar batas. MCP terhosting tidak dapat membaca file di komputer Anda.
URL publik: gunakan sosoapi_import_asset_url, lalu sosoapi_get_asset_import_status dengan include_asset=true. Tunggu hingga aset siap. Untuk aset yang sudah ada, pastikan aset milik Workspace yang dituju dan siap untuk format pilihan.
Permintaan penjadwalan biasa memakai ID aset terdaftar dan URL aset kanonis bersama-sama. URL pratinjau sementara atau URL sumber eksternal asli bukan penggantinya. Untuk alur satu URL gambar yang didukung, sosoapi_post_image_url menggabungkan impor dan pengiriman. Ini operasi penerbitan: setujui seluruh postingan terlebih dahulu. Simpan ID postingan yang diterima selama pemrosesan; jangan mulai impor lain untuk melanjutkannya.
X mendukung Post TEXT asli tanpa media, atau VIDEO dengan tepat satu aset video MP4 terdaftar yang siap, berdurasi minimal 0.5 detik dan dalam batas unggahan 500 MiB. Video memerlukan can_publish_video terverifikasi untuk akun yang tepat; akses teks saja tidak cukup. Koneksi lama mungkin perlu persetujuan Anda untuk menghubungkan ulang dengan izin unggah video. Semua teks, tagar, dan tautan harus sesuai batas teks berbobot X. Foto, balasan, kutipan, repost, dan penerbitan utas tidak didukung. Penerimaan unggahan atau pemrosesan video bukan hasil terbit.
Sebelum mengirim ke X, baca sosoapi_get_x_usage untuk workspace_id tujuan dan teks final. Kuota dan biayanya terpisah dari kuota paket umum. Jangan melewati batas kredit dengan pengiriman berulang; rekonsiliasi penerbitan tidak pasti sebelum mengirim lagi.
Siapkan batch tertinjau dan baca performa dengan jujur
Setelah postingan pertama berhasil, coba prompt peluncuran produk di bawah. Setelah menyetujui tabel yang tepat, periksa batch terhadap batas paket. Laporkan tujuan diterima dan ditolak secara terpisah, serta simpan identitas setiap postingan yang diterima.
Akses penerbitan dan analitik dapat berbeda. Jika nanti meminta tinjauan performa, metrik yang tidak tersedia harus dilaporkan tidak tersedia. Jangan mengarang nol atau menyimpulkan semua metrik dapat dibaca karena postingan diterbitkan.
Dengan pengaturan terverifikasi yang sama, siapkan tujuh draf pengumuman produk, satu per hari, dari fakta publik yang saya berikan. Tampilkan tabel tinjauan berisi draf, tujuan, media, tanggal lokal, waktu, dan zona waktu untuk setiap baris. Simpan ketujuhnya sebagai draf sampai saya menyetujui tabel yang tepat.
9. Panduan CLI dan API
Gunakan jalur opsional ini untuk file permintaan eksplisit atau integrasi backend. Pengguna agen dapat melewatinya. Contoh memakai akun, Workspace, dan izin penerbitan yang sama dengan MCP.
Periksa bantuan paket terinstal dan kontrak tertanam dahulu; pemeriksaan kontrak tidak perlu login. Ini menunjukkan operasi dan skema yang disertakan paket tersebut. Gunakan nama bidang itu, bukan format permintaan penyedia lain.
npx -y sosoapi --help
npx -y sosoapi api contract --summary
npx -y sosoapi api contract --route /studio-api/scheduled-posts/CLI: buat permintaan konteks terautentikasi pertama
Selesaikan auth login. Dengan editor teks, simpan workspaces.json berisi JSON di bawah, lalu jalankan perintah. Gunakan file untuk isi permintaan alih-alih menyisipkan konten ke perintah shell.
CLI mengembalikan schema_version, http_status, dan body. Respons berhasil mencakup body.active_workspace_id dan body.workspaces. Pilih Workspace yang dituju dari respons itu; Workspace aktif tidak diam-diam menentukan tujuan tugas baru. Panggilan pertama akun baru dapat menginisialisasi Workspace pertamanya.
Periksa http_status dan body, bukan hanya kode keluar shell. Perintah dapat mengembalikan amplop kesalahan HTTP tanpa operasi API berhasil.
{}npx -y sosoapi api post /identity-api/workspace/list < workspaces.jsonCLI: pilih akun sosial terhubung
Simpan accounts.json memakai ID Workspace yang dikembalikan untuk akun Anda, lalu jalankan perintah. Pilih akun yang dituju dari body.accounts. ID akun SosoAPI-nya adalah social_account_id untuk penjadwalan; nama pengguna atau ID Page penyedia bukan pengganti.
{
"workspace_id": "<YOUR_WORKSPACE_ID>"
}npx -y sosoapi api post /identity-api/user/social-accounts/list < accounts.jsonCLI: buat satu jadwal teks Threads yang disetujui
Ini templat permintaan, bukan postingan siap dijalankan. Simpan post.json memakai editor file dan ganti setiap nilai dalam kurung siku dengan nilai berizin Anda sendiri. Pilih timestamp ISO mendatang dengan offset UTC eksplisit, atau Z untuk UTC. display_timezone adalah zona waktu IANA untuk tampilan; ini tidak melengkapi timestamp lokal yang ambigu.
Buat idempotency_key unik, misalnya UUID, dan simpan bersama isi permintaan yang persis sama. Ulangi permintaan identik dengan kunci yang sama; respons terlambat bukan alasan membuat kunci lain. Postingan yang berubah adalah permintaan berbeda: periksa hasil asli sebelum memilih identitas baru.
Setelah mengonfirmasi konten, akun, waktu, izin, dan kuota saat ini, jalankan perintah create. Ini menjadwalkan postingan sungguhan. Saat diterima, simpan body.post.id dan baca body.post.status, body.post.scheduled_at, serta body.post.destination. body.deduped menunjukkan apakah permintaan yang ada digunakan kembali. Penerimaan bukan penerbitan yang dikonfirmasi penyedia.
{
"workspace_id": "<YOUR_WORKSPACE_ID>",
"social_account_id": "<YOUR_THREADS_ACCOUNT_ID>",
"caption": "<YOUR_APPROVED_POST_TEXT>",
"hashtags": [],
"media": [],
"provider_payload": {
"platform": "threads",
"publish_options": {
"post_type": "TEXT"
}
},
"scheduled_at": "<FUTURE_ISO_8601_TIME_WITH_OFFSET>",
"display_timezone": "Asia/Hong_Kong",
"idempotency_key": "<NEW_STABLE_REQUEST_KEY>"
}npx -y sosoapi api post /studio-api/scheduled-posts/create < post.jsonCLI: baca postingan tersimpan dan hasilnya
Simpan post-status.json dengan ID yang dikembalikan. Baca body.post, body.delivery, body.actions, dan body.outcomes. Konfirmasikan hasil terbit sebelum melaporkan berhasil. Jika respons create hilang, pulihkan permintaan asli memakai identitas tersimpannya; jangan buat jadwal lain dengan kunci baru.
{
"id": "<RETURNED_POST_ID>"
}npx -y sosoapi api post /studio-api/scheduled-posts/get < post-status.jsonCLI: batalkan hanya jika hasil terkini mengizinkannya
Jika pembacaan terbaru mengizinkan pembatalan dan Anda memang ingin membatalkan, simpan cancel.json dengan ID yang dikembalikan dan angka body.post.version terkini. Contoh 1 hanya ilustrasi: ganti dengan versi yang baru dibaca. Lalu jalankan perintah dan konfirmasikan hasilnya.
Jika versi berubah atau pembatalan tidak tersedia, baca postingan yang sama lagi dan gunakan tindakan aktual yang tersedia. Jangan melewati konflik versi atau menyamakan pembatalan dengan menghapus postingan yang sudah diterbitkan.
{
"id": "<RETURNED_POST_ID>",
"expected_version": 1
}npx -y sosoapi api post /studio-api/scheduled-posts/cancel < cancel.jsonHTTP: panggil dari backend Anda
Untuk integrasi server, buat kunci API di Connection → API dan simpan rahasianya dalam konfigurasi rahasia server. Layar saat ini meminta nama, tanpa pemilih Workspace atau kemampuan. Kunci buatan pengguna secara default memberi operate, publish, dan engage di Workspaces yang dapat diakses pengguna. Periksa kesesuaian wewenang itu untuk integrasi Anda. Kontrak API mendukung kemampuan yang dibatasi secara eksplisit dan workspace_ids untuk kunci bercakupan terbatas.
Pengaturan agen biasa memakai OAuth dan tidak memerlukan langkah kunci API ini. Dalam contoh, SOSOAPI_ACCESS_TOKEN adalah variabel contoh di server Anda yang berisi kunci, bukan pengaturan CLI SosoAPI. Variabel token akses pribadi opsional CLI adalah VICKY_API_KEY.
Gunakan file workspaces.json di atas. HTTP langsung mengembalikan isi endpoint tanpa amplop http_status/body milik CLI; baca status HTTP aktual dan JSON. Simpan kredensial di backend, bukan dalam kode browser, prompt, tangkapan layar, atau file permintaan bersama.
Menyematkan koneksi sosial ke produk untuk pelanggan Anda sendiri merupakan tugas integrasi terpisah. Panduan satu akun ini tidak membuktikan alur onboarding pelanggan tersebut siap.
curl --fail-with-body --silent --show-error \
-H "Authorization: Bearer ${SOSOAPI_ACCESS_TOKEN}" \
-H 'Content-Type: application/json' \
--data-binary @workspaces.json \
'https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/workspace/list'10. Pemecahan masalah
Gunakan kesalahan aktual dan koneksi yang sedang didiagnosis. Memperluas izin atau mengulangi pengiriman tidak memperbaiki setiap kegagalan.
| Gejala | Yang perlu diperiksa atau dilakukan |
|---|---|
| node atau npx tidak tersedia | Instal runtime Node.js yang didukung untuk MCP lokal, atau gunakan MCP terhosting yang kompatibel. |
| npx sosoapi tampak menunggu selamanya | Tanpa perintah, ini adalah server stdio MCP yang menunggu kliennya. Gunakan --help untuk petunjuk terminal. |
| Terinstal, tetapi tidak ada alat dalam percakapan | Hubungkan ulang atau mulai ulang klien aktual dan aktifkan SosoAPI dalam percakapan saat ini. |
| Masuk membuka profil browser yang salah | Hentikan login lokal Anda yang tertunda. Konfirmasikan --no-open tersedia lewat --help, lalu jalankan npx -y sosoapi auth login --no-open. Buka tautan baru di profil yang dituju dan verifikasi identitas sebelum menyetujui. Jangan memakai dua profil bersamaan pada satu tautan. |
| Port 8789 sedang digunakan | Periksa dengan lsof -nP -iTCP:8789 -sTCP:LISTEN. Hentikan listener hanya jika itu proses masuk tertunda milik Anda sendiri. |
| Verifikasi email atau masuk gagal | Baca kesalahan aktual dan gunakan percobaan ulang yang ditawarkan. Masuk lewat email memakai verifikasi latar belakang, tanpa kotak CAPTCHA yang perlu dicari. Lanjutkan dengan Google adalah opsi lain. |
| Respons 401 | Periksa login koneksi ini dan validitas kredensialnya. auth status lokal tidak memeriksa konektor terhosting. |
| 403 atau tindakan penerbitan tidak ada | Periksa Workspace pilihan, peran, dan kemampuan yang diberikan. Minta akses yang diperlukan kepada pemilik jika sesuai. |
| Akun sosial yang diharapkan tidak ada | Periksa identitas, Workspace, dan pilihan akun penyedia. Selesaikan konfirmasi koneksi yang tertunda. |
| Terhubung, tetapi posting tidak tersedia | Baca kemampuan akun yang tepat dan persyaratan platform. Hubungkan ulang hanya jika persetujuan penyedia baru memang diperlukan; akses video dapat berbeda dari teks. |
| Jalur unggahan di luar folder yang diizinkan | Gunakan folder yang diizinkan atau atur SOSOAPI_UPLOAD_ROOTS secara sengaja di lingkungan MCP lokal. |
| Impor media masih tertunda | Periksa impor dan ID tugas yang ada. Laporkan kesalahan eksekusi atau konfigurasi, bukan membuat impor duplikat. |
| Kuota atau kredit X habis | Baca kuota terkait dan pilih tindakan jadwal atau paket yang diizinkan. Pengiriman berulang tidak menghapus batas. |
| Permintaan create habis waktu | Simpan kunci permintaan dan ID postingan yang diterima jika diketahui. Baca atau pulihkan permintaan asli sebelum mencoba lagi; percobaan ulang identik mempertahankan kuncinya. |
| Pembaruan atau pembatalan mengalami konflik versi | Baca postingan yang sama lagi, periksa tindakan tersedia, dan gunakan versi terkini hanya untuk tindakan yang dimaksud. |
| Kesalahan skema atau ketidakcocokan versi | Perbarui paket yang benar-benar dijalankan klien MCP, hubungkan ulang, dan periksa kontraknya. Izin tambahan tidak memperbaiki ketidakcocokan skema. |
Perbarui, cabut akses, atau minta bantuan
Perintah pertama di bawah memeriksa bantuan paket terbaru tanpa memulai server MCP. Jika klien menyematkan versi di perintah tersimpan, perbarui perintah itu secara sengaja. Memperbarui instalasi global terpisah tidak memperbarui salinan versi tersemat milik klien.
Untuk mencabut perangkat lokal, gunakan Connection → Agent atau perintah auth logout di bawah. Cabut otorisasi terhosting yang cocok di Connection → Agent untuk konektor terhosting. Kunci API dikelola terpisah di Connection → API. Mencabut akses agen tidak membatalkan jadwal yang sudah diterima; kelola postingan itu secara terpisah.
Untuk bantuan, berikan klien dan versi paket, langkah yang gagal, kesalahan ditampilkan, dan waktu/zona waktu. Bagikan ID permintaan atau postingan terkait secara pribadi kepada dukungan bila perlu. Jangan kirim kredensial, tautan otorisasi, atau log mentah yang mungkin berisi token.
npx -y sosoapi@latest --helpnpx -y sosoapi auth logoutDaftar periksa penyelesaian pengaturan
Anda dapat menyelesaikan pengaturan koneksi tanpa mengirim postingan. Jika menerbitkan, gunakan pemeriksaan hasil terpisah untuk mengonfirmasi alur penerbitan pertama itu.
- Klien saya dapat memakai alat SosoAPI, atau CLI/API saya dapat membuat permintaan berizin.
- Saya masuk dengan akun yang dituju dan memilih Workspace yang benar.
- Akun sosial saya muncul dengan kemampuan yang diperlukan untuk tugas.
- Saya memahami apakah agen dapat menyiapkan pekerjaan atau juga menjadwalkan dan menerbitkan.
- Saya dapat menyiapkan draf dan meninjau tujuan, konten, serta waktu yang tepat.
- Jika saya mengirim postingan, saya menyimpan ID-nya dan dapat membedakan penerimaan dari penerbitan terkonfirmasi.
- Saya tahu cara memeriksa kegagalan, mengelola jadwal tertunda, dan mencabut akses.