# Siapkan SosoAPI untuk orang yang menggunakan asisten ini Gunakan asisten yang sudah digunakan orang tersebut dan pertahankan tugas awal, konten, serta referensi media dalam percakapan ini. Gunakan satu MCP SosoAPI untuk akun terhubung mereka akun sosial. Gunakan kembali koneksi yang ada, atau pilih akses lokal atau hosted di bawah. Pengaturan tidak memublikasikan postingan. Orang tersebut masuk dan memilih apa yang otorisasi di browser mereka. Jangan pernah memasukkan kredensial atau menyetujui persetujuan untuk mereka. Free tidak memerlukan kartu. ## 1. Hubungkan asisten ini Periksa host saat ini dan konfigurasi SosoAPI yang ada terlebih dahulu. Gunakan kembali koneksi yang berfungsi; jangan keluar, menimpa konfigurasi, atau membuat koneksi hanya karena panduan ini dibuka lagi. Untuk shell lokal, periksa bahwa Node.js 20 atau lebih baru dan npx tersedia. Gunakan runtime didukung yang ada. Jika belum tersedia, jelaskan prasyarat dengan bahasa bahasa; jangan otomatis melakukan perubahan sistem berhak istimewa atau global. Claude Code: ```sh claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Codex: ```sh codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi ``` Setelah mendaftarkan server, periksa bahwa Anda dapat memanggil alatnya dalam percakapan. Jika host memerlukan koneksi ulang atau mulai ulang, beri tahu orang tersebut tindakan yang harus dilakukan. Tunggu alat berfungsi sebelum mengatakan koneksi siap. Koneksi baru menggunakan profil core 28 alat yang ada untuk publikasi biasa, media, komentar, dan insight. Koneksi profil full yang berfungsi sebaiknya digunakan kembali. Jika operasi administrasi yang diminta tidak ada, jelaskan bahwa profil full tersedia; menyembunyikan alat tidak memberi atau mencabut izin. Untuk klien khusus browser seperti ChatGPT yang mendukung aplikasi MCP kustom, tambahkan URL MCP jarak jauh dan pilih OAuth dengan pendaftaran klien otomatis: `https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp` Tidak perlu menempelkan kunci API, client ID, atau client secret. Orang tersebut masuk ke SosoAPI dan memilih ruang kerja/tindakannya. Aplikasi kustom ChatGPT bergantung pada paket dan ketersediaan developer mode-nya. Gunakan kembali koneksi lokal atau jarak jauh yang berfungsi koneksi jika sudah dikonfigurasi. X mendukung teks dan tautan orisinal. Setiap organisasi berbagi 10 kredit X Free sekali, atau 100 setiap periode penagihan Pro. Teks biasa menggunakan 1; Post berisi URL menggunakan 10. Baca `sosoapi_get_x_usage` dengan workspace_id sebelum merencanakan penggunaan X. Tidak ada biaya kelebihan penggunaan otomatis; publikasi yang belum pasti menahan kreditnya pencadangan dan harus direkonsiliasi sebelum pengiriman berikutnya. ## 2. Masuk tanpa kunci API Panggilan MCP terautentikasi pertama membuka proses masuk browser dan agen yang ada alur persetujuan. Orang tersebut dapat menggunakan Google, atau mendaftar dan memverifikasi email. Biarkan mereka memilih ruang kerja dan apakah asisten hanya boleh menyiapkan konten atau juga menjadwalkan dan memublikasikan. Jangan meminta mereka menyalin kredensial. Persetujuan publikasi berkelanjutan dalam cakupan terpilih, bukan layar persetujuan untuk setiap postingan. Nonaktifkan pengelolaan kunci untuk posting biasa. Pendaftaran dan masuk dengan email menggunakan verifikasi keamanan latar belakang, tanpa kotak centang yang perlu diselesaikan orang tersebut. Jika verifikasi gagal, laporkan kondisi sebenarnya kesalahan dan gunakan tindakan percobaan ulang yang tersedia; jangan meminta orang tersebut mencari atau mengeklik kotak CAPTCHA. Opsi **Lanjutkan dengan Google** yang ada juga tersedia jika orang tersebut ingin menggunakan Google; Google mungkin memerlukan pemeriksaan identitasnya sendiri. Biarkan orang tersebut memilih akun dan menyetujui akses. Pertahankan tautan masuk/persetujuan saat ini dan tujuan kembalinya; jangan mengganti dengan URL pendaftaran polos atau diam-diam beralih ke identitas maintainer yang ada. Satu kesalahan masuk bukan bukti bahwa semua metode masuk tidak tersedia. Jeda hanya langkah yang memerlukan identitas atau persetujuan orang tersebut. Sementara mereka menyelesaikannya, selesaikan pemeriksaan instalasi dan siapkan draf asli tanpa mengarang akun atau ruang kerja. Jelaskan yang sudah siap dan satu tindakan berikutnya yang diperlukan. Setelah masuk, baca ulang konteks terautentikasi dan lanjutkan tugas yang sama. Jangan nonaktifkan CAPTCHA, gunakan API pendaftaran administrator, minta token, atau mengklaim akun/koneksi siap sebelum alur sebenarnya selesai. Jika alat MCP memerlukan pemuatan ulang host, CLI lokal juga tersedia untuk asisten. Jalankan `npx -y sosoapi auth status` dahulu; gunakan `npx -y sosoapi auth login` hanya saat perlu masuk. Jangan pernah membaca file kredensial atau mencetak token. Jika proses masuk membuka profil browser yang salah, hentikan proses masuk tertunda tersebut sebelum memulai yang baru `npx -y sosoapi auth login --no-open`. Orang tersebut membuka tautan baru yang dicetak dalam profil yang dituju dan memeriksa identitas yang masuk sebelum menyetujui. Jangan pernah menggunakan dua profil secara bersamaan pada tautan yang sama. Gunakan `--help` terlebih dahulu untuk memastikan flag pemulihan ini tersedia di CLI terpasang; jika tidak ada, jelaskan batasan versi alih-alih mengarang flag yang berfungsi. CLI dapat memeriksa kontrak bawaannya: ```sh npx -y sosoapi api contract --summary npx -y sosoapi api contract --route /studio-api/scheduled-posts/ ``` Sintaks permintaan CLI adalah `sosoapi api post < request.json`. Tulis JSON dengan alat file Anda; jangan interpolasikan konten pengguna ke command shell command. Baca http_status dan isi respons, bukan hanya exit code. Kesalahan API bukan keberhasilan. Gunakan hanya rute dan skema dari kontrak bawaan; jangan mengarang nama atau melewati kemampuan yang tidak tersedia. ## 3. Hubungkan akun sosial milik orang tersebut Temukan organisasi dan ruang kerja terautentikasi dari konteks SosoAPI. Jangan pernah menebak pengenal atau diam-diam mengganti ruang kerja lain. Jika ada lebih dari satu merek yang cocok, tanyakan merek yang dimaksud orang tersebut. Gunakan koneksi yang ada jika sehat. Jika tidak, jalankan `npx -y sosoapi connect ` (instagram, threads, facebook, youtube, atau x) atau berikan kepada orang tersebut https://app.sosoapi.ai/connect. Mereka menyelesaikan persetujuan penyedia persetujuan dan tinjau akun persis di browser. Setelah mereka kembali, baca ulang akun dan kemampuan publikasi. Callback koneksi bukan bukti bahwa publikasi diizinkan. Gunakan kembali draf asli; jangan meminta orang tersebut menyalin pengenal internal atau membuat ulang kontennya. ## 4. Selesaikan tugas posting awal Gunakan permintaan orang tersebut yang sudah ada atau tanyakan apa yang ingin dipromosikan. Jangan mengarang postingan uji. Tampilkan akun tujuan persis, konten, media, dan tanggal/waktu lokal sebelum pengiriman pertama. Konfirmasikan zona waktu jika tidak diketahui. Baca fakta kemampuan akun terkini; akun Instagram pribadi atau izin penyedia mungkin memerlukan jenis akun yang didukung atau koneksi ulang. X hanya menerima teks dan tautan orisinal; biarkan media kosong. Media, balasan, kutipan, repost, dan publikasi utas tidak didukung. Untuk tujuan yang mendukung media, daftarkan sebelum menjadwalkan: untuk file lokal gunakan sosoapi_upload_asset dalam folder yang diizinkan; untuk URL eksternal gunakan sosoapi_import_asset_url dan periksa sosoapi_get_asset_import_status dengan include_asset=true hingga impor terbatas siap. asset.id yang siap menjadi media.asset_id dan asset.asset_url menjadi media.url; tidak perlu panggilan get_asset terpisah. Pertahankan identitas impor yang sama, patuhi panduan percobaan ulang, dan hentikan saat mencapai hasil akhir kegagalan. Permintaan berhasil bukan bukti bahwa decoding/impor selesai. Jika progres terhenti, baca sosoapi_job_status menggunakan job_id impor tersebut sebelum menunggu lagi. Tugas tertunda mungkin sudah memuat kesalahan eksekusi. Kesalahan layanan kesalahan konfigurasi memerlukan perhatian operator, bukan impor lain, koneksi sosial baru koneksi atau izin dari orang tersebut. Laporkan penghambat tanpa mengklaim gambar siap. Gunakan ID aset terdaftar yang dikembalikan bersama URL media kanonis. Jangan pernah menjadwalkan URL eksternal asli atau URL pratinjau sementara sebagai pengganti. Gunakan kembali aset siap yang ada hanya setelah memeriksa ruang kerja dan identitasnya. Gunakan sosoapi_get_scheduled_post_eligibility jika pratinjau panduan bermanfaat; bersifat opsional dan tidak menggantikan validasi create/execution kanonis. Gunakan Scheduled Post kanonis alat. Satu postingan adalah satu tujuan. Gunakan idempotency_key yang sama untuk percobaan ulang dari permintaan yang sama persis; draf yang berubah adalah permintaan baru. Setelah timeout, baca postingan yang ada sebelum bertindak lagi. Jangan pernah sembarang mengirim ulang penulisan penyedia yang belum pasti. Pembaruan, pembatalan, dan percobaan ulang eksplisit menggunakan versi terkini dan kelayakan tindakan dari server. Hasil harus membedakan: - Terjadwal: diterima untuk waktu yang ditentukan; belum dipublikasikan. - Sedang diproses atau direkonsiliasi: hasil akhir belum terkonfirmasi; jangan kirim ulang. - Dipublikasikan: hasil akhir yang didukung penyedia mengonfirmasi postingan persis; kembalikan tautan tayangnya saat tersedia. - Gagal atau perlu ditangani: nyatakan yang diketahui dan tindakan berikutnya yang diizinkan; hubungkan ulang hanya akun yang terdampak saat orang tersebut harus memberikan akses lagi. Untuk beberapa tujuan, laporkan masing-masing secara terpisah. Jangan menyebut seluruh tugas berhasil saat hanya sebagian platform berhasil. Untuk jadwal mendatang, kembalikan ID postingan dan waktu diterima; jangan biarkan percakapan menunggu sampai waktu jatuh tempo atau membuat loop polling. Saat kembali, baca postingan yang sama lagi. Orang tersebut juga dapat membuka kembali hasil persis di https://app.sosoapi.ai/scheduled-posts/, menggunakan ID sebenarnya yang dikembalikan oleh SosoAPI. Halaman tersebut memerlukan masuk dengan otorisasi mereka sendiri. Untuk lingkungan kustom lingkungan, gunakan origin aplikasi yang dikonfigurasi secara eksplisit sebagai gantinya. Jangan menjanjikan membangunkan asisten yang ditutup atau mengirim notifikasi berhasil yang belum dikonfigurasi dan diverifikasi. ## Referensi - Panduan awal untuk manusia: https://app.sosoapi.ai/start - Panduan produk: https://sosoapi.ai/id/docs/quickstart - Cakupan didukung: Instagram, Threads, Facebook Pages, YouTube, serta teks orisinal X teks/tautan. Format dan izin berbeda menurut akun; platform lain tidak tersedia hanya karena diminta orang tersebut.