Cara Menghubungkan Agen AI ke Telegram dengan Chiho

Hubungkan agen AI ke Telegram dengan menghubungkan akun Telegram di Chiho, menambahkan https://api.chiho.ai/mcp ke klien MCP kompatibel, dan menyelesaikan OAuth melalui browser. Kemudian verifikasi akun dan cakupan dengan auth_status sebelum meminta agen membaca satu percakapan terpilih.

Panduan ini membahas koneksi terkelola Chiho dan pilihan runtime lokal terpisah. MCP menyediakan alat; skill menyediakan petunjuk alur kerja. Memasang skill tidak mengizinkan akses ke akun Telegram Anda.

Catatan verifikasi — 8 September 2026: petunjuk ini diperiksa terhadap implementasi Chiho saat ini, bantuan perintah Codex lokal, dan dokumentasi klien yang ditautkan. Pembaruan ini tidak menjalankan penyiapan klien terautentikasi baru atau membaca percakapan pelanggan. Latihan di bawah adalah daftar penerimaan, bukan laporan hasil akun yang diamati. Gambar kepala yang sudah ada menggambarkan kotak masuk Chiho, bukan uji penyiapan OAuth.

Pilih koneksi yang ingin Anda operasikan

Chiho Cloud adalah jalur terkelola untuk pekerjaan Telegram dan CRM. Klien AI terhubung ke layanan MCP jarak jauh Chiho dan meminta Anda masuk serta menyetujui di browser. Tinjau referensi penyiapan MCP Telegram bersama panduan ini.

tgchats local adalah runtime lokal sumber terbuka terpisah dalam repositori agen Telegram. Ikuti petunjuk instalasi dan operasi terkini repositori jika ingin memelihara lingkungan lokal. Tanggung jawab penyiapan dan penyimpanannya berbeda dari koneksi terkelola; masuk cloud yang berhasil tidak memvalidasi runtime lokal.

Jika masih memilih jenis sistem yang dibutuhkan, panduan CRM Telegram menjelaskan alur relasi, sementara CRM versus bot versus kotak masuk bersama membandingkan pendekatan.

Sebelum menghubungkan: akun, klien, dan percakapan

Miliki akun Chiho dengan Telegram yang terhubung, klien yang mendukung HTTP jarak jauh MCP dan browser OAuth, serta pilihan yang jelas antara konteks pribadi atau tim. Pilih satu percakapan yang Anda berwenang untuk periksa untuk latihan pertama. Hindari memulai dengan seluruh inbox atau permintaan untuk mengirim pesan.

Tinjau penanganan data klien AI Anda dan aturan organisasi Anda sebelum mengizinkannya mengambil isi percakapan. Chiho menyimpan sesi Telegram yang di-host di dalam layanannya, tetapi informasi yang dikembalikan oleh alat disediakan kepada klien AI yang terhubung. Lihat kebijakan privasi Chiho's untuk ketentuan penanganan yang dipublikasikannya.

Gunakan resource produksi persis seperti yang ditampilkan di atas. Resource staging digunakan untuk pengujian pra-produksi yang terisolasi; akses produksi dan staging tidak dapat dipertukarkan.

Hubungkan layanan MCP yang di-host

Codex

Jalankan perintah berikut di terminal tempat Codex terinstal:

codex mcp add chiho --url https://api.chiho.ai/mcp
codex mcp login chiho

Perintah kedua memulai otorisasi browser. Setelah menyetujui, kembali ke surface Codex menggunakan konfigurasi tersimpan itu dan minta auth_status. Jika server tidak muncul, periksa apakah surface tersebut menggunakan konfigurasi yang sama seperti terminal Anda. Lihat referensi penyiapan klien Chiho untuk endpoint yang di-host dan konteks konfigurasi.

Claude Code

Tambahkan server HTTP jarak jauh:

claude mcp add --scope user --transport http chiho https://api.chiho.ai/mcp

Di Claude Code, buka /mcp dan selesaikan autentikasi untuk Chiho. Lalu minta auth_status. Dokumentasi MCP Anthropic menjelaskan konfigurasi dan autentikasi HTTP jarak jauh. Kontrol klien dan fitur konektor yang tersedia dapat bervariasi; periksa dokumentasi untuk versi yang Anda gunakan.

Klien kompatibel lainnya

Gunakan alur koneksi remote MCP kustom milik klien dengan URL produksi yang sama. Untuk alur OAuth klien publik Chiho, biarkan kolom opsional client ID dan secret kosong kecuali dukungan telah menyediakan kredensial penerapan terkelola. Selesaikan persetujuan di browser, bukan menyalin token bearer ke file konfigurasi.

Chiho tersedia di pasar plugin ChatGPT. Instal plugin di ChatGPT atau Codex dan selesaikan otorisasi browser di klien tersebut. Konfigurasi Codex lokal tidak menginstal plugin di web ChatGPT.

Klien yang dapat menjangkau server belum tentu telah menyelesaikan otorisasi. Jangan anggap ikon transport yang terhubung sebagai bukti bahwa akun Telegram yang dimaksud tersedia.

Baca layar persetujuan sebagai keputusan akses

Periksa identitas klien, host pengalihan, akun Chiho, cakupan pribadi atau tim, dan set izin lengkap sebelum memberikan persetujuan. Grant interaktif Chiho mencakup kapabilitas baca dan tulis yang didukung; memulai dengan permintaan hanya-baca tidak mengubah grant itu sendiri menjadi grant hanya-baca.

Grant tim membatasi alat ke akun dan percakapan yang terlihat di tim. Pencarian pesan tim memerlukan chat tertentu, dan operasi folder serta logout untuk seluruh akun pribadi tidak diekspos dalam konteks tim. Percakapan yang tidak ada karena itu dapat mencerminkan batas akses, bukan koneksi yang rusak.

Prompt alat klien dan perlindungan eksekusi Chiho adalah kontrol yang terpisah. Tinjau keduanya sebelum melangkah melampaui pembacaan:

• Terdapat penulisan langsung. Pengiriman satu pesan, tag CRM, tugas, aturan otomatisasi, operasi folder, penyegaran ringkasan, dan logout akun dapat dieksekusi setelah kontrol klien dan pemeriksaan server yang berlaku. Alat bernama message_send_draft mengirim pesan; jangan berasumsi bahwa alat itu hanya menyimpan draf.
• Persetujuan outbox bergantung pada operasi. Pratinjau multi-penerima memerlukan persetujuan. Pratinjau outbox untuk satu penerima juga memerlukannya saat koneksi menggunakan mode selalu tanya.
• Undangan anggota dan keluar dari grup memerlukan pratinjau tersimpan dan persetujuan sebelum eksekusi.
• Melihat pratinjau bukan berarti mengirim, tetapi pratinjau dapat mempertahankan status persetujuan. Itu bukan alat yang sesuai untuk latihan penerimaan yang benar-benar hanya-baca.

Kalimat seperti “jangan kirim” membantu mendefinisikan tugas tetapi tidak menggantikan izin alat. Demikian pula, memasang skill alur kerja tidak mengubah grant. Tinjau setiap skill yang membuat tugas atau menyegarkan ringkasan sebagai alur kerja yang mengandung penulisan.

Jalankan satu latihan penerimaan hanya-baca

Gunakan permintaan contoh ini setelah otorisasi. Ganti deskripsi dengan percakapan yang Anda pilih dan berwenang:

Pertama panggil auth_status dan konfirmasi akun yang terhubung serta konteks pribadi atau tim. Temukan percakapan yang saya pilih dan minta saya menyelesaikan kecocokan yang ambigu. Baca hanya pesan-pesan terbarunya. Daftarkan pertanyaan terbuka, komitmen eksplisit, dan poin yang tidak jelas, beserta referensi pesan untuk masing-masing. Nyatakan rentang waktu dan batas pagination apa pun. Jangan kirim pesan, membuat tugas, mengubah field CRM, menyegarkan ringkasan, memulai sinkronisasi, atau menyiapkan pratinjau penulisan.

Periksa hasilnya terhadap percakapan itu sendiri:

1. Identitas: Akun dan cakupan yang dikembalikan cocok dengan konteks yang Anda inginkan. Hentikan jika tidak cocok.
2. Target: Percakapan yang dipilih benar. Judul yang mirip perlu dibedakan, bukan penerima yang ditebak.
3. Cakupan: Agen menyatakan apa yang dibaca. Satu halaman dialog atau pesan bukan bukti riwayat lengkap; lanjutkan pagination hanya jika diperlukan dan diizinkan.
4. Dasar: Setiap komitmen atau pertanyaan terbuka yang diklaim memiliki pesan pendukung. Informasi yang hilang tetap tidak diketahui, bukan menjadi tenggat atau penanggung jawab yang direkayasa.
5. Efek: Riwayat alat hanya berisi pembacaan yang dimaksud. Ringkasan tertulis yang berguna dalam percakapan AI tidak memerlukan penyimpanan ringkasan CRM atau pembuatan tugas.

Misalnya, dalam percakapan fiktif ketika seorang pelanggan meminta proposal dan rekan satu tim mengatakan “Saya akan mengirimnya Jumat,” jawaban yang berguna membedakan pertanyaan pelanggan dari komitmen rekan tim. Jawaban itu tidak boleh mengklaim proposal telah dikirim tanpa pesan pendukung. Ini adalah kasus evaluasi ilustratif, bukan bukti pelanggan atau hasil terukur.

Catat klien/versi Anda, tanggal pemeriksaan, konteks akun tanpa pengenal pribadi, alat yang digunakan, serta lulus/gagal untuk kelima pemeriksaan. Jangan masukkan token atau pesan pribadi ke dalam catatan uji yang dibagikan. Perluas alur kerja hanya setelah latihan kecil ini berperilaku seperti yang diharapkan.

Pecahkan langkah yang gagal

Otorisasi tidak pernah selesai: Periksa kembali URL remote yang tepat, selesaikan alur persetujuan browser, dan pastikan Anda masuk ke lingkungan Chiho yang dimaksud. Koneksi yang dicabut memerlukan persetujuan baru. Hapus kredensial dan konten pribadi sebelum membagikan error kepada dukungan.

Otorisasi berhasil tetapi percakapan hilang: Periksa koneksi Telegram di Chiho, akun yang dipilih, dan batas tim pada grant. Bandingkan inventaris yang sebanding: dialogs_list mem-paging dialog Telegram; crm_dialogs_list mem-paging inventaris Chiho yang tersimpan CRM. Panjang halaman yang dikembalikan bukan total akun, dan kedua daftar itu bukan hitungan kontak buku alamat.

Hanya sebagian riwayat yang diringkas: Minta agen melaporkan rentang yang diminta, rentang yang dikembalikan, dan status kelanjutan. Jangan biarkan ia menggambarkan pembacaan parsial sebagai audit seluruh inbox.

Telegram meminta sistem untuk menunggu: Patuhi informasi tunggu/coba lagi yang dikembalikan. Sinkronisasi tahan lama Chiho dapat melaporkan waiting_for_telegram dengan waktu lanjut. Memulai ulang pekerjaan berulang kali bukan cara untuk menghapus batas Telegram, dan panduan ini tidak membuat janji throughput tak terbatas.

Sebuah alat hilang atau penulisan ditolak: Periksa daftar alat yang terautentikasi, scope, kontrol klien, dan status pratinjau/persetujuan yang diperlukan. Jangan memperluas akses hanya agar error hilang. Kembali ke tindakan terkecil yang benar-benar dibutuhkan alur kerja Anda.

Cabut akses dan pilih alur kerja berikutnya

Buka Klien AI yang terhubung di Chiho untuk memeriksa klien dan cakupan. Cabut koneksi saat tidak lagi diperlukan; Chiho membatalkan akses dan token refresh-nya, dan menyambung ulang memerlukan persetujuan lagi. Menghapus server dari konfigurasi klien AI adalah langkah housekeeping yang terpisah. Pencabutan tidak dapat menarik kembali konten yang sudah terlanjur dikembalikan ke klien tersebut.

Untuk pekerjaan tanpa pengawasan yang terkontrol, lihat panduan token layanan lanjutan. Token layanan bukan jalur onboarding interaktif biasa dan tidak boleh muncul dalam tangkapan layar, konfigurasi yang dibagikan, atau pesan dukungan.

Setelah latihan hanya-baca, pilih satu alur kerja yang terbatas: identifikasi komitmen dengan skill tugas tindak lanjut, atau atur percakapan menggunakan skill kualifikasi prospek. Tinjau penulisan skill sebelum menjalankannya. panduan tindak lanjut prioritas menjelaskan bagaimana tugas dan pesan pelanggan melayani tujuan yang berbeda.

Hubungkan Telegram di Chiho, selesaikan otorisasi browser, dan verifikasi satu percakapan yang dipilih sebelum memberi agen pekerjaan yang lebih luas.