Menghubungkan Akun Telegram

Penghubungan akun diperlukan agar Sejoli mengetahui bahwa sebuah akun WordPress dan sebuah akun Telegram dimiliki pengguna yang sama. Saat ini, proses binding harus dimulai dari halaman Profile dalam keadaan login.

Ringkasan Flow yang Tersedia

Flow Member: Profile ke Telegram

sequenceDiagram
    participant M as Member
    participant P as Member Area Profile
    participant T as Telegram Bot
    participant W as Situs WordPress

    M->>P: Login dan buka Profile
    M->>P: Klik Connect Telegram
    P-->>M: Buka deep link dengan token sekali pakai
    M->>T: Klik Start
    T->>W: Kirim command /start dengan payload koneksi
    W->>W: Validasi user, token, dan konflik akun
    W-->>T: Simpan identitas Telegram pada user
    T-->>M: Konfirmasi akun berhasil terhubung
    P->>W: Poll status koneksi
    W-->>P: connected = true
    P-->>M: Tampilkan Telegram Terhubung

Langkah pengguna:

1. 1
   Login ke Member Area

   Pengguna harus login ke akun yang ingin dihubungkan.

2. 2
   Buka Profile

   Masuk ke halaman Profile dan cari kartu Telegram.

3. 3
   Klik Connect Telegram

   Situs membuka chat bot melalui deep link khusus untuk user yang sedang login.

4. 4
   Klik Start di Telegram

   Telegram mengirim command Start beserta payload koneksi kepada bot. Jika chat dengan bot sudah pernah dimulai, Telegram dapat menampilkan tombol Start atau langsung mengirim command dari deep link.

5. 5
   Tunggu konfirmasi

   Bot membalas bahwa akun berhasil terhubung. Halaman Profile memeriksa status secara berkala dan menampilkan identitas Telegram setelah binding terdeteksi.

Deep link secara konsep berbentuk:

https://t.me/NAMA_BOT?start=link_USER_ID_TOKEN

USER_ID dan token dibuat server. Pengguna tidak perlu membuat atau mengetik payload ini secara manual.

Mengapa /start Polos Tidak Cukup?

Ketika seseorang membuka bot langsung dan mengirim:

/start

bot hanya menerima data Telegram seperti Telegram user ID, Chat ID, nama, dan username jika tersedia. Data tersebut tidak dapat membuktikan akun WordPress mana yang dimiliki pengguna.

Karena itu, jika chat belum terhubung, bot akan mengarahkan pengguna untuk:

1. Login ke Member Area.
2. Membuka halaman Profile.
3. Menekan Connect Telegram.
4. Kembali ke bot dan menekan Start dari deep link tersebut.

Flow bot-first tetap berguna sebagai petunjuk, tetapi bukan metode binding mandiri.

Validasi dan Keamanan

Saat menerima deep link, server melakukan pemeriksaan berikut:

1. Payload mempunyai user ID dan token.
2. Token acak cocok dengan token aktif yang dibuat situs untuk user tersebut; token berlaku 15 menit dan hanya dapat dipakai sekali.
3. Akun WordPress masih ada.
4. Chat Telegram belum terhubung ke akun WordPress lain.

Jika valid, server menyimpan Telegram user ID, username, waktu binding, dan Chat ID pada profil user.

Konflik Akun

Satu Chat ID Telegram tidak dapat dihubungkan ke dua akun WordPress berbeda pada situs yang sama.

Jika chat sudah terhubung ke akun lain, bot menolak binding baru. Pengguna harus:

1. Login ke akun WordPress lama.
2. Buka Profile.
3. Klik Putuskan Telegram.
4. Login ke akun WordPress baru.
5. Ulangi flow Connect.

Jika pengguna tidak dapat mengakses akun lama, administrator dapat membantu memutus koneksi dari halaman edit user di WordPress.

Disconnect dan Reconnect

Pada Profile yang sudah terhubung, klik Putuskan Telegram. Tindakan ini menghapus data binding dari user sehingga notifikasi personal tidak lagi dikirim ke chat tersebut.

Setelah disconnect, pengguna dapat:

• Menghubungkan kembali akun Telegram yang sama.
• Menghubungkan akun Telegram berbeda dengan membuka link Connect menggunakan akun Telegram yang diinginkan.

Flow Admin

Notifikasi transaksi untuk admin

Admin tidak perlu menghubungkan profile WordPress untuk menerima broadcast notifikasi admin. Masukkan Chat ID admin pada:

Sejoli → Telegram → Admin Chat IDs

Semua ID yang dikonfigurasi akan menerima notifikasi admin.

Menghubungkan profile admin

Jika akun WordPress admin perlu menerima notifikasi personal sebagai user, admin dapat membuka profile miliknya sendiri dan mengikuti flow Connect yang sama seperti member.

Hubungan dengan Pengaturan Notifikasi Member

Pengaturan Aktifkan notifikasi Telegram untuk member mengontrol pengiriman notifikasi personal kepada buyer dan affiliate yang sudah terhubung. Pengaturan ini bukan mekanisme identifikasi akun.

• Binding menyimpan hubungan akun WordPress ↔ Telegram.
• Toggle notifikasi member menentukan apakah hubungan tersebut digunakan untuk pengiriman notifikasi.
• Admin Chat IDs menentukan penerima broadcast admin secara terpisah.

Syarat Teknis Agar Flow Berhasil

Admin situs perlu memastikan:

• Lisensi Sejoli Telegram valid.
• Bot Token dan Bot Username sudah benar.
• Webhook bot mengarah ke situs dan dapat menerima update Telegram.
• Situs memakai HTTPS publik yang dapat dijangkau Telegram.
• Rewrite/permalink situs berfungsi jika webhook non-REST digunakan.

Jika tombol Connect membuka bot tetapi Start tidak menghasilkan balasan, periksa konfigurasi webhook dan log response Telegram pada halaman Troubleshooting.