Dokumentasi Telegram API

Kami menawarkan tiga jenis API untuk pengembang. The Bot API memungkinkan Anda dengan mudah membuat program yang menggunakan pesan Telegram untuk sebuah antarmuka. The Telegram API dan TDLib memungkinkan Anda membangun klien Telegram kustom Anda sendiri. Anda dipersilakan menggunakan kedua API secara gratis. Terakhir, Gerbang API memungkinkan bisnis, aplikasi, atau situs web manapun untuk mengirim kode verifikasi melalui Telegram alih-alih SMS tradisional.

Anda juga bisa menambahkan Widget Telegram ke situs web Anda.

Desainer dipersilakan untuk membuat Stiker dan Emoji Animasi or Tema Kustom untuk Telegram.


Bot API

API ini memungkinkan Anda menghubungkan bot ke sistem kami. Bot Telegram adalah akun khusus yang tidak memerlukan nomor telepon tambahan untuk dibuat. Akun ini berfungsi sebagai antarmuka untuk kode yang dijalankan di suatu tempat di server Anda.

Untuk menggunakan ini, Anda tidak perlu mengetahui apa pun tentang cara kerja protokol enkripsi MTProto kami — server perantara kami akan menangani semua enkripsi dan komunikasi dengan Telegram API untuk Anda. Anda berkomunikasi dengan server ini melalui antarmuka HTTPS sederhana yang menawarkan versi yang disederhanakan dari Telegram API.

Pelajari lebih lanjut tentang Bot API di sini »

Pengembang bot juga dapat memanfaatkan kami Pembayaran API menerima pembayaran dari pengguna Telegram di seluruh dunia.


TDLib – bangun Telegram Anda sendiri

Bahkan jika Anda mencari kustomisasi maksimal, Anda tidak perlu membuat aplikasi Anda dari awal. Coba kami Perpustakaan Database Telegram (atau cukup TDLib), sebuah alat untuk pengembang pihak ketiga yang memudahkan membangun aplikasi Telegram yang cepat, aman, dan kaya fitur.

TDLib mengurus semuanya implementasi jaringan rincian, enkripsi and penyimpanan data lokal, sehingga Anda dapat mendedikasikan lebih banyak waktu untuk desain, antarmuka responsif, dan animasi yang indah.

TDLib mendukung semua fitur Telegram dan membuat pengembangan aplikasi Telegram menjadi mudah di platform mana pun. Ini dapat digunakan di Android, iOS, Windows, macOS, Linux, dan hampir semua sistem lainnya. Perpustakaan ini bersifat sumber terbuka dan kompatibel dengan hampir bahasa pemrograman apa pun.

Pelajari lebih lanjut tentang TDLib di sini »


Gerbang API

Gateway Telegram API memungkinkan setiap bisnis, aplikasi, atau situs web untuk mengirim kode otorisasi melalui Telegram alih-alih SMS tradisional – menawarkan cara yang kuat dan nyaman untuk biaya lebih rendah sambil meningkatkan keamanan and kecepatan pengiriman dari kode Anda ke 1 miliar pengguna aktif bulanan Telegram. Pengguna akan menerima secara instan pesan dengan kode di obrolan khusus di dalam Telegram.

Gateway API milik Telegram sepenuhnya gratis untuk diuji. Pelajari lebih lanjut di sini »


Telegram API

API ini memungkinkan Anda membangun klien Telegram kustom Anda sendiri. Ini 100% terbuka untuk semua pengembang yang ingin membuat aplikasi Telegram di platform kami. Jangan ragu untuk mempelajari yang terbuka kode sumber dari aplikasi Telegram yang ada sebagai contoh bagaimana segala sesuatunya bekerja di sini. Jangan lupa untuk daftar aplikasi Anda di sistem kami.

Memulai

Membuat aplikasi

Cara mendapatkan identifier aplikasi Anda dan membuat aplikasi Telegram baru.

Otorisasi pengguna

Cara mendaftarkan ponsel pengguna untuk mulai menggunakan API.

Otentikasi dua faktor

