Panduan produk
Hubungkan akun Telegram
Anda dapat menghubungkan akun Telegram Anda sendiri ke Wbiztool, di samping nomor WhatsApp Anda. Akun ini mengirim melalui API dan halaman yang sama seperti nomor WhatsApp, dan penerima melihat pesan Anda sebagai pesan Telegram biasa dari Anda.
- Satu API untuk keduanya. Kirim pesan, Kirim ke banyak nomor, Jadwalkan pesan, Kirim ke grup, Batalkan pesan, dan webhook status pesan bekerja dengan cara yang sama. Kirim ID akun Telegram sebagai
whatsapp_client. - Halaman yang sama. Kirim cepat, kampanye, dan pengingat dapat mengirim dari akun ini.
- Lebih banyak cara menjangkau orang. Kirim ke nomor telepon, @username, tautan t.me, atau grup.
Siapa yang dapat melakukannya: Pemilik dan Editor menghubungkan dan mengelola akun Telegram.
Sebelum memulai#
- Telegram di ponsel Anda, login dengan akun yang ingin Anda pakai untuk mengirim.
- Alamat email yang sudah dikonfirmasi.
- Paket yang sudah dibayar dan masih memiliki slot nomor kosong. Akun Telegram memakai satu slot nomor di paket Anda, seperti nomor WhatsApp. Lihat Batas jumlah nomor.
- Sisa pesan di paket Anda. Setiap pesan dari akun Telegram memakai satu kredit pesan, sama seperti di WhatsApp.
Menghubungkan akun Anda#
Di halaman Nomor, klik Tambahkan akun Telegram. Anda juga menemukannya di bawah jendela Tambahkan nomor WhatsApp: Ingin menghubungkan akun Telegram? Tambahkan akun Telegram.
Jendela Tambahkan akun Telegram menawarkan dua cara login: Pindai kode QR atau Kode login. Hasil keduanya sama.
Dengan kode QR#
Gunakan cara ini jika ponsel Anda ada di dekat komputer.
Buka Tambahkan akun Telegram
Di halaman Nomor, klik Tambahkan akun Telegram. Jendela terbuka dengan Pindai kode QR terpilih.
Tampilkan kode QR
Klik Tampilkan kode QR. Jendela Pindai dengan Telegram menampilkan kodenya.
Buka Tambah Perangkat di ponsel Anda
Buka Telegram di ponsel Anda, lalu buka Pengaturan → Perangkat → Tambah Perangkat.
Pindai kodenya
Arahkan ponsel ke kode QR. Kode berubah setiap 30 detik: pindai yang terbaru. Jika login berhasil, jendela menampilkan Akun Telegram terhubung dan "… terhubung. Pesan yang Anda kirim dari akun ini dikirim melalui Telegram."
Dengan kode login#
Gunakan cara ini jika Anda tidak dapat memindai kode QR, misalnya jika ponsel adalah satu-satunya perangkat Anda.
Pilih Kode login
Di jendela Tambahkan akun Telegram, klik tab Kode login.
Masukkan nomor Anda
Periksa negara Anda di Kode negara. Di Nomor telepon Telegram, ketik nomor yang digunakan akun Telegram Anda, tanpa kode negara, misalnya
9876543210. Klik Kirim kode login.Ketik kodenya
Telegram mengirim kode login ke aplikasi Telegram Anda (atau lewat SMS). Di jendela Masukkan kode login, ketik kodenya di Kode login lalu klik Login. Setelah itu jendela menampilkan Akun Telegram terhubung.
Verifikasi dua langkah#
Jika akun Anda menggunakan verifikasi dua langkah, setelah kode QR atau kode login jendela meminta kata sandi Telegram akun tersebut: Masukkan kata sandi Telegram Anda. Ketik kata sandi Telegram (cloud) Anda di Kata sandi Telegram lalu klik Login. Wbiztool menggunakannya sekali untuk login dan tidak pernah menyimpannya.
Setelah terhubung#
- Akun mendapat kartu di halaman Nomor dengan lencana Telegram dan ID-nya, misalnya ID 702. Klik ID untuk menyalinnya: gunakan sebagai
whatsapp_clientdi API, sama seperti untuk nomor. - Klik Kirim pesan uji untuk memastikan akun bisa mengirim. Di Kirim ke, ketik @username atau nomor telepon dengan kode negaranya, misalnya
@nameatau+91 98765 43210. - Ganti nama dan Hapus bekerja seperti pada nomor WhatsApp. Lihat Mengelola nomor.
Mengirim dari akun Telegram Anda#
Pilih akun Telegram seperti nomor lainnya: di Dari pada Kirim cepat, sebagai nomor pengirim kampanye atau pengingat, atau dengan ID-nya sebagai whatsapp_client di API. Pesannya tampil di Laporan, dan webhook dari Kirim pesan melaporkan SENT atau FAILED seperti untuk WhatsApp.
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
-H "Content-Type: application/json" \
-d '{
"client_id": 12345,
"api_key": "YOUR_API_KEY",
"whatsapp_client": 702,
"phone": "@emma_thompson",
"msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
}'
Ganti 12345, YOUR_API_KEY, dan 702 dengan nilai Anda sendiri: 702 adalah ID akun Telegram dari kartunya.
Siapa yang dapat Anda kirimi#
Dari akun Telegram, phone di API (serta nomor di Kirim cepat, nomor kampanye, dan Kirim ke pada pengingat) menerima salah satu dari berikut:
| Yang Anda tulis | Contoh | Perlu diketahui |
|---|---|---|
| Nomor telepon dengan kode negaranya | +91 98765 43210 | Orang tersebut harus menggunakan Telegram. Saat pertama kali, nomor ditambahkan ke kontak Telegram akun Anda. Telegram menolak orang yang menyembunyikan nomornya dari orang asing: pesan gagal dengan "Not on Telegram, or their privacy settings hide this number". |
| @username | @emma_thompson | Username Telegram orang tersebut. |
| Tautan t.me | t.me/emma_thompson | Sama dengan @username. https://t.me/emma_thompson juga bisa dipakai. |
tg:<id> | tg:5012345678 | Cara kotak masuk dan webhook-nya menyebut orang yang tidak menampilkan nomor maupun username. Gunakan untuk membalas mereka. |
Username, tautan t.me, dan tg:<id> hanya berfungsi dari akun Telegram. Dari nomor WhatsApp, Kirim pesan dan Jadwalkan pesan menjawab "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client", dan Kirim ke banyak nomor melewatinya.
Akun mana yang dipilih API#
Jika Anda tidak mengirim whatsapp_client, Kirim pesan menggunakan satu-satunya nomor yang terhubung, dengan WhatsApp didahulukan:
- Satu nomor WhatsApp yang terhubung tetap digunakan, meskipun ada akun Telegram yang juga terhubung. Menambahkan akun Telegram tidak memindahkan integrasi Anda yang sudah ada ke akun tersebut.
- Akun Telegram hanya digunakan jika tidak ada nomor WhatsApp yang terhubung.
- @username menggunakan satu-satunya akun Telegram yang terhubung.
Untuk mengirim dari akun Telegram dalam kasus lain, kirim ID-nya sebagai whatsapp_client.
Grup#
Dari akun Telegram, group_name (dan Grup di Kirim cepat) menerima:
- @username atau tautan t.me grup publik, misalnya
@lumen_clubataut.me/lumen_club, atau - nama persis grup atau channel yang diikuti akun tersebut, misalnya
Lumen VIP Club. Huruf besar dan kecil tidak berpengaruh.
Akun harus sudah menjadi anggota grup dan diizinkan mengirim pesan di sana. Akun tidak pernah bergabung ke grup dengan sendirinya.
- Jika tidak ada grup yang cocok, pesan gagal dengan "Group not found".
- Jika akun tidak dapat mengirim pesan di sana, pesan gagal dengan "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)".
Batas dari Telegram#
Telegram membatasi berapa banyak orang yang belum pernah menghubungi sebuah akun yang boleh dikirimi pesan oleh akun tersebut. Akun baru paling dibatasi.
- Saat Telegram meminta untuk melambat, akun berhenti sejenak dan pesannya menunggu. Pesan terkirim setelah jeda itu.
- Saat Telegram membatasi pesan ke orang asing, pesan tersebut gagal dengan "Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour", dan akun beristirahat selama satu jam.
Kotak masuk (Unibox)#
Akun Telegram dapat ditambahkan ke kotak masuk Unibox seperti nomor: di Nomor kotak masuk, klik Tambahkan nomor ke kotak masuk lalu pilih akunnya. Akun ini memakai salah satu nomor kotak masuk dari add-on Unibox Anda, seperti nomor WhatsApp.
- Chat pribadinya tampil di kotak masuk: pesan yang diterimanya, serta pesan yang dikirim dari ponsel atau oleh Wbiztool. Chat dari Telegram menampilkan tanda Telegram.
- File hingga 16 MB disalin ke kotak masuk.
- Balasan tetap berfungsi, bahkan ke orang yang menyembunyikan nomornya.
- Grup, channel, Pesan Tersimpan, dan chat layanan milik Telegram sendiri (yang berisi kode login) tidak pernah ditampilkan.
Webhook akun di kotak masuk mengirim pesannya seperti webhook nomor. Payload-nya berisi platform bernilai telegram, dan contact.phone serta message.from berisi nomor, @username, atau tg:<id> orang tersebut: kirim balasan Anda ke nilai itu sebagai phone. Lihat Payload.
Memutuskan atau menghubungkan kembali#
- Putuskan di kartu menghentikan akun dari mengirim. Ini juga me-logout Wbiztool dari daftar perangkat akun tersebut di Telegram.
- Jika Telegram mengakhiri sesi, misalnya saat Anda me-logout Wbiztool di Pengaturan → Perangkat, atau akun di-logout dari semua perangkat, kartu menampilkan Tidak terhubung. Pemilik dan Editor menerima peringatan terputus yang disesuaikan untuk Telegram, sama seperti untuk nomor WhatsApp. Lihat Peringatan WhatsApp terputus.
- Selama akun tidak terhubung, pesannya menunggu di Menunggu dikirim.
- Untuk menghubungkannya lagi, klik Hubungkan kembali di kartunya lalu login lagi, dengan kode QR atau kode login.
Belum tersedia#
- Mengekspor anggota grup Telegram. Ekspor anggota grup hanya berfungsi untuk grup WhatsApp.
- Grup Telegram di kotak masuk Unibox. Hanya chat pribadi yang tampil di sana.
Pemecahan masalah#
| Masalah | Yang perlu dilakukan |
|---|---|
| Tidak ada tombol Tambahkan akun Telegram | Anda adalah Analis di workspace ini. Minta Pemilik untuk melakukannya atau menjadikan Anda Editor. |
| Tambahkan akun Telegram berwarna abu-abu | Arahkan kursor ke tombol itu untuk melihat alasannya: email Anda belum dikonfirmasi, semua slot nomor di paket Anda sudah terpakai, atau paket belum dibayar. Aturannya sama seperti untuk nomor, lihat Batas jumlah nomor. |
| Kode QR tidak berfungsi | Kode berubah setiap 30 detik: pindai yang terbaru, di Telegram melalui Pengaturan → Perangkat → Tambah Perangkat. Jika jendela menampilkan "Login terlalu lama. Mulai lagi.", klik Mulai lagi. |
| "Kode tersebut salah. Periksa kode terbaru yang dikirim Telegram lalu coba lagi." | Ketik kode login terbaru dari aplikasi Telegram Anda (atau dari SMS). |
| "Kode sudah habis. Mulai lagi untuk mendapatkan kode baru." | Klik Mulai lagi lalu ketik kode yang baru. |
| "Kata sandi tersebut salah. Coba lagi." | Ketik kata sandi Telegram akun tersebut dari verifikasi dua langkah, bukan kode login. |
| "Nomor ini tidak memiliki akun Telegram." | Periksa negara dan nomornya, atau login dengan kode QR. |
| "Telegram meminta Anda menunggu sebelum mencoba lagi. Coba lagi nanti." | Tunggu sebentar, lalu login lagi. |
| Gagal dengan "Not on Telegram, or their privacy settings hide this number" | Orang tersebut tidak menggunakan Telegram, atau menyembunyikan nomornya dari orang yang tidak dikenalnya. Kirim ke @username-nya, atau minta dia mengirim pesan ke akun Anda lebih dulu lalu balas dari kotak masuk. |
| Gagal dengan "Group not found" | Periksa nama persis grup, atau gunakan @username atau tautan t.me-nya. Akun harus menjadi anggota grup. |
| Gagal dengan "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)" | Bergabunglah ke grup di Telegram dengan akun ini lebih dulu. Jika hanya admin yang dapat mengirim pesan, minta bantuan admin grup. |
| Gagal dengan "Telegram limited this account: …" | Lihat Batas dari Telegram. Pengiriman berlanjut setelah satu jam. |
| API menjawab "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client" | Kirim ID akun Telegram sebagai whatsapp_client. Lihat Akun mana yang dipilih API. |
| Kartu menampilkan Tidak terhubung | Telegram mengakhiri sesi. Klik Hubungkan kembali lalu login lagi. |
