Dokumentasi pengembang
Bahasa Indonesia

Memulai

Berbicara dengan agen AI

Bot membalas pesan dan juga menerima telepon — bot yang sama di desktop, ponsel, dan Apple Watch, agen yang bisa dibuat siapa saja, ke mana data pergi, dan apa yang bisa Anda tentukan sendiri.

Dengan bot suara, Pabal menjadi tempat untuk berbicara dengan agen AI. Bot membalas pesan, dan juga menerima telepon. Anda bisa bertanya lewat teks kepada sebuah bot dari komputer, meneleponnya dari ponsel, lalu melanjutkannya dengan Apple Watch saat berolahraga. Halaman ini mengumpulkan semua itu di satu tempat — apa yang bisa dilakukan, ke mana data pergi, dan apa yang bisa ditentukan oleh pihak yang menjalankan server. Caranya secara rinci ada di Menggunakan aplikasi (untuk penelepon), Bot suara (untuk pembuat bot), dan Instalasi server (untuk yang menjalankan server).

Masih disiapkan

Bot suara, aplikasi jam tangan untuk Apple Watch, dan Simpan percakapan yang dijelaskan di halaman ini belum bisa dipakai di pabal.me. Semuanya sedang diuji di server pengembangan dan baru akan dinyalakan setelah tinjauan hukum dan rilis aplikasi selesai. Status saat ini ada di tabel di bagian bawah.

Apa yang berubah

  • Bot menerima telepon. Saat Anda menelepon bot, model suara AI Pabal yang menjawab dan membalas dengan suara. Bot selalu mengaku sebagai AI dan tidak berpura-pura menjadi manusia.
  • Teks dan telepon ada di satu obrolan. Setelah panggilan selesai, catatan panggilan tertinggal di obrolan dengan bot itu. Jika mau, Anda juga bisa menyimpan percakapan panggilan sebagai teks (Simpan percakapan).
  • Siapa saja bisa membuatnya. Orang yang membuat bot menyalakan suara di @BotFather dan menentukan lewat instruksi apa tugas bot itu. Ia juga bisa membuat bot memanggil sistem miliknya (seperti pencarian pesanan atau pengecekan reservasi) selama panggilan.
  • Penelepon mengonfirmasi lebih dulu. Sebelum menelepon, layar konfirmasi "An AI answers this call" ("Panggilan ini dijawab oleh AI") menunjukkan ke mana audio dikirim, dan hanya orang berusia 19 tahun ke atas yang boleh menelepon.

Satu agen, semua perangkat

Perangkat pengguna Pabal (server operator) Di luar Pabal Aplikasi desktop Mac · Windows Aplikasi ponsel Android · iPhone Aplikasi jam tangan Hanya panggilan · segera pabal-server Satu obrolan dengan bot — sama di semua perangkat Catatan panggilan · teks disimpan (jika dipilih) Persetujuan · penerimaan · batas Sakelar operator (darurat · izin · publik) Akun dan pesan disimpan di sini pabal-voice Gateway suara Membuka audio → model Tidak menyimpan audio Program pemilik bot Bot API · voice_call Tool · server MCP Transkrip (jika aktif) Google Vertex AI Gemini Live (bawaan) us-central1 · Amerika Serikat Server pengembang bot Mode stream (wss) Menerima audio apa adanya ① ② Audio — aplikasi: relay (coturn) Jam tangan: pintu masuk (WSS) ③ link ④ ⑤ ⑥
Satu bot dari perangkat mana pun — catatan di server operator, audio ke tujuan yang sudah ditentukan

Penjelasan diagram

  • Tiga area: kiri adalah perangkat pengguna, tengah adalah server pihak yang menjalankan Pabal, kanan adalah yang berada di luar Pabal. Kotak merah adalah tempat audio panggilan keluar dari Pabal.
  • ①②: aplikasi desktop dan ponsel sampai ke server lewat koneksi yang biasa dipakai (MTProto), sedangkan aplikasi jam tangan lewat pintu masuk HTTPS khusus jam tangan. Dari perangkat mana pun Anda menelepon, catatan panggilan tertinggal di obrolan yang sama dengan bot yang sama, dan akun serta pesan disimpan di server operator.
  • Garis putus-putus abu-abu adalah audio panggilan: aplikasi melewati relay panggilan (coturn), jam tangan melewati pintu masuk audio (WSS), untuk sampai ke gateway suara. Karena gateway membuka audio untuk diteruskan ke model, panggilan dengan bot tidak dienkripsi ujung ke ujung.
  • ③ Link: server meneruskan panggilan yang diterimanya ke gateway, bersama instruksi, salam pembuka, suara, bahasa, dan tool yang ditetapkan pemilik bot. Aturan dasar Pabal (mengaku sebagai AI, dan sebagainya) selalu didahulukan.
  • ④: program pemilik bot menerima notifikasi panggilan (voice_call) dan kueri tool dari model, lalu menjawabnya (panah abu-abu). Server MCP milik pemilik bot juga termasuk di sini. Pemilik bot tidak menerima audio panggilan.
  • ⑤⑥: audio panggilan terkelola dikirim ke Google (Gemini Live di Vertex AI, us-central1 di Amerika Serikat) — atau, jika pemilik bot memakai kunci modelnya sendiri, ke akun penyedia milik pemilik itu. Jika botnya memakai mode stream, yang menerima audio apa adanya adalah server pengembang bot, bukan Google (garis putus-putus merah).