Cara masuk ke akun pengguna jika mereka telah mengaktifkan 2FA, dan bagaimana cara mengubah kata sandi.

Login kode QR

kode QR alur login.

Kunci akses

Telegram memungkinkan membuat passkey di perangkat Anda untuk masuk ke Telegram secara instan dengan PIN atau data biometrik seperti Face ID dan sidik jari — sebagai pengganti kode SMS.

Penanganan kesalahan

Cara menangani kesalahan pengembalian API dengan benar.

Menangani berbagai pusat data

Cara terhubung ke titik akses DC terdekat untuk interaksi lebih cepat dengan API, dan hal-hal yang perlu diperhatikan saat mengembangkan klien.

Menangani pembaruan

Cara berlangganan pembaruan dan menanganinya dengan benar.

Menangani notifikasi PUSH

Cara berlangganan dan menanganinya dengan benar.

Saluran, supergrup, gigagrup, dan grup dasar

Cara menangani saluran, supergrup, gigagrup, grup dasar, dan apa perbedaan di antara mereka.

Forum

Telegram memungkinkan membuat forum dengan berbagai topik yang berbeda.

Bot juga dapat memanfaatkan topik, jika diaktifkan melalui @botfather.

Pesan langsung ke saluran

Telegram mendukung pesan langsung ke saluran, yang juga dapat digunakan untuk menyarankan posting saluran (bahkan yang berbayar).

Statistik saluran

Telegram menawarkan statistik rinci untuk saluran dan supergrup.

Tampilan pesan dan metrik baca

Cara melaporkan status terbaca, tampilan postingan saluran, metrik pesan terbaca, dan pendengaran musik.

Memanggil metode

Opsi tambahan untuk memanggil metode.

Mengunggah dan mengunduh file

Cara mentransfer batch data besar dengan benar.

Paginasi

Cara mengambil hasil dari daftar objek yang besar.

Konfigurasi klien

MTProto API memiliki beberapa parameter konfigurasi klien yang dapat diambil dengan metode yang sesuai.

Panggilan

Telegram mendukung panggilan satu lawan satu dengan enkripsi ujung ke ujung (E2E).

Panggilan grup

Telegram mendukung panggilan grup yang dienkripsi E2E.

Keamanan

Obrolan rahasia, enkripsi ujung ke ujung

Pesan yang dienkripsi secara end-to-end.

Pedoman keamanan

Pemeriksaan penting yang diperlukan dalam aplikasi klien Anda.

Kerahasian Maju Sempurna

Mengikat kunci otorisasi sementara ke kunci permanen.

Enkripsi Ujung-ke-Ujung dalam Panggilan Suara dan Video

Panggilan yang dienkripsi secara ujung-ke-ujung.

Enkripsi Ujung-ke-Ujung dalam Panggilan Grup

Panggilan grup terenkripsi ujung-ke-ujung.

Kerahasiaan Maju Sempurna dalam Obrolan Rahasia

Mengubah kunci obrolan rahasia untuk memberikan Perfect Forward Secrecy.

Nomor urut dalam Obrolan Rahasia

Cara menetapkan dan menafsirkan nomor_urut penghitung di obrolan rahasia.

Optimisasi

Optimasi klien

Cara meningkatkan interaksi API.

metode API

Daftar metode yang tersedia

Daftar metode tingkat tinggi yang tersedia.

API TL-skema, sebagai JSON

Teks dan presentasi JSON tentang tipe dan metode yang digunakan dalam API.

Catatan perubahan lapisan

Daftar perubahan rinci dari versi skema yang tersedia.

Artikel lainnya

Bekerja dengan bot, menggunakan MTProto API

Cara bekerja dengan bot menggunakan MTProto API.

Fitur AI

Telegram menawarkan banyak fitur AI yang didukung oleh Kepompong — sebuah jaringan terdesentralisasi yang dirancang untuk memaksimalkan privasi.

ID dialog Bot API

ID dialog bot API adalah urutan ID peer 64-bit tunggal dan unik yang berasal dari urutan ID pengguna, obrolan, saluran, dan obrolan rahasia, mempertahankan keunikan di seluruhnya.

