Your AI Connector Docs

Ponsel Android sebagai SMS Gateway (Beta)

Gunakan ponsel Android Anda sendiri sebagai pengirim SMS. Alih-alih menghubungkan akun Twilio, Anda menginstal aplikasi sumber terbuka (open-source) kecil di ponsel Android, memasangkannya dengan ruang kerja Anda, dan pesan teks Anda akan dikirim serta diterima melalui nomor dan paket operator ponsel tersebut.

Saluran beta. Gateway SMS Android kini tersedia bagi siapa saja yang memiliki paket dengan kuota saluran, namun fitur ini masih baru — harap maklum jika ada kendala teknis, dan perlu diketahui bahwa perilaku serta batasan dapat berubah seiring dengan pengembangan saluran ini. Jika ada sesuatu yang tidak berfungsi sebagaimana mestinya, beri tahu tim dukungan.

Mengapa Menggunakan Ini

Gateway Android dibuat untuk SMS percakapan bervolume rendah — membalas prospek, percakapan AI, dan pengiriman pesan satu-ke-satu. Ini adalah pilihan yang tepat jika:

  • Anda ingin tetap mengirim pesan dari nomor pribadi atau bisnis Anda yang sudah ada.
  • Twilio terlalu berlebihan atau harganya kurang sesuai untuk negara atau volume pesan Anda.
  • Anda lebih memilih menggunakan jatah SMS operator Anda yang sudah ada daripada membayar biaya per pesan.
  • Anda ingin menghindari dokumen pendaftaran operator (A2P 10DLC dan sejenisnya) yang diwajibkan oleh Twilio.

Ini tidak dibuat untuk pengiriman siaran massal — lihat Batasan di bawah.

Pilih Twilio untuk skala dan keandalan. Jika Anda mengirim dalam volume besar, memerlukan waktu aktif yang terjamin, atau menjalankan siaran SMS massal, hubungkan nomor Twilio sebagai gantinya — lihat Pesan SMS. Keduanya adalah transportasi SMS alternatif; pesan, kontak, AI, dan kotak masuk Anda berfungsi sama saja.

Apa yang Anda Butuhkan

  • Ponsel Android dengan kartu SIM aktif dan paket SMS (sangat disarankan menggunakan paket SMS tak terbatas atau kuota besar).
  • Aplikasi “SMS Gateway for Android” gratis dan sumber terbuka dari sms-gate.app — unduh dari situs tersebut atau rilis GitHub-nya. Kami tidak membuat aplikasi ini — ini adalah proyek pihak ketiga.
  • Ponsel harus tetap menyala, terhubung ke internet, dan tidak dibatasi — lihat Menjaga keandalan ponsel.
  • Paket berbayar — gateway Android sudah termasuk dalam kuota saluran Anda.

Tidak ada biaya platform per pesan dan tidak ada tagihan Twilio — Anda menggunakan paket operator ponsel Anda sendiri. Jika AI membuat balasan, balasan tersebut tetap menggunakan kredit AI, sama seperti di setiap saluran.

Menyiapkan Aplikasi Gateway

  1. Instal SMS Gateway for Android dari sms-gate.app di ponsel yang nomornya ingin Anda gunakan.
  2. Buka aplikasinya.
  3. Aktifkan mode Cloud Server (opsi termudah — ini meneruskan melalui server yang dihosting proyek sehingga ponsel Anda tidak memerlukan alamat publik).
  4. Aplikasi akan membuat nama pengguna dan kata sandi di layar beranda. Anda akan menempelkannya ke dalam platform di bagian berikutnya.
  5. (Disarankan) Di aplikasi, buka Pengaturan → Webhook. Webhook adalah pemberitahuan otomatis yang dikirim aplikasi ke platform setiap kali terjadi sesuatu — dalam hal ini, setiap kali pesan masuk.
  6. Salin Kunci Penandatanganan (Signing Key). Menempelkannya ke dalam platform akan menambahkan pemeriksaan tanda tangan tambahan pada pesan masuk.

Mode lokal (lanjutan). Jika Anda lebih suka ponsel berkomunikasi langsung dengan platform melalui jaringan Anda sendiri alih-alih melalui relay cloud, aplikasi ini juga mendukung mode Local Server. Anda perlu mengekspos ponsel pada alamat HTTPS yang dapat dijangkau dan memasukkan alamat tersebut sebagai URL dasar saat menghubungkan. Mode Cloud disarankan untuk hampir semua pengguna.

Menghubungkan Ponsel ke Platform

  1. Di bilah sisi kiri, klik Settings di dekat bagian bawah.
  2. Di rel kiri Settings, di bawah Channels, klik Channels.
  3. Temukan kartu Android SMS Gateway dan klik Connect.
  4. Masukkan Phone number — nomor telepon itu sendiri dalam format internasional (E.164), contohnya +14155551234.
  5. Masukkan Gateway username dan Gateway password dari layar beranda aplikasi gateway.
  6. Secara opsional, tempel Webhook signing key (disarankan) dari pengaturan Webhooks aplikasi.
  7. Klik Connect.

Platform memvalidasi kredensial, mendaftarkan webhook pesan dan pengiriman di gateway untuk Anda, lalu mengubah status menjadi Terhubung. Tidak perlu menyalin-tempel URL webhook ke dalam aplikasi — pendaftaran dilakukan secara otomatis.

Memeriksa Status

Setelah terhubung, tombol kartu berubah dari Connect menjadi Manage. Klik tombol tersebut untuk membuka kembali panel gateway, di mana Anda dapat menemukan Refresh status kapan saja. Tombol ini memeriksa kembali apakah gateway dapat dijangkau dan menunjukkan apakah ponsel saat ini online. Jika ponsel dalam mode tidur atau offline, Anda akan melihat indikator offline yang jelas sehingga Anda tahu pesan teks tidak akan terkirim sampai ponsel kembali aktif.

Memutuskan Koneksi

Klik Manage pada kartu untuk membuka kembali panel gateway, lalu klik Disconnect. Platform akan menghapus webhook yang didaftarkannya pada gateway dan menghapus koneksi. Pesan teks Anda kemudian akan beralih kembali ke Twilio jika Anda memiliki nomor SMS Twilio yang terhubung, atau SMS akan dinonaktifkan jika tidak.

Bagaimana Pesan Mengalir

Masuk

  1. Seseorang mengirim pesan ke nomor ponsel Anda.
  2. Aplikasi gateway di ponsel mendeteksi SMS tersebut dan memberi tahu platform.
  3. Platform membuat kontak (jika baru), memasukkan pesan ke kotak masuk Anda, dan — jika Agen AI yang relevan aktif — ia akan membalasnya.

Keluar

  1. Anda atau AI mengirim balasan dari platform.
  2. Platform menyerahkan pesan ke gateway Anda.
  3. Ponsel mengirimkannya sebagai SMS biasa dari nomor Anda, melalui operator Anda.
  4. Saat operator melaporkan kembali, status pesan diperbarui menjadi Terkirim, lalu Diterima (atau Gagal).

Gateway Android diprioritaskan untuk pengiriman. Selama terhubung, balasan satu-ke-satu dan AI akan dikirim melalui ponsel Anda. Jika Anda juga menghubungkan nomor SMS Twilio, putuskan sambungan gateway Android untuk mengirim pesan tersebut melalui Twilio kembali. Satu pengecualian untuk kedua arah: kampanye dan siaran SMS massal selalu dikirim melalui nomor Twilio Anda, bukan melalui ponsel Android — pengiriman massal dari ponsel pribadi justru merupakan penyebab nomor diblokir, sehingga platform tidak melakukannya.

Batasan

Gateway Android bergantung pada ponsel fisik yang Anda kendalikan, sehingga memiliki batasan yang tidak akan Anda temui di Twilio. Tinjau hal-hal ini sebelum mengandalkannya untuk pengiriman pesan penting.

  • Ponsel harus tetap menyala dan online. Tidak ada ponsel, tidak ada pesan. Pastikan ponsel tetap terisi daya, terhubung ke Wi-Fi atau data, dan dikecualikan dari pengoptimalan baterai.
  • Hanya volume rendah. Operator akan menandai dan membatasi ponsel yang tiba-tiba mengirim banyak pesan. Saluran ini ditujukan untuk percakapan dan balasan satu-ke-satu — bukan siaran massal.
  • Siaran SMS massal tidak didukung di saluran ini. Pengiriman SMS massal memerlukan nomor Twilio yang terhubung; platform akan memberi tahu Anda jika Anda mencoba meluncurkan siaran tanpa Twilio. Jalankan siaran melalui Twilio dan gunakan gateway Android untuk balasan percakapan.
  • Hanya teks. Mengirim dan menerima MMS (media) tidak didukung di saluran ini.
  • Batasan operator berlaku. Tunjangan SMS paket ponsel Anda, batas penggunaan wajar, dan biaya per pesan apa pun adalah urusan antara Anda dan operator Anda.
  • Konfirmasi pengiriman bergantung pada operator Anda. Beberapa operator melaporkan pengiriman dengan andal; yang lain tidak. Status “Terkirim” berarti ponsel telah mengirimkan teks tersebut.
  • Risiko akun / nomor. Menggunakan nomor pribadi untuk pesan bisnis otomatis dapat melanggar ketentuan operator Anda dan dapat menyebabkan nomor tersebut dibatasi atau ditangguhkan jika disalahgunakan. Gunakan dengan bertanggung jawab, dapatkan persetujuan, dan sertakan instruksi untuk berhenti berlangganan.

Menjaga keandalan ponsel

Agar pesan tetap terkirim tanpa gangguan:

  • Nonaktifkan pengoptimalan baterai untuk aplikasi SMS Gateway (Pengaturan Android → Aplikasi → SMS Gateway → Baterai → Tidak dibatasi). Jika tidak, Android mungkin mematikannya di latar belakang.
  • Pastikan layar dapat dijangkau / aplikasi diizinkan berjalan di latar belakang. Ponsel khusus yang selalu terhubung ke daya adalah pilihan ideal.
  • Tetap gunakan Wi-Fi atau data yang stabil. Jika ponsel kehilangan konektivitas, pengiriman akan mengantre atau gagal sampai koneksi kembali.
  • Pastikan kartu SIM aktif dan dalam kondisi baik dengan operator Anda.

Pemecahan Masalah

“Tidak dapat memvalidasi kredensial gateway”

  • Periksa kembali nama pengguna dan kata sandi yang ada di layar utama aplikasi gateway — kredensial ini akan dibuat ulang jika Anda menginstal ulang atau mengatur ulang aplikasi.
  • Pastikan ponsel memiliki internet dan mode Cloud Server diaktifkan di aplikasi.

Status menunjukkan offline / pesan tidak terkirim

  • Buka aplikasi di ponsel dan pastikan aplikasi berjalan dan menunjukkan bahwa aplikasi terhubung ke server cloud.
  • Periksa apakah ponsel tidak dalam mode Doze / penghemat baterai dan apakah aplikasi dikecualikan dari pengoptimalan baterai.
  • Ketuk Segarkan status pada kartu setelah ponsel kembali online.

SMS masuk tidak muncul

  • Pastikan koneksi masih menunjukkan Connected (ketuk Refresh status).
  • Kirim SMS percobaan ke nomor ponsel tersebut dari ponsel lain.
  • Pastikan aplikasi Pesan bawaan ponsel tidak memblokir atau memfilter pengirim.

SMS menunjukkan status “Failed”

  • Operator menolaknya — periksa apakah nomor penerima valid dan dalam format internasional.
  • Pastikan SIM Anda masih memiliki kuota SMS dan nomor tidak ditangguhkan.
  • Laju pengiriman yang sangat tinggi dapat memicu pembatasan oleh operator; perlambat pengiriman dan jaga volume tetap rendah.

Butuh Bantuan?

Gateway SMS Android saat ini dalam tahap Beta. Jika Anda mengalami kendala yang tidak tercakup di sini, hubungi hi@youraiconnector.com dengan menyertakan:

  • Nomor ponsel yang Anda hubungkan (bukan kata sandi).
  • Apakah aplikasi gateway menunjukkan status online di ponsel.
  • Deskripsi masalah dan kapan masalah tersebut terjadi.

Kami akan memeriksanya sesegera mungkin.