SahabatMobile - Docs
Dokumentasi untuk menyambungkan n8n ke AI Gateway SahabatMobile.
Channel ini membahas n8n dari nol: apa itu, cara tercepat menyambungkannya ke SahabatMobile tanpa mengetik config, model mana yang boleh dipakai, dan cara menangani error. Semua nama tombol dan kolom mengikuti aplikasi n8n yang asli.
n8n adalah aplikasi perakit alur kerja otomatis yang berjalan di komputermu sendiri (laptop atau VPS). Cara pakainya visual: kamu menyusun kotak-kotak bernama node dan menghubungkannya dengan garis. Tiap node mengerjakan satu tugas — misal menerima pesan, memanggil AI, lalu mengirim hasilnya ke WhatsApp.
| Lapis | Letaknya | Perannya |
|---|---|---|
| 1. Workflow n8n | Aplikasi n8n milikmu | Urutan node: terima, proses, kirim |
| 2. Layanan SahabatMobile | Server kami | Verifikasi key, jatah kuota, hitung biaya |
| 3. Model AI | Milik vendor pembuatnya | Menalar dan menyusun jawaban akhir |
Node yang menghubungkan n8n ke layanan AI apa pun bernama HTTP Request — node serbaguna untuk memanggil REST API. Tutorial 2 dan 3 menunjukkan dua cara mengisinya: otomatis dan manual.
n8n punya fitur Import cURL: tempel contoh perintah curl dari dokumentasi, semua kolom node terisi sendiri. Dokumentasi SahabatMobile penuh contoh curl — jadi ini jalan pintas resmi, bukan akal-akalan.
Contohnya ada di Tutorial 4 di bawah
(blok curl ... /chat/completions). Blok dari tutorial
lain atau halaman API Reference juga bisa — semuanya format sama.
Buka node HTTP Request di workflow-mu → tab Parameters → pilih Import cURL → tempel perintahnya ke kotak teks → klik Import. Method, URL, header, dan body langsung terisi. Catatan: impor ini menimpa isi node yang sudah ada, jadi pakai node kosong.
Contoh di docs memakai key palsu (sk-sm-...). Ganti
dengan key paket dari Plan Details atau key PAYG dari
/ai/api-keys. Nilai yang diimpor selalu berupa teks —
kalau ada angka yang harus tetap angka, pindahkan isian body ke
mode JSON.
Isi node HTTP Request dengan tangan, kolom per kolom. Wajib diisi empat: Method, URL, Authentication, dan Body.
Pilih Method: POST, lalu isi URL dengan endpoint chat SahabatMobile:
https://www.sahabatmobile.com/api/v1/chat/completions
Di bagian Authentication, pilih kredensial generik Header Auth (SahabatMobile belum ada di daftar kredensial bawaan n8n, jadi pakai yang generik). Isi dua kolomnya:
| Kolom | Isi |
|---|---|
| Name | Authorization |
| Value | Bearer sk-sm-ISI_KEY_KAMU (ganti dengan key asli) |
Kredensial ini bisa dipakai ulang oleh node lain — cukup pilih dari daftar, tidak perlu mengetik ulang key di tiap node.
Nyalakan Send Body, pilih tipe konten JSON, lalu tulis bodinya:
{
"model": "mimo-v2.5",
"messages": [
{"role": "user", "content": "halo"}
]
}
Ganti model sesuai paketmu (aturan lengkap di
Tutorial 4) dan content
dengan teks yang mau diproses — bisa disambung dari output node
sebelumnya supaya dinamis.
Aturannya sama persis seperti di Hermes dan OpenClaw, karena yang mengatur adalah gateway SahabatMobile, bukan aplikasinya:
mimo atau minimax hanya jalan
kalau kamu punya paket aktif. Tanpa paket: 403 model_requires_package.mimo-v2.5 (128K konteks,
ditanggung kuota). Contoh PAYG: google/gemini-2.5-flash
(dibayar dari saldo).Cara tes paling cepat tanpa membuka n8n: tembak gateway langsung dengan curl memakai key yang sama. Blok ini juga yang dipakai untuk Tutorial 2 (Import cURL):
curl https://www.sahabatmobile.com/api/v1/chat/completions \
-H "Authorization: Bearer sk-sm-KEY_KAMU" \
-H "Content-Type: application/json" \
-d '{"model": "mimo-v2.5",
"messages": [{"role": "user", "content": "halo"}]}'
Kalau curl dibalas tapi node n8n error, masalahnya di sisi node (salah kolom, kredensial belum dipilih, atau body bukan JSON valid). Kalau curl-nya sendiri error, masalahnya di key/paket/kuota:
| Kode | Artinya |
|---|---|
401 |
Key salah. Cek Value Header Auth-nya. |
402 |
Saldo kurang (model di luar paket). |
403 model_requires_package |
Model paket tanpa paket aktif. |
429 |
Kuota/rate limit habis. Cek error.code. |
5h_exhausted,
pace_over, aturan retry) ada di
Tutorial 5 channel Hermes.
Tips n8n: aktifkan opsi Response → Include Response Headers and
Status supaya kode error-nya kelihatan utuh di output node.
Hanya ulangi request untuk 429/5xx; 401/403 diperbaiki dulu penyebabnya.
n8n termasuk aplikasi web yang bisa dipilih sebagai templat saat install/reinstall VPS di portal — sama seperti Hermes dan OpenClaw. Setelah VPS menyala dengan templat n8n, buka aplikasinya dari browser dan buat workflow pertamamu di sana.
Workflow n8n adalah kumpulan node (kotak-kotak) yang disambung garis konektor. Data mengalir mengikuti garis: keluar dari kanan satu node, masuk ke kiri node berikutnya. Contoh workflow AI paling sederhana hanya 3 kotak:
Cara membacanya: kotak 1 pemicu — workflow jalan saat kamu klik Execute Workflow. Garis membawa data ke kotak 2, yaitu node HTTP Request yang sudah diisi seperti Tutorial 3 (atau hasil impor Tutorial 2). Kotak 3 adalah hasil akhirnya: jawaban model tampil di panel output node itu.
Di n8n pilih Start from Scratch (atau Create Workflow). Klik Add first step, cari node pemicu — untuk latihan pakai Manual Trigger supaya jalan saat kamu klik, bukan otomatis terjadwal.
Klik konektor + di kanan node pemicu, cari HTTP Request, lalu isi seperti Tutorial 2 atau 3 (URL, Header Auth, Body JSON berisi model + messages). Garis penghubung muncul sendiri dari kanan node pemicu ke kiri node ini — itu tandanya data akan mengalir ke sana.
Klik Execute Workflow. Tiap node menampilkan hasilnya di panel OUTPUT-nya masing-masing — klik node-nya untuk melihat. Kalau node HTTP Request merah/error, baca pesannya lalu cocokkan dengan Tutorial 5.
Supaya node berikutnya memakai hasil node sebelumnya (bukan teks
statis), tulis rujukan {{ $json["namaField"] }} di
kolomnya — misal pesan user diambil dari output node pemicu. Cara
termudah: seret (drag) nama field dari panel output ke kolom tujuan,
n8n menulis rujukannya sendiri.
Workflow yang sudah benar baru berguna kalau berjalan sendiri. Klik Publish — sejak itu pemicu otomatis (misal terjadwal atau ada pesan masuk) menjalankannya tanpa kamu klik lagi. Selama latihan biarkan tidak ter-publish dulu supaya tidak jalan sendiri.
Apakah halaman ini membantu?
Membeli Paket MiniMax
baru saja • Rp0 • Lihat Paket