Halaman ini menentukan bagaimana mengonversi ID peer MTProto ke ID dialog bot API dan sebaliknya.

Bot yang dikelola

Pengguna dapat membuat dikelola bot (yang dikendalikan oleh bot manajer tertentu) langsung melalui MTProto API, tanpa berinteraksi dengan @BotFather.

Perintah

Bot menawarkan serangkaian perintah yang dapat digunakan oleh pengguna secara pribadi, atau dalam obrolan.

Tombol

Pengguna dapat berinteraksi dengan bot Anda melalui tombol atau bahkan tombol baris, langsung dari baris pesan in any obrolan.

Tombol menu

Bot dapat memilih perilaku tombol menu yang ditampilkan di sebelah kolom input teks.

Kueri inline

Pengguna dapat berinteraksi dengan bot Anda melalui kueri inline, langsung dari kolom input teks in any obrolan.

Permainan

Bot bisa menawarkan pengguna permainan HTML5 untuk dimainkan sendiri atau untuk bersaing satu sama lain dalam grup dan obrolan satu lawan satu; cara bekerja dengan permainan di MTProto API.

Aplikasi mini

Bot dapat menawarkan interaksi kepada pengguna Aplikasi mini HTML5 untuk sepenuhnya menggantikan situs web apa saja.

Program afiliasi

Pengembang dapat membuka program afiliasi untuk mereka aplikasi mini – memungkinkan pembuat konten, other pengembang aplikasi mini and setiap pengguna Telegram untuk mempromosikannya dan mendapatkan komisi dari pembelian yang dilakukan oleh orang-orang yang mereka rujuk.

Menu lampiran

Bot dapat memasang entri menu lampiran, menawarkan aplikasi mini yang serbaguna dan mudah diakses.

Mengedit info bot

Pengguna dapat mengedit dan menyesuaikan gambar profil, nama, teks tentang, dan deskripsi bot yang mereka miliki; hal yang sama juga dapat dilakukan oleh bot itu sendiri.

Bot AI

Bot Telegram menawarkan sejumlah fitur untuk chatbot AI.

Mode tamu

Bot tamu dapat diquery berdasarkan nama pengguna dari obrolan pribadi, grup, dan supergrup non-rahasia mana pun, memposting hasil mereka langsung ke dalam obrolan, bahkan jika mereka bukan anggota.

Komunikasi bot-ke-bot »

Bot dapat menerima dan mengirim pesan ke dan dari bot lain dalam grup, obrolan pribadi, dan obrolan, jika Mode Komunikasi Bot-ke-Bot diaktifkan.

Stories

Pengguna dan saluran Telegram dapat dengan mudah memposting dan melihat cerita melalui API.

Saluran dan bot serupa

API menawarkan metode untuk mendapatkan daftar saluran publik dan bot dengan tema serupa, yang dipilih berdasarkan kesamaan dalam basis pelanggan.

Warna aksen

Pengguna dan saluran Telegram dapat mengubah warna aksen dan pola latar belakang halaman profil mereka serta pesan mereka!

Pengaturan privasi

Telegram memungkinkan pengguna untuk menentukan pengaturan privasi secara rinci, memilih pengguna mana yang dapat atau tidak dapat berinteraksi dengan mereka dengan cara tertentu.

Pencarian & filter

Telegram memungkinkan penerapan filter pesan yang rinci saat mencari pesan dalam obrolan.
Ini memungkinkan server untuk menyaring pesan berdasarkan kueri teks, dan bahkan berdasarkan jenisnya, dan fitur ini sering digunakan oleh klien grafis untuk menerapkan fitur seperti galeri obrolan, foto profil obrolan, dan lainnya.

Jajak Pendapat

Telegram memungkinkan mengirimkan jajak pendapat dan kuis, yang dapat dipilih oleh ribuan, jika bukan jutaan pengguna di obrolan dan saluran.

Daftar Periksa

Pengguna premium sekarang dapat membuat daftar periksa kolaboratif di obrolan mana pun untuk melacak tugas dan mengoordinasikan tim — atau mengelola daftar belanja dan tugas.

