Viber #

Hubungkan bot Viber Anda sendiri agar percakapan Viber Anda mengalir ke dalam aplikasi dan Agen AI dapat membalasnya. Anda dapat menghubungkannya dengan menempelkan satu nilai (token autentikasi bot Anda) dan kami akan menangani sisa pengaturannya untuk Anda.

Apa Itu Integrasi Viber? #

Integrasi Viber menghubungkan bot Viber yang Anda miliki ke platform menggunakan API Bot resmi Viber, sistem milik Viber sendiri untuk mengirim dan menerima pesan secara otomatis, alih-alih Anda mengetiknya secara manual. Percakapan antara bot Anda dan orang-orang yang mengikutinya akan tersedia di dalam aplikasi, dan Agen AI serta kotak masuk bersama dapat bekerja di atasnya.

Ini adalah integrasi resmi, jadi integrasi ini stabil dan sesuai dengan aturan Viber.

Ketersediaan. Viber paling banyak digunakan di Filipina, Vietnam, dan bagian lain Asia Tenggara, serta di seluruh Eropa Timur dan Yunani.

Sebelum Anda Memulai #

Anda memerlukan bot Viber sendiri, dan Viber hanya menerbitkan bot pada paket bisnis berbayar. Sejak Februari 2024, Viber tidak lagi membuat bot gratis. Anda mengatur akun secara langsung dengan Viber, dan akun serta biayanya tetap menjadi urusan antara Anda dan Viber. Kami tidak menjualnya kembali, menaikkan harganya, atau mengambil potongan, dan kami tidak dapat membuat bot atas nama Anda.

Pada saat penulisan, Viber mengenakan biaya bulanan per bot ditambah biaya per pesan untuk pesan yang dimulai oleh bot Anda (lihat Biaya di bawah). Periksa ketentuan Viber saat ini saat Anda mendaftar, karena penetapan harga adalah hak mereka untuk mengubahnya.

Tidak ada formulir pendaftaran mandiri. Viber meninjau setiap aplikasi chatbot secara manual, dan Anda dapat mendaftar melalui salah satu dari dua cara:

• Melalui mitra Viber terverifikasi, yang merupakan jalur yang direkomendasikan oleh Viber dan biasanya lebih cepat.
• Langsung dengan Viber, dengan mengirim email ke partners@viber.com. Jika Anda sudah bekerja sama dengan Viber, manajer akun bisnis Anda dapat memulainya sebagai gantinya.

Setelah aplikasi Anda disetujui, Anda menandatangani perjanjian Viber dan menyetujui ketentuan komersial mereka, lalu bot Anda akan dibuat.

Setelah itu, Anda akan menemukan tokennya di aplikasi Viber di bawah More → Settings → Bots → Edit Info → Your app key. Viber menyebutnya sebagai app key Anda; dokumentasi API mereka menyebut nilai yang sama sebagai authentication token, dan admin bot juga dapat melihatnya di panel admin Viber sendiri. Apa pun labelnya, itulah satu-satunya nilai yang diminta oleh aplikasi ini.

Token tersebut adalah satu-satunya hal yang Anda perlukan dari Viber. Pengaturan di sini hanya memakan waktu sekitar satu menit.

Menyiapkan Viber #

Langkah 1: Salin Token Autentikasi Bot Anda #

Tempat tercepat untuk menemukannya adalah aplikasi Viber di ponsel Anda.

1. Buka Viber di ponsel yang akunnya memiliki bot tersebut.
2. Buka More → Settings → Bots.
3. Pilih bot Anda dan ketuk Edit Info.
4. Salin nilai yang ditampilkan di bawah Your app key. Itulah tokennya.

Jaga kerahasiaan token ini. Siapa pun yang memilikinya dapat mengirim pesan sebagai bot Anda.

Langkah 2: Hubungkan Viber di Aplikasi #

1. Di bilah sisi kiri, klik Settings di dekat bagian bawah.
2. Di bilah kiri Settings, di bawah Channels, klik Channels.
3. Temukan kartu Viber dan klik Connect.
4. Tempel auth token Anda.
5. Klik Connect.
6. Aplikasi akan memeriksa token tersebut dengan Viber dan menampilkan “Connected to: <nama bot Anda>”.

Tidak ada webhook yang perlu disiapkan. Tidak seperti kebanyakan saluran lain, kami mendaftarkan semuanya ke Viber untuk Anda sebagai bagian dari proses menghubungkan, jadi tidak ada yang perlu disalin ke konsol lain. Layar yang terhubung menampilkan alamat tempat pesan Anda masuk semata-mata agar Anda dapat membagikannya dengan dukungan jika sewaktu-waktu diperlukan.

Langkah 3: Uji Bot #

1. Dari ponsel lain, buka Viber dan ikuti bot Anda (cari bot tersebut, atau gunakan tautannya).
2. Kirim pesan ke bot tersebut.
3. Buka aplikasi dan buka Chats. Pesan masuk akan muncul di daftar percakapan.
4. Jika AI Agent menangani saluran ini, Anda akan melihatnya membalas secara otomatis.

Setelah terhubung, bot Viber Anda akan ditampilkan sebagai Connected di halaman Channels dan AI akan merespons pesan masuk.

Siapa yang Dapat Dikirimi Pesan oleh Bot Anda #

Ini adalah hal terpenting untuk dipahami tentang Viber, dan ini berbeda dari setiap saluran lainnya:

Bot Anda hanya dapat mengirim pesan kepada orang yang mengikutinya. Seseorang harus menemukan bot Anda dan mengikutinya sebelum Anda dapat mengirimkan apa pun kepada mereka. Tidak ada cara untuk mengirim pesan kepada pengguna Viber yang belum mengikuti bot Anda terlebih dahulu.

Jika seseorang berhenti mengikuti atau memblokir bot Anda, Anda tidak dapat mengirim pesan kepada mereka lagi sampai mereka mengikuti dan mengirim pesan kepada Anda. Saat itu terjadi, aplikasi akan menandai percakapan tersebut agar berhenti mencoba, dan balasan apa pun yang Anda kirim akan ditampilkan sebagai gagal dengan penjelasan, alih-alih menghilang begitu saja.

Oleh karena itu, Viber berfungsi dengan sangat baik sebagai saluran dukungan dan balasan (seseorang mengirim pesan kepada Anda, AI menjawab) dan kurang efektif sebagai saluran penjangkauan dingin (cold-outreach).

Biaya #

Viber adalah saluran gratis di aplikasi: tidak ada biaya per pesan dan tidak ada biaya koneksi bulanan dari kami.

Biaya Anda berasal dari Viber, pada akun Anda sendiri:

• Biaya bulanan per bot (sekitar €100 pada saat penulisan).
• Balasan dalam percakapan yang dimulai seseorang adalah gratis dan tidak terbatas. Ini mencakup hampir semua hal yang dilakukan AI Agent.
• Pesan yang dimulai oleh bot Anda, di luar percakapan yang dimulai oleh orang tersebut, dikenakan biaya per pesan dengan tarif yang bergantung pada negara penerima.

Kesimpulan praktisnya: menjawab orang tidak memakan biaya apa pun selain biaya bulanan. Siaran dan tindak lanjut proaktif adalah hal yang menambah biaya.

Pesan Media #

Foto, video, file, stiker, lokasi, dan kontak yang dibagikan yang masuk akan dikenali sehingga AI mengetahui bahwa media telah dikirim (catatan singkat ditambahkan ke percakapan). Balasan AI keluar berupa teks dan gambar dalam versi ini. Balasan panjang secara otomatis dipotong hingga batas 7.000 karakter Viber.

Manajemen Sesi #

Memeriksa Status Koneksi #

Status koneksi Viber Anda ditampilkan pada kartu Viber di halaman Channels:

Kartu ini memeriksa ulang bot Anda setiap kali Anda membuka halaman Saluran. Bot Viber hanya dapat mengirim pesannya ke satu tempat dalam satu waktu, jadi jika Anda menghubungkan bot yang sama ke alat lain, alat tersebut akan mengambil alih dan pesan Anda berhenti masuk ke sini, tanpa peringatan dari Viber. Itulah arti dari “Connected, action needed”. Buka kartu tersebut dan hubungkan kembali untuk mengambilnya kembali.

Memutuskan Koneksi #

Buka kartu Viber dan klik Manage, lalu klik Disconnect dan konfirmasi Remove Viber?. Ini menghentikan kami menerima pesan bot dan menghapusnya dari akun Anda. Bot Anda sendiri tetap menjadi milik Anda. Tidak ada yang berubah di akun Viber Anda.

Batasan #

• Hanya pengikut. Bot Anda hanya dapat mengirim pesan kepada orang yang mengikutinya. Lihat Siapa yang Dapat Dihubungi Bot Anda.
• Anda memerlukan bot Viber berbayar milik sendiri. Kami tidak dapat menyediakannya.
• Satu bot per koneksi. Hubungkan setiap bot secara terpisah; satu bot hanya dapat ditautkan ke satu akun.
• Pengiriman teks + gambar. AI membalas dengan teks dan gambar; korsel dan kartu kaya (rich cards) tidak dikirim dalam versi ini.
• Tidak ada pesan selamat datang. Saat seseorang membuka bot Anda untuk pertama kalinya tetapi belum mengikutinya, Viber mengizinkan satu salam instan. Versi ini tidak mengirimkannya. Percakapan dimulai saat mereka mengirim pesan pertama mereka.

Pemecahan Masalah #

Token Ditolak Saat Menghubungkan #

• Pastikan Anda menyalin nilai dari Edit Info → Your app key di aplikasi Viber, bukan id yang berbeda.
• Periksa apakah bot Anda masih aktif di akun Viber Anda.
• Menghubungkan juga memeriksa apakah Viber dapat menjangkau kami. Jika token Anda sudah benar dan masih gagal, tunggu sebentar dan coba lagi, lalu hubungi dukungan.

“Bot Viber ini sudah terhubung ke akun lain” #

Bot yang sama ditautkan ke akun yang berbeda di aplikasi. Putuskan koneksinya di sana terlebih dahulu, atau gunakan bot yang berbeda.

Bot Tidak Membalas #

• Pastikan kartu menunjukkan Connected, bukan Connected, action needed.
• Pastikan orang yang Anda ajak menguji telah mengikuti bot Anda. Viber hanya mengirimkan pesan dari pengikut.
• Periksa apakah Agen AI telah ditetapkan ke saluran ini.

Pesan Berhenti Masuk #

Ini hampir selalu merupakan masalah pengambilalihan yang dijelaskan di bawah Memeriksa Status Koneksi: bot yang sama terhubung ke alat lain. Buka kartu Viber dan hubungkan kembali.

Balasan Gagal Dengan “Not Subscribed” #

Orang tersebut berhenti mengikuti atau memblokir bot Anda. Anda tidak dapat mengirim pesan kepada mereka sampai mereka mengikutinya lagi dan mengirim pesan kepada Anda terlebih dahulu.

Praktik Terbaik #

• Utamakan dukungan, bukan penjangkauan. Balasan di dalam percakapan yang dimulai seseorang bersifat gratis dan tidak terbatas; pesan yang Anda mulai akan dikenakan biaya dan hanya menjangkau pengikut.
• Buat bot Anda mudah diikuti. Letakkan tautannya di situs Anda, di tanda tangan email Anda, dan di saluran Anda yang lain. Mengikutinya adalah satu-satunya cara orang dapat menjangkaunya.
• Jaga keamanan token autentikasi Anda. Siapa pun yang memilikinya dapat mengirim pesan sebagai bot Anda. Buat ulang di aplikasi Viber jika bocor, lalu hubungkan kembali di sini.
• Jangan hubungkan bot yang sama ke dua alat. Alat kedua akan mengambil alih secara diam-diam.