Contoh satu hari

  1. Pagi, lewat teks di komputer. Di aplikasi desktop, Anda bertanya lewat teks kepada bot asisten pesanan: "Pesanan saya kemarin kapan sampai?" Program pemilik bot membalas lewat teks.
  2. Siang, lewat telepon di ponsel. Anda menekan tombol telepon di bagian atas obrolan dengan bot yang sama. Setelah membaca layar konfirmasi dan menekan "I'm 19 or older · Call" ("Saya berusia 19 tahun ke atas · Telepon"), bot menyapa setelah pengumuman suara tentang AI. Selama panggilan, model mencari pesanan dengan tool milik pemilik bot lalu memberitahukannya.
  3. Sore, sambil berlari, dengan jam tangan. Walau iPhone ditinggal di rumah, Anda bisa menelepon bot yang sama dengan aplikasi jam tangan untuk Apple Watch. Sebaiknya dengarkan dengan AirPods.
  4. Setelah selesai, simpan sebagai teks. Jika di layar konfirmasi Anda memilih "Keep this call's conversation as text in my chat" ("Simpan percakapan panggilan ini sebagai teks di chat saya"), setelah panggilan selesai percakapan itu tertinggal sebagai pesan senyap tepat di bawah catatan panggilan di obrolan Anda (Simpan percakapan). Hanya Anda yang melihatnya; teks itu tidak dikirim ke bot maupun pemilik bot.
Batasan yang perlu diketahui
  • Selama menelepon dengan jam tangan, Anda tidak bisa melihat layar aplikasi olahraga. Jika Anda membuka aplikasi olahraga saat panggilan berlangsung, jam tangan menampilkan "End Call to Continue" (panggilan harus diakhiri untuk melanjutkan).
  • Aplikasi jam tangan belum menangani pesan. Aplikasi ini hanya untuk menelepon bot suara. Anda tidak bisa mendaftar di jam tangan; masuklah dengan akun yang sudah ada.
  • Model dalam panggilan tidak otomatis mengetahui teks di obrolan. Agar panggilan melanjutkan apa yang Anda bicarakan lewat teks pagi tadi, pemilik bot harus memberitahukannya saat panggilan dimulai dengan sendVoiceCallContext. Sebaliknya, teks percakapan yang disimpan juga tidak dikirim ke bot, jadi bot tidak tahu isi panggilan.
  • Bot yang memakai tool, server MCP, kunci sendiri, mode stream, atau transkrip pemilik bot belum bisa ditelepon dari jam tangan.

Siapa saja bisa membuatnya

Agen AI dimulai dari satu akun bot. Setelah membuat bot dengan Membuat bot:

  • Menyalakan suara: di @BotFather, /mybots → bot → panggilan suara; setujui aturannya lalu nyalakan (Menyalakan panggilan suara).
  • Apa tugas bot: tentukan instruksi, salam pembuka, dan suaranya. Bot bisa berbicara dalam 9 bahasa, termasuk bahasa Korea dan Inggris (Pengaturan, Suara dan bahasa).
  • Menghubungkan dengan sistem Anda: tool (Bot API) yang membuat model memanggil kode bot selama panggilan, atau server MCP yang sudah ada.
  • Audio ke server Anda: mode stream, tempat server Anda sendiri menerima audio panggilan secara langsung alih-alih model AI, dan kunci model sendiri agar biayanya ditagihkan ke akun Anda.
  • Catatan: transkrip, yang membuat pemilik bot menerima teks percakapan (penelepon mendengar pengumuman saat tersambung). Ini berbeda dari Simpan percakapan yang dipilih oleh penelepon.

Ke mana data pergi

Panggilan dengan bot tidak dienkripsi ujung ke ujung

Panggilan antarmanusia dienkripsi sehingga hanya kedua perangkat yang bisa membukanya, tetapi pada panggilan dengan bot, gateway suara Pabal membuka audio lalu meneruskannya ke model AI (atau, pada mode stream, ke server pengembang bot). Sebelum menelepon, layar konfirmasi memberi tahu hal ini beserta ke mana audio dikirim.

ApaKe manaBerapa lama
Akun, pesan, pesan catatan panggilanServer operator (basis data)Sampai dihapus
Audio panggilan terkelolaDibuka oleh gateway suara lalu dikirim ke Google (Gemini Live API di Vertex AI, Iowa, Amerika Serikat, us-central1)Pabal tidak menyimpannya. Google tidak menyimpannya setelah membuat jawaban, tetapi konten yang dicurigai sebagai penyalahgunaan oleh pemeriksaan otomatis bisa dicatat hingga 90 hari (sama dengan isi layar konfirmasi)
Audio panggilan dengan kunci sendiriAkun penyedia yang dipilih pemilik botAturan penyedia itu
Audio panggilan mode streamServer pengembang bot (wss)Tanggung jawab pengembang bot
Nilai yang dipakai toolProgram pemilik bot · server MCP pemilik botTanggung jawab pemilik bot. Angka yang tampak seperti nomor kartu atau NIK tidak diteruskan
Transkrip pemilik bot (jika dinyalakan)Diserahkan satu kali kepada pemilik botPabal menghapus yang tidak diambil setelah 24 jam
Simpan percakapan (hanya jika dipilih)Hanya di obrolan milik orang itu sendiri — tidak dikirim ke bot maupun pemilik botSampai dihapus
Metadata panggilan (siapa, kapan, berapa lama)Server operator180 hari

Yang diterima pemilik bot adalah nama penelepon, nomor akun, dan bahasa aplikasinya, waktu dan durasi panggilan, serta nilai yang dipakai tool. Nomor telepon, nama pengguna, dan audio panggilan tidak diterima. Agar sesuai dengan isi layar konfirmasi, operator harus mematikan cache data Vertex (Instalasi server — Kunci Vertex AI).

Yang bisa kita tentukan sendiri

Perusahaan atau organisasi yang menjalankan Pabal sendiri bisa memilih ke mana percakapan dengan agen AI pergi.

  • Menjalankan server sendiri — akun, pesan, dan catatan panggilan ada di server dan basis data milik sendiri (Instalasi server).
  • Kunci model milik pemilik bot — panggilan dijalankan dengan akun penyedia yang dikontrak pemilik bot, bukan kunci bawaan Pabal (Kunci model sendiri).
  • Mode stream — audio panggilan diterima oleh server milik sendiri, bukan Google, lalu dijawab dengan cara yang Anda pilih (Mode stream).
  • Sakelar operator — sakelar darurat yang menghentikan semua panggilan, hanya menerima bot yang diizinkan, penguji, batas, izin transkrip untuk pemilik bot, dan peluncuran publik (Administrasi dan pengaturan — Tab Suara).

Jadi yang dijanjikan Pabal adalah "komunikasi dengan agen AI yang memungkinkan Anda menentukan sendiri ke mana data pergi". Itu tidak berarti "semuanya tetap di dalam server" — audio panggilan dengan mesin bawaan dikirim ke Google di Amerika Serikat, dan jika memakai mode stream, tool, atau MCP, audio atau data dikirim ke server pemilik bot atau pengembang bot.

Status saat ini (pabal.me)

Fiturpabal.meCatatan
Panggilan bot suaraMatiSedang diuji di server pengembangan. Bagian panggilan bot di kebijakan privasi dan build aplikasi yang berisi layar konfirmasi harus ada lebih dulu (Bot suara — status saat ini)
Aplikasi jam tangan untuk Apple WatchSedang disiapkanHanya uji internal (TestFlight). Hanya untuk panggilan bot suara
Simpan percakapanMatiTeks layar konfirmasi belum ditinjau secara hukum
Panggilan dari botMati — menunggu tinjauan hukumBagiannya dalam kebijakan privasi dan ketentuan, serta versi aplikasi dengan layar izin, harus ada lebih dulu (Bot suara — Panggilan dari bot)
ToolMatiPanggilan bot suara harus menyala lebih dulu
Server MCP · kunci model sendiri · mode streamMatiMenunggu versi layar konfirmasi aplikasi yang menampilkan penerima tersebut

Tabel ini berdasarkan keadaan per 2026-10-02. Server lain bisa berbeda, tergantung apa yang dinyalakan operatornya — apakah bot Anda bisa menerima telepon, dapat dilihat dari getVoiceCallSettings.