Your AI Connector Docs

Penyedia SMS (Bawa Twilio Anda Sendiri)

Halaman ini mengontrol akun Twilio yang digunakan untuk WhatsApp Business API. Secara default, WhatsApp Business API berjalan pada akun Twilio yang dikelola platform — Anda tidak akan pernah melihat Twilio, dan Anda tidak perlu mendaftar Twilio sendiri. Jika Anda telah menghubungkan kunci Anthropic Anda sendiri (BYOK), pesan WhatsApp Twilio terkelola dikenakan biaya 0,05 kredit per pesan, baik masuk maupun keluar. Pada akun lainnya, biaya pengiriman tersebut sudah tercakup dalam tarif kredit AI Anda, sehingga tidak ada biaya terpisah per pesan. (Harga pesan WhatsApp sendiri akan berubah pada 1 Oktober 2026 — lihat Biaya WhatsApp & Perubahan Oktober 2026.) Hal ini hanya relevan jika Anda secara khusus ingin WhatsApp Business API berjalan di akun Twilio Anda sendiri.

SMS selalu menggunakan metode Bring Your Own Twilio. Regulasi SMS (A2P 10DLC, pendaftaran merek, persetujuan ID pengirim) harus diajukan atas nama bisnis Anda sendiri, sehingga platform tidak menyediakan nomor SMS terkelola. Hubungkan SMS secara terpisah menggunakan kartu SMS via Twilio di Pengaturan → Saluran (tersedia juga opsi gateway SMS ponsel Android). Halaman ini — kartu Akun Twilio — mengontrol akun WhatsApp Business API dan tidak mengubah nomor SMS Anda.

Mengapa saya harus mengalihkan WhatsApp Business API ke Twilio saya sendiri?

Kebanyakan pengguna tidak perlu melakukannya. Akun terkelola lebih sederhana:

  • Penyewaan nomor WhatsApp, pengajuan templat, pendaftaran pengirim, dan kesehatan nomor semuanya ditangani untuk Anda. Nomor yang disewa di sini berbiaya setidaknya 50 kredit per bulan, dan biaya sewa tersebut sudah termasuk koneksi WhatsApp — lihat Nomor Telepon.
  • Tidak ada tagihan Twilio terpisah. Jika Anda telah menghubungkan kunci Anthropic Anda sendiri (BYOK), pesan WhatsApp Twilio terkelola dikenakan biaya 0,05 kredit per pesan, baik masuk maupun keluar. Pada akun lainnya, biaya pengiriman tersebut sudah tercakup dalam tarif kredit AI Anda, sehingga tidak ada biaya terpisah per pesan. Lihat Biaya WhatsApp & Perubahan Oktober 2026 untuk perubahan harga WhatsApp yang akan berlaku pada 1 Oktober 2026.
  • Dukungan dapat membantu men-debug masalah pengiriman secara langsung.

Anda mungkin ingin membawa Twilio Anda sendiri jika:

  • Anda sudah memiliki akun Twilio yang mapan dengan template WhatsApp yang disetujui dan nomor yang sudah aktif yang ingin terus Anda gunakan.
  • Perusahaan Anda memiliki alasan pengadaan atau kepatuhan untuk membayar Twilio secara langsung.
  • Anda menginginkan visibilitas penuh terhadap penggunaan dan harga di tingkat operator.

Mempertahankan nomor yang sudah aktif adalah pekerjaan dua langkah. Mengalihkan akun (di bawah) hanya mengubah akun Twilio mana yang kami gunakan untuk mengirim. Nomor WhatsApp Anda yang sudah ada tidak akan muncul sebagai saluran sampai Anda juga melampirkannya — lihat Melampirkan nomor WhatsApp yang sudah Anda miliki. Lakukan sesuai urutan tersebut.

Cara Beralih

Cara menuju ke sana: Pengaturan → grup Saluran → Saluran, lalu temukan kartu Akun Twilio.

Apa yang Anda lihat bergantung pada pengaturan Anda saat ini:

Jika Anda menggunakan akun terkelola (default)

Anda akan melihat penjelasan singkat dan tombol Kelola pada kartu Akun Twilio. Mengekliknya akan membuka formulir Beralih ke akun Twilio Anda sendiri, yang meminta Account SID dan Auth Token Twilio Anda — dengan peringatan tindakan destruktif yang ditampilkan langsung di dalam dialog.

Sebelum Anda mengonfirmasi, baca peringatan dengan saksama — peralihan ini bersifat destruktif:

  • Semua nomor yang Anda beli melalui platform akan dirilis secara permanen. Jika Anda ingin terus menggunakan nomor tersebut, tetap gunakan akun terkelola (jangan beralih), atau beli/porting nomor tersebut ke akun Twilio Anda sendiri terlebih dahulu.
  • Template WhatsApp yang disetujui tidak akan ditransfer. Template berada di Akun WhatsApp Business yang memiliki pengirim tersebut — Anda harus mengirimkannya kembali di akun Anda sendiri dan menunggu persetujuan ulang.
  • Obrolan dan riwayat pesan yang ada tetap terlihat, tetapi balasan baru pada nomor yang dirilis akan gagal (nomor tersebut sudah tidak ada).
  • Anda dapat beralih kembali nanti, tetapi Anda akan mendapatkan akun terkelola yang baru tanpa nomor dan tanpa template — yang lama tidak akan kembali.

Tempat menemukan Account SID dan Auth Token Anda: masuk ke Konsol Twilio di console.twilio.com. Keduanya ada di dasbor utama, di panel “Info Akun”. Account SID dimulai dengan AC dan panjangnya 34 karakter.

Setelah Anda memasukkan kedua nilai tersebut dan mengonfirmasi, sistem akan:

  1. Memvalidasi bahwa kredensial berfungsi.
  2. Merilis setiap nomor telepon terkelola dari Twilio.
  3. Menutup sub-akun terkelola.
  4. Menyimpan kredensial Anda sehingga semua WhatsApp keluar di masa mendatang menggunakan akun Anda. Nomor SMS via Twilio yang terhubung secara terpisah disimpan secara independen dan tidak dirilis atau diubah oleh peralihan ini.

Ini bisa memakan waktu dari beberapa detik hingga beberapa menit jika Anda memiliki beberapa nomor.

Jika Anda sudah menggunakan akun Twilio Anda sendiri

Kartu ini menampilkan akun Anda yang terhubung dan memungkinkan Anda beralih kembali ke pengaturan terkelola.

Beralih kembali ke pengaturan terkelola akan menyediakan sub-akun terkelola yang baru. Seperti di atas: ini tidak memulihkan nomor atau templat yang Anda miliki sebelumnya — Anda harus memulai dari awal.

Melampirkan Nomor WhatsApp yang Sudah Anda Miliki

Setelah akun menggunakan Twilio Anda sendiri, tombol Hubungkan WhatsApp pada kartu WhatsApp Business API akan mengubah penawarannya: opsi terkelola menjadi Melalui akun Twilio Anda, yang melampirkan pengirim WhatsApp di dalam akun Twilio yang Anda hubungkan, dan pembelian nomor terkelola tidak lagi ditawarkan. Hal itu disengaja — membeli nomor atau menjalankan pendaftaran Meta akan membuat akun Twilio kedua yang dikelola platform di samping akun Anda, dan pesan Anda kemudian akan dikirim dari satu akun sementara nomor tersebut berada di akun lainnya.

Sebelum Anda mulai

Nomor Anda harus sudah menjadi pengirim WhatsApp yang berfungsi di dalam akun Twilio Anda sendiri:

  • Nomor tersebut terdaftar sebagai pengirim WhatsApp di Twilio, yang dilampirkan ke Akun WhatsApp Business Anda sendiri.
  • Twilio menunjukkan pengirim tersebut sebagai Online.

Layar ini tidak mendaftarkan apa pun. Layar ini tidak membuat pengirim, tidak berkomunikasi dengan Meta, dan tidak mengirimkan nomor Anda untuk disetujui — layar ini menghubungkan pengirim yang sudah berfungsi. Jika Anda belum memilikinya, lakukan pengaturan pengirim WhatsApp di Twilio terlebih dahulu.

Langkah-langkah

  1. Buka Pengaturan → grup Saluran → Saluran.
  2. Pada kartu WhatsApp Business API, klik Lampirkan pengirim Anda.
  3. Masukkan Nomor WhatsApp dalam format internasional (sebagai contoh +31612345678), persis seperti yang muncul pada pengirim di Twilio.
  4. Secara opsional, berikan Label — nama untuk nomor tersebut di dalam aplikasi. Jika dibiarkan kosong, aplikasi akan menggunakan nama pada profil pengirim Twilio Anda.
  5. Klik Lampirkan pengirim.

Anda tidak perlu memasukkan kembali SID Akun atau token otentikasi Anda: kami sudah memilikinya dari pengalihan akun.

Apa yang terjadi di balik layar

  1. Kami mencari pengirim untuk nomor tersebut di akun Twilio Anda dan memeriksa apakah Twilio sedang daring.
  2. Kami memastikan layanan pesan ada di akun Anda dan mengarahkan webhook masuknya ke kami (membuatnya, dengan nama aplikasi, jika Anda belum memilikinya). Ini juga yang membuat pengiriman templat berfungsi.
  3. Kami menautkan pengirim Anda ke layanan pesan tersebut.
  4. Kami mengarahkan webhook milik pengirim ke kami, sehingga pesan masuk tiba di sini.
  5. Nomor tersebut muncul di daftar nomor Anda, ditandai Twilio Anda (BYO), siap untuk ditetapkan ke kampanye atau agen.

Templat Anda yang disetujui tetap berada di tempatnya, di akun Anda sendiri. Tidak ada yang dikirim ulang dan tidak ada yang dirilis.

Biaya

Tidak ada biaya pemeliharaan bulanan untuk nomor yang Anda lampirkan dengan cara ini — Anda membayar Twilio secara langsung untuk nomor tersebut dan biaya per pesannya. Balasan AI tetap menggunakan kredit seperti biasa.

Jika tidak berhasil

  • “No WhatsApp sender for … exists in your Twilio account” — nomor tersebut tidak terdaftar sebagai pengirim WhatsApp di sana, atau penulisannya berbeda. Periksa ID pengirim yang tepat di Konsol Twilio dan masukkan kembali dalam format internasional.
  • “The WhatsApp sender … is not online in Twilio” — alasan dari Twilio sendiri disertakan dalam pesan tersebut. Perbaiki terlebih dahulu di Twilio; menghubungkan pengirim yang sedang offline di Twilio hanya akan menyebabkan kegagalan nantinya secara diam-diam.
  • “… is already connected to another account” — nomor tersebut terhubung ke akun lain di sini. Putuskan sambungannya di sana terlebih dahulu.
  • “This account is still on the managed Twilio account” — lakukan peralihan di atas terlebih dahulu.
  • “we could not update its webhook in Twilio” — nomor tersebut sudah terhubung dan akan mengirim pesan, tetapi pengirim masih mengarah ke webhook apa pun yang Anda miliki sebelumnya. Hapus webhook tersebut pada pengirim di Konsol Twilio agar pesan masuk dapat mencapai kami.

Batasan

  • Anda dapat beralih penyedia paling banyak sekali setiap 24 jam. Ini mencegah lonjakan berulang yang menumpuk biaya API Twilio dan batas kecepatan.
  • Pengiriman SMS sama sekali tidak terpengaruh oleh pengaturan ini — jika Anda telah menghubungkan Twilio Anda sendiri melalui kartu SMS via Twilio, itu adalah koneksi yang berbeda dan tetap di tempatnya terlepas dari apa yang Anda lakukan di sini.

Bagaimana Jika Terjadi Kesalahan?

  • “Could not authenticate with the provided Twilio credentials” — periksa kembali SID (dimulai dengan AC, 34 karakter) dan token autentikasi Anda. Keduanya peka huruf besar-kecil (case-sensitive).
  • “Account is not active” — akun Twilio yang Anda coba gunakan ditangguhkan atau ditutup. Gunakan akun yang aktif.
  • “Please wait Xh before switching again” — Anda berada dalam masa tunggu 24 jam. Harap tunggu hingga waktu tersebut berakhir.
  • Partial migration (beberapa nomor dirilis, beberapa tidak) — jalankan ulang proses pengalihan. Sistem ini bersifat idempoten; sistem akan melanjutkan dari titik terakhir dan menyelesaikan pelepasan nomor yang masih ada di sub-akun yang dikelola.

Jika Anda mengalami kendala setelah beralih — pesan keluar tidak terkirim, templat tidak muncul — hubungi dukungan dengan menyertakan Account SID Anda (jangan pernah menyertakan token autentikasi).

Butuh Bantuan?

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.