Reaksi

Telegram memungkinkan pengguna untuk merespons pesan apa pun menggunakan emoji tertentu, memicu animasi Lottie yang lucu.

Efek pesan animasi

Telegram memungkinkan menambahkan efek animasi spektakuler ke pesan yang Anda kirim.

Kategori emoji

Antarmuka pemilihan stiker, emoji khusus, dan GIF sebaiknya menawarkan daftar kategori untuk dengan cepat memfilter hasil berdasarkan (daftar) emoji, atau berdasarkan kriteria lain.

Status emoji

Telegram memungkinkan pengguna untuk mengatur emotikon atau a emoji khusus sebagai status, untuk ditampilkan di samping nama mereka dalam obrolan dan profil.

Tautan undangan dan permintaan bergabung

Saluran, grup dasar, dan supergrup dapat memiliki nama pengguna publik atau tautan undangan pribadi: tautan undangan pribadi dapat ditingkatkan lebih lanjut dengan permintaan bergabung per pengguna.

Admin, hak larangan dan hak default untuk saluran, supergrup, dan grup

Cara menangani izin admin, larangan terperinci, dan izin global di saluran, grup, dan supergrup.

Kelompok diskusi

Grup dapat dikaitkan dengan saluran sebagai kelompok diskusi, memungkinkan pengguna untuk mendiskusikan postingan.

Komentar saluran dan thread pesan

Telegram memungkinkan memberikan komentar pada sebuah pos saluran atau pada generik pesan grup, berkat utas pesan.

Log admin

Baik supergrup maupun saluran menawarkan apa yang disebut log admin, catatan tindakan supergroup dan saluran terbaru yang relevan, seperti perubahan pengaturan grup/saluran atau informasi atas nama admin, pengeluaran dan larangan pengguna, dan lainnya.

Pesan yang dipin

Telegram memungkinkan menyematkan beberapa pesan di atas obrolan tertentu.

Tanda anggota/admin grup

Anggota dalam obrolan grup (baik grup dasar maupun supergrup) sekarang dapat menambahkan sebuah tag di samping nama mereka — untuk menunjukkan peran mereka di tempat kerja, apa yang mereka pelajari di sekolah, dan lain-lain.

Sebutan

Telegram memungkinkan menyebut pengguna lain dalam kasus urusan anak itik yang mendesak, dan dengan cepat menavigasi ke sebutan tersebut agar dapat membacanya secepat mungkin.

Pesan terjadwal

Telegram memungkinkan penjadwalan pesan.

Lokasi geografis langsung

Telegram memungkinkan mengirimkan lokasi langsung pengguna dalam chat, dengan opsi mengatur peringatan kedekatan.

Basis data rekan

Cara bekerja dengan informasi rekan di API.

Konstruktor Min

Terkadang, pengguna and saluran konstruktor yang ditemui dalam pembaruan obrolan grup mungkin tidak berisi informasi lengkap tentang pengguna: halaman ini menjelaskan cara menangani konstruktor tersebut.

Penghapusan akun

Cara menghapus akun Telegram.

Pesan yang diimpor

Telegram memungkinkan impor pesan dan media dari aplikasi obrolan asing.

Paspor Telegram

Cara bekerja dengan Paspor Telegram langsung menggunakan MTProto API.

Pembayaran Telegram

Cara bekerja dengan Pembayaran Telegram secara langsung menggunakan MTProto API.

Verifikasi pihak ketiga

Untuk lebih meningkatkan transparansi pada Telegram, layanan pihak ketiga resmi dapat menetapkan ikon verifikasi tambahan ke akun pengguna dan obrolan — untuk mencegah penipuan and mengurangi misinformasi.

Teks bergaya dengan entitas pesan

Cara membuat teks bergaya dengan entitas pesan.

Bekerja dengan GIF

Klien Telegram mendukung menampilkan GIF.

Bekerja dengan stiker

Klien Telegram mendukung penampilan stiker animasi, statis, dan video.

Bekerja dengan emoji kustom

Telegram memungkinkan menyertakan emoji animasi, statis, dan video kustom langsung di dalam pesan.

Bekerja dengan emoji animasi

Klien Telegram grafis harus mengubah emoji menjadi versi animasi mereka masing-masing.

Bekerja dengan dadu animasi

Telegram mendukung pengiriman dadu animasi emoji.

Draf pesan

Cara menangani draf pesan.

Folder

Bekerja dengan folder.

Peringkat rekan teratas

If diaktifkan, peringkat dari rekan teratas menunjukkan relevansi dari rekan yang sering digunakan dalam suatu kategori (pengguna yang sering dikirimi pesan, bot yang sering digunakan, bot inline, saluran yang sering dikunjungi, dan sebagainya).

Menangani referensi file

Cara menangani referensi file.

Login Telegram Tanpa Hambatan

Menangani permintaan otorisasi URL login Telegram yang mulus.

Wallpaper

Cara bekerja dengan latar belakang obrolan.

Suara notifikasi

Cara bekerja dengan suara notifikasi obrolan.

Transkripsi pesan

Cara menyalin pesan suara.

Terjemahan pesan

Telegram memungkinkan menerjemahkan pesan obrolan, dan Telegram Premium pengguna bahkan dapat mengaktifkan terjemahan obrolan secara waktu nyata.

Sistem antispam bawaan

Admin supergrup dengan jumlah anggota tertentu dapat memilih untuk melepaskan kekuatan proaktif penuh dari algoritma antispam Telegram sendiri – mengaktifkan mode Agresif baru untuk filter spam otomatis.

Barang koleksi

Pengguna Telegram dapat memudahkan orang lain untuk menghubungi mereka atau menemukan grup dan saluran publik mereka melalui nama pengguna: klien juga dapat menetapkan beberapa Fragmen » nama pengguna yang bisa dikoleksi ke akun, supergrup, dan saluran yang mereka miliki; Fragmen » juga memungkinkan pembelian koleksi nomor telepon yang dapat digunakan untuk mendaftar akun Telegram.

Telegram Premium

Telegram Premium adalah layanan berlangganan opsional yang membuka fitur tambahan eksklusif di sisi klien dan sisi API, sekaligus membantu mendukung pengembangan aplikasi. Ini adalah bagian dari Telegram monetisasi yang berkelanjutan – didorong oleh pengguna kami, bukan oleh pengiklan atau pemegang saham. Dengan cara ini, Telegram dapat tetap independen dan memprioritaskan penggunanya terlebih dahulu.

Telegram Business

Pengguna dapat mengubah akun Telegram mereka menjadi akun bisnis, mendapatkan akses ke fitur bisnis seperti jam buka, lokasi, balasan cepat, pesan otomatis, halaman awal khusus, dukungan chatbot, dan lainnya.

Sebagian besar fitur Telegram Business tersedia untuk Telegram Premium » pelanggan; bot bisnis yang terhubung » juga tersedia untuk pengguna non-Premium.

Telegram Stars

Telegram Stars adalah item virtual yang memungkinkan pengguna untuk membeli barang dan layanan digital dari bot dan mini app di dalam ekosistem Telegram, mengirim hadiah kepada pembuat konten di platform Telegram, dan lain-lain.

Langganan

Bot dan saluran dapat membuat langganan, secara berkala membebankan pengguna sejumlah tertentu Telegram Stars sebagai imbalan atas konten dan layanan.

Konten terlindungi

Pengguna dan bot yang ingin menjaga pesan mereka tetap pribadi, serta pemilik Grup dan Saluran yang ingin menjaga konten mereka hanya untuk anggota dapat membatasi penerusan pesan dari obrolan mereka, yang juga mencegah tangkapan layar, menonaktifkan penerusan pesan (mencoba meneruskan pesan yang dilindungi akan menghasilkan PENGALIHAN_CHAT_TERBATAS Kesalahan RPC) dan membatasi kemampuan untuk menyimpan media dari postingan.

Hadiah

Pengguna dapat mengirim Hadiah kepada teman-teman mereka. Penerima hadiah dapat menampilkannya di halaman profil mereka atau mengubahnya menjadi Telegram Stars ». Telegram Stars dapat digunakan untuk banyak hal, termasuk mendukung pembuat konten dan membeli layanan dalam mini app.

Lelang hadiah koleksi

Untuk menjamin distribusi yang adil dari hadiah koleksi, rilis hadiah baru akan didasarkan pada lelang — memungkinkan pengguna untuk memasang tawaran dengan Stars untuk hadiah baru selama beberapa putaran.

Media berbayar

Pembuat konten dapat menerima Bintang dengan menerbitkan foto atau video berbayar on their channels. Subscribers will be allowed to view such posts only after paying the author to unlock them.

Pesan berbayar

Telegram Stars dapat digunakan untuk membayar pengiriman pesan kepada pengguna, supergrup, dan saluran yang telah dikonfigurasi Pesan Bintang », yang mengharuskan pembayaran untuk setiap pesan yang dikirim kepada mereka.

Postingan yang disarankan

Telegram menawarkan fitur monetisasi yang kuat kepada administrator saluran: pos yang disarankan.

Peningkatan saluran dan supergrup

Telegram Premium pengguna dapat memberikan saluran favorit mereka fitur tambahan seperti kemampuan untuk memposting cerita dengan memberikan mereka meningkatkan.

Hadiah & pemberian

Telegram saluran administrator dapat meluncurkan giveaway untuk didistribusikan secara acak Telegram Premium langganan dan hadiah lainnya di antara pengikut mereka, sebagai imbalan untuk meningkatkan.

Bilah aksi

Terkadang, saat berinteraksi dengan pengguna Telegram melalui obrolan pribadi atau rahasia, bilah tindakan harus ditampilkan di atas obrolan, menawarkan tombol tindakan atau pemberitahuan yang nyaman terkait pengguna.

Pesan yang disimpan

Obrolan Pesan Tersimpan memungkinkan pengguna untuk menandai pesan dan media: ini adalah penyimpanan cloud pribadi untuk setiap pesan atau media yang mungkin ingin Anda kirim atau teruskan ke sana.

Profil

Telegram menawarkan banyak opsi kustomisasi untuk profil Anda!

Tema

Aplikasi Telegram mendukung pembuatan, berbagi, dan menyinkronkan tema aplikasi.

Pesan bersponsor

Jika aplikasi Anda memungkinkan mengakses konten dari Telegram saluran, Anda harus menyertakan dukungan untuk pesan resmi yang disponsori di saluran Telegram.

Pendapatan iklan saluran dan bot

Telegram memiliki salah satu dari sistem hadiah yang paling murah hati dalam sejarah media sosial. Pemilik saluran dan bot Telegram sekarang dapat menerima 50% dari pendapatan iklan yang ditampilkan di saluran dan bot mereka.

Halaman ini menjelaskan metode yang digunakan untuk menarik pendapatan iklan saluran dan bot, serta melihat statistik pendapatan secara rinci.

Pemeriksaan fakta

Klien Telegram mendukung tampilan pemeriksaan fakta yang ditambahkan ke pesan oleh pemeriksa fakta independen.

Kontak

Bekerja dengan kontak di API.

Daftar blokir

Bekerja dengan daftar blokir.

Verifikasi usia

Beberapa legislasi mengharuskan verifikasi usia untuk melihat konten yang dibatasi: Telegram menerapkan ini melalui Main Mini App dari bot khusus.

Acara web

Saat berinteraksi dengan permainan HTML5 dan situs web gateway pembayaran, aplikasi Telegram harus menampilkan API JS berikut.

Tautan dalam

Klien Telegram harus menangani khusus tg:// and t.me tautan dalam yang ditemui dalam pesan, entitas tautan, dan di aplikasi lain dengan mendaftarkan pengelola OS.

Bawa pulang

Telegram's API memungkinkan pengguna mengekspor semua informasi mereka melalui API takeout.

Ketentuan Layanan

Syarat Layanan yang harus dipatuhi oleh semua aplikasi klien pihak ketiga.