Chúng tôi cung cấp ba loại API cho nhà phát triển. các Bot API cho phép bạn dễ dàng tạo các chương trình sử dụng thông báo Telegram cho một giao diện. các Telegram API và TDLib cho phép bạn xây dựng các ứng dụng khách Telegram tùy chỉnh của riêng bạn. Bạn có thể sử dụng miễn phí cả hai API. Cuối cùng, Cổng API cho phép mọi doanh nghiệp, ứng dụng hoặc trang web gửi mã xác minh qua Telegram thay vì SMS truyền thống.

Bạn cũng có thể thêm Telegram Tiện ích đến trang web của bạn.

Các nhà thiết kế được chào đón để tạo ra Nhãn dán hoạt hình và biểu tượng cảm xúc or Chủ đề tùy chỉnh cho Telegram.

Bot API

API này cho phép bạn kết nối bot với hệ thống của chúng tôi. Telegram Bot là những tài khoản đặc biệt không yêu cầu thêm số điện thoại để thiết lập. Các tài khoản này đóng vai trò là giao diện cho mã chạy ở đâu đó trên máy chủ của bạn.

Để sử dụng tính năng này, bạn không cần biết bất cứ điều gì về cách hoạt động của giao thức mã hóa MTProto của chúng tôi - máy chủ trung gian của chúng tôi sẽ xử lý tất cả mã hóa và liên lạc với Telegram API cho bạn. Bạn liên lạc với máy chủ này thông qua giao diện HTTPS đơn giản cung cấp phiên bản đơn giản hóa của Telegram API.

Tìm hiểu thêm về Bot API tại đây »

Các nhà phát triển bot cũng có thể sử dụng Thanh toán API chấp nhận thanh toán từ người dùng Telegram trên toàn thế giới.

TDLib – xây dựng Telegram của riêng bạn

Ngay cả khi đang tìm kiếm khả năng tùy chỉnh tối đa, bạn cũng không cần phải tạo ứng dụng của mình từ đầu. Hãy thử của chúng tôi Thư viện cơ sở dữ liệu Telegram (hoặc đơn giản là TDLib), một công cụ dành cho các nhà phát triển bên thứ ba giúp dễ dàng xây dựng các ứng dụng Telegram nhanh chóng, an toàn và giàu tính năng.

TDLib xử lý tất cả triển khai mạng chi tiết, mã hóa and lưu trữ dữ liệu cục bộ, để bạn có thể dành nhiều thời gian hơn cho thiết kế, giao diện phản hồi và các hiệu ứng chuyển động đẹp.

TDLib hỗ trợ tất cả các tính năng của Telegram và giúp việc phát triển ứng dụng Telegram trở nên dễ dàng trên mọi nền tảng. Nó có thể được sử dụng trên Android, iOS, Windows, macOS, Linux và hầu như bất kỳ hệ thống nào khác. Thư viện này là nguồn mở và tương thích với hầu như bất kỳ ngôn ngữ lập trình nào.

Tìm hiểu thêm về TDLib tại đây »

Cổng API

Cổng Telegram API cho phép mọi doanh nghiệp, ứng dụng hoặc trang web gửi mã ủy quyền thông qua Telegram thay vì SMS truyền thống – cung cấp một cách mạnh mẽ và thuận tiện để giảm chi phí đồng thời tăng bảo vệ and tốc độ giao hàng mã của bạn cho 1 tỷ người dùng hoạt động hàng tháng của Telegram. Người dùng sẽ nhận ngay lập tức tin nhắn có mã trong cuộc trò chuyện đặc biệt bên trong Telegram.

Cổng API của Telegram được thử nghiệm hoàn toàn miễn phí. Tìm hiểu thêm tại đây »

Telegram API

API này cho phép bạn xây dựng các máy khách Telegram tùy chỉnh của riêng mình. Nó mở 100% cho tất cả các nhà phát triển muốn tạo ứng dụng Telegram trên nền tảng của chúng tôi. Hãy thoải mái nghiên cứu mở mã nguồn các ứng dụng Telegram hiện có để biết ví dụ về cách mọi thứ hoạt động ở đây. Đừng quên đăng ký ứng dụng của bạn trong hệ thống của chúng tôi.

Bắt đầu
Bảo vệ
Tối ưu hóa
Phương pháp API

Bắt đầu

Tạo một ứng dụng

Cách lấy số nhận dạng ứng dụng của bạn và tạo ứng dụng Telegram mới.

Ủy quyền người dùng

Cách đăng ký điện thoại của người dùng để bắt đầu sử dụng API.

Xác thực hai yếu tố

Cách đăng nhập vào tài khoản người dùng nếu họ đã bật 2FA và cách thay đổi mật khẩu.

Đăng nhập mã QR

mã QR luồng đăng nhập.

Khóa truy cập

Telegram cho phép tạo mật mã trên thiết bị của bạn để đăng nhập ngay vào Telegram bằng mã PIN hoặc dữ liệu sinh trắc học như Face ID và dấu vân tay - thay vì mã SMS.

Xử lý lỗi

Cách xử lý chính xác lỗi trả về API.

Xử lý các trung tâm dữ liệu khác nhau

Cách kết nối với điểm truy cập DC gần nhất để tương tác nhanh hơn với API và những điều cần lưu ý khi phát triển ứng dụng khách.

Xử lý các bản cập nhật

Cách đăng ký nhận bản cập nhật và xử lý chúng đúng cách.

Xử lý thông báo PUSH

Làm thế nào để đăng ký và xử lý chúng đúng cách.

Kênh, siêu nhóm, gigagroup và nhóm cơ bản

Cách xử lý các kênh, siêu nhóm, nhóm gigagroup, nhóm cơ bản và sự khác biệt giữa chúng là gì.

Diễn đàn

Telegram cho phép tạo diễn đàn với nhiều chủ đề riêng biệt.

Bot cũng có thể sử dụng các chủ đề nếu được kích hoạt thông qua @botfather.

Tin nhắn trực tiếp đến các kênh

Telegram hỗ trợ tin nhắn trực tiếp tới các kênh, tin nhắn này cũng có thể được sử dụng để đề xuất các bài đăng trên kênh (thậm chí trả phí).

Thống kê kênh

Telegram cung cấp số liệu thống kê chi tiết cho các kênh và siêu nhóm.

Số lượt xem tin nhắn và số liệu đã đọc

Cách báo cáo trạng thái đọc, lượt xem bài đăng trên kênh, số liệu đọc tin nhắn và lượt nghe nhạc.

Phương thức gọi

Tùy chọn bổ sung cho phương thức gọi.

Tải lên và tải xuống các tập tin

Cách chuyển các lô dữ liệu lớn một cách chính xác.

Phân trang

Cách lấy kết quả từ các danh sách lớn các đối tượng.

Cấu hình máy khách

MTProto API có nhiều tham số cấu hình khách hàng có thể được lấy bằng các phương pháp thích hợp.

Cuộc gọi

Telegram hỗ trợ các cuộc gọi một-một được mã hóa E2E.

Cuộc gọi nhóm

Telegram hỗ trợ các cuộc gọi nhóm được mã hóa E2E.

Bảo vệ

Trò chuyện bí mật, mã hóa đầu cuối

Nhắn tin được mã hóa đầu cuối.

Hướng dẫn bảo mật

Kiểm tra quan trọng cần thiết trong ứng dụng khách của bạn.

Bí mật chuyển tiếp hoàn hảo

Ràng buộc các khóa ủy quyền tạm thời với các khóa vĩnh viễn.

Mã hóa đầu cuối trong các cuộc gọi thoại và video

Cuộc gọi được mã hóa đầu cuối.

Mã hóa đầu cuối trong cuộc gọi nhóm

Cuộc gọi nhóm được mã hóa đầu cuối.

Bảo mật chuyển tiếp hoàn hảo trong cuộc trò chuyện bí mật

Tái khóa các cuộc trò chuyện bí mật để cung cấp Tính Bảo Mật Tiến Triển Hoàn Hảo.

Số thứ tự trong Trò chuyện bí mật

Cách gán và giải thích số thứ tự bộ đếm trong các cuộc trò chuyện bí mật.

Tối ưu hóa

Tối ưu hóa khách hàng

Các cách để tăng cường tương tác API.

Phương pháp API

Danh sách phương pháp có sẵn

Một danh sách các phương pháp cấp cao có sẵn.

API TL-lược đồ, như JSON

Trình bày văn bản và JSON về các loại và phương thức được sử dụng trong API.

Nhật ký thay đổi lớp

Nhật ký thay đổi chi tiết của các phiên bản lược đồ có sẵn.

Các bài viết khác

Làm việc với bot, sử dụng MTProto API

Cách làm việc với bot sử dụng MTProto API.

tính năng AI của Telegram,

Telegram cung cấp nhiều tính năng AI được hỗ trợ bởi Kén — một mạng lưới phi tập trung được thiết kế để tối đa hóa quyền riêng tư.

ID hội thoại Bot API

ID hộp thoại bot API là một chuỗi ID ngang hàng 64 bit duy nhất được lấy từ chuỗi ID người dùng, trò chuyện, kênh và trò chuyện bí mật, duy trì tính duy nhất trên tất cả chúng.

Trang này chỉ định cách chuyển đổi ID ngang hàng MTProto thành ID hộp thoại bot API và ngược lại.

Bot được quản lý

Người dùng có thể tạo được quản lý các bot (được điều khiển bởi một bot quản lý cụ thể) trực tiếp thông qua MTProto API, mà không tương tác với @BotFather.

Lệnh

Bot cung cấp một tập hợp các lệnh có thể được người dùng sử dụng riêng tư, hoặc trong một cuộc trò chuyện.

Nút bấm

Người dùng có thể tương tác với bot của bạn qua nút hoặc thậm chí nút nội tuyến, trực tiếp từ dòng tin nhắn in any trò chuyện.

Nút trình đơn

Bot có thể chọn hành vi của nút menu hiển thị bên cạnh trường nhập văn bản.

Truy vấn nội tuyến

Người dùng có thể tương tác với bot của bạn qua truy vấn nội tuyến, trực tiếp từ ô nhập văn bản in any trò chuyện.

Nền tảng Trò chơi

Bot có thể cung cấp cho người dùng các trò chơi HTML5 để chơi một mình hoặc để cạnh tranh với nhau trong các nhóm và trò chuyện một đối một; cách làm việc với các trò chơi trong MTProto API.

Ứng dụng nhỏ

Bot có thể cung cấp cho người dùng tính tương tác ứng dụng mini HTML5 để thay thế hoàn toàn bất kỳ trang web nào.

Chương trình liên kết

Các nhà phát triển có thể mở chương trình liên kết cho họ ứng dụng mini mới – cho phép người sáng tạo nội dung, other nhà phát triển ứng dụng mini and bất kỳ người dùng Telegram nào để quảng bá nó và kiếm tiền hoa hồng khi mua hàng được thực hiện bởi những người mà họ giới thiệu.

Trình đơn đính kèm

Bot có thể cài đặt các mục trình đơn đính kèm, cung cấp các ứng dụng nhỏ tiện lợi và đa năng dễ dàng truy cập.

Chỉnh sửa thông tin bot

Người dùng có thể chỉnh sửa và bản địa hóa ảnh đại diện, tên, văn bản giới thiệu và mô tả của các bot mà họ sở hữu; bot cũng có thể làm điều tương tự.

bot AI

Các bot Telegram cung cấp một số tính năng cho chatbot AI.

Chế độ khách

Các bot khách có thể được truy vấn theo tên người dùng từ bất kỳ cuộc trò chuyện riêng tư không bí mật nào, nhóm và siêu nhóm, đăng kết quả của chúng trực tiếp vào cuộc trò chuyện, ngay cả khi chúng không phải là thành viên.

Giao tiếp giữa các bot »

Bot có thể nhận và gửi tin nhắn đến và từ các bot khác trong các nhóm, trò chuyện riêng và trò chuyện, nếu Chế độ Giao tiếp Bot-to-Bot được bật.

Stories

Người dùng và kênh Telegram có thể dễ dàng đăng và xem câu chuyện thông qua API.

Các kênh và bot tương tự

API cung cấp một phương pháp để lấy danh sách các kênh công khai và bot có chủ đề tương tự, được chọn dựa trên sự giống nhau trong chúng dữ liệu người đăng ký.

Màu nhấn

Người dùng và kênh Telegram có thể thay đổi màu nhấn và mẫu nền của trang hồ sơ và tin nhắn của họ!

Cài đặt quyền riêng tư

Telegram cho phép người dùng chỉ định các cài đặt quyền riêng tư chi tiết, lựa chọn người dùng nào có thể hoặc không thể tương tác với họ theo những cách nhất định.

Tìm kiếm & bộ lọc

Telegram cho phép áp dụng bộ lọc tin nhắn chi tiết khi tìm kiếm tin nhắn trong các cuộc trò chuyện.
Điều này cho phép máy chủ lọc các tin nhắn dựa trên truy vấn văn bản, và thậm chí dựa trên loại của chúng, và tính năng này thường được các khách hàng đồ họa sử dụng để triển khai các tính năng như thư viện trò chuyện, ảnh đại diện trò chuyện và nhiều hơn nữa.

Cuộc thăm dò ý kiến

Telegram cho phép gửi các cuộc thăm dò và câu đố, có thể được hàng nghìn, nếu không muốn nói là hàng triệu người dùng bỏ phiếu trong các trò chuyện và kênh.

Danh sách kiểm tra

Người dùng cao cấp giờ đây có thể tạo danh sách kiểm tra hợp tác trong bất kỳ cuộc trò chuyện nào để theo dõi công việc và phối hợp nhóm — hoặc quản lý danh sách mua sắm và việc cần làm.

Phản ứng

Telegram cho phép người dùng phản ứng với bất kỳ tin nhắn nào bằng các biểu tượng cảm xúc cụ thể, kích hoạt các hoạt hình Lottie dễ thương.

Hiệu ứng tin nhắn động

Telegram cho phép thêm các hiệu ứng động tuyệt đẹp vào các tin nhắn bạn gửi.

Các loại emoji

Giao diện chọn sticker, emoji tùy chỉnh và GIF nên cung cấp một danh sách các danh mục để nhanh chóng lọc kết quả theo một (danh sách) emoji, hoặc theo một số tiêu chí khác.

Trạng thái emoji

Telegram cho phép người dùng đặt một biểu tượng cảm xúc hoặc một biểu tượng cảm xúc tùy chỉnh làm trạng thái, hiển thị bên cạnh tên của họ trong cuộc trò chuyện và hồ sơ.

Liên kết mời và yêu cầu tham gia

Các kênh, nhóm cơ bản và siêu nhóm có thể có tên người dùng công khai hoặc liên kết mời riêng tư: các liên kết mời riêng tư có thể được cải thiện thêm với yêu cầu tham gia theo từng người dùng.

Quyền quản trị viên, quyền bị cấm và quyền mặc định cho kênh, siêu nhóm và nhóm

Cách quản lý quyền quản trị, cấm chi tiết và quyền toàn cầu trong các kênh, nhóm và siêu nhóm.

Nhóm thảo luận

Nhóm có thể được liên kết với một kênh của bạn như một nhóm thảo luận, cho phép người dùng thảo luận về các bài đăng.

Bình luận kênh và chuỗi tin nhắn

Telegram cho phép bình luận về một bài đăng kênh hoặc trên một loại chung tin nhắn nhóm, nhờ vào các chuỗi tin nhắn.

Nhật ký quản trị

Cả siêu nhóm và kênh đều cung cấp cái gọi là nhật ký quản trị, một nhật ký các hành động gần đây liên quan đến siêu nhóm và kênh, như việc sửa đổi cài đặt nhóm/kênh hoặc thông tin thay mặt quản trị viên, việc đá và cấm người dùng, và nhiều hơn nữa.

Tin nhắn ghim

Telegram cho phép ghim nhiều tin nhắn lên đầu một cuộc trò chuyện cụ thể.

Thẻ thành viên/quản trị viên nhóm

Các thành viên trong các cuộc trò chuyện nhóm (cả nhóm cơ bản và siêu nhóm) hiện có thể thêm một tag bên cạnh tên của họ — để hiển thị vai trò của họ tại nơi làm việc, những gì họ học ở trường, và hơn thế nữa.

Nhắc đến

Telegram cho phép nhắc đến người dùng khác trong trường hợp các vấn đề gấp liên quan đến vịt con, và nhanh chóng điều hướng đến những nhắc đến đó để đọc chúng càng nhanh càng tốt.

Tin nhắn đã lên lịch

Telegram cho phép lập lịch gửi tin nhắn.

Vị trí địa lý trực tiếp

Telegram cho phép gửi vị trí địa lý trực tiếp của người dùng trong một cuộc trò chuyện, có thể tùy chọn thiết lập cảnh báo gần vị trí.

Cơ sở dữ liệu đồng đẳng

Cách làm việc với thông tin đồng nghiệp trong API.

Các hàm tạo Min

Đôi khi, người dùng and kênh của bạn các hàm tạo gặp phải trong các bản cập nhật trò chuyện nhóm có thể không chứa thông tin đầy đủ về người dùng: trang này giải thích cách xử lý các hàm tạo đó.

Xóa tài khoản

Cách xóa tài khoản Telegram.

Tin nhắn đã nhập

Telegram cho phép nhập tin nhắn và phương tiện từ các ứng dụng trò chuyện nước ngoài.

Hộ chiếu Telegram

Cách làm việc với Hộ chiếu Telegram sử dụng trực tiếp MTProto API.

Thanh toán Telegram

Cách làm việc trực tiếp với Thanh toán Telegram bằng MTProto API.

Xác minh của bên thứ ba

Để cải thiện thêm tính minh bạch về Telegram, dịch vụ chính thức của bên thứ ba có thể chỉ định biểu tượng xác minh bổ sung vào các tài khoản người dùng và trò chuyện — để ngăn chặn lừa đảo and giảm thông tin sai lệch.

Văn bản được định kiểu với các thực thể tin nhắn

Cách tạo văn bản có kiểu với các thực thể tin nhắn.

Làm việc với GIF

Khách hàng Telegram hỗ trợ hiển thị GIF.

Làm việc với nhãn dán

Máy khách Telegram hỗ trợ hiển thị nhãn dán động, tĩnh và video.

Làm việc với biểu tượng cảm xúc tùy chỉnh

Telegram cho phép chèn các biểu tượng cảm xúc động, tĩnh và video tùy chỉnh trực tiếp vào trong tin nhắn.

Làm việc với biểu tượng cảm xúc hoạt hình

Các khách hàng đồ họa Telegram nên biến đổi emoji thành các phiên bản hoạt hình tương ứng của chúng.

Làm việc với xúc xắc hoạt hình

Telegram hỗ trợ gửi xúc xắc hoạt hình biểu tượng cảm xúc.

Nháp tin nhắn

Cách xử lý bản nháp tin nhắn.

Thư Mục

Làm việc với các thư mục.

Xếp hạng ngang hàng hàng đầu

If đã bật, xếp hạng của đối tác hàng đầu chỉ ra sự liên quan của một đồng nghiệp được sử dụng thường xuyên trong một số thể loại (người dùng nhắn tin thường xuyên, bot được sử dụng thường xuyên, bot nội tuyến, kênh thường xuyên truy cập, v.v.).

Xử lý các tham chiếu tệp

Cách xử lý tham chiếu tệp.

Đăng nhập Telegram liền mạch

Xử lý các yêu cầu ủy quyền URL đăng nhập Telegram liền mạch.

Hình nền

Cách làm việc với hình nền trò chuyện.

Âm thông báo

Cách làm việc với âm thanh thông báo trò chuyện.

Ghi âm tin nhắn

Cách chuyển đổi tin nhắn thoại thành văn bản.

Dịch tin nhắn

Telegram cho phép dịch tin nhắn trò chuyện, và Telegram Premium người dùng thậm chí có thể kích hoạt tính năng dịch trò chuyện theo thời gian thực.

Hệ thống chống thư rác gốc

Quản trị viên của các siêu nhóm có số lượng thành viên nhất định có thể chọn phát huy toàn bộ sức mạnh chủ động của thuật toán chống thư rác của riêng Telegram – bật chế độ Linh hoạt mới cho các bộ lọc thư rác tự động.

Đồ sưu tầm

Người dùng Telegram có thể giúp người khác dễ dàng liên lạc với họ hoặc tìm thấy các nhóm và kênh công khai của họ thông qua tên người dùng: khách hàng cũng có thể chỉ định nhiều Mảnh vỡ » tên người dùng có thể sưu tập tới các tài khoản, siêu nhóm và kênh mà họ sở hữu; Mảnh vỡ » cũng cho phép mua sưu tầm số điện thoại có thể dùng để đăng ký tài khoản Telegram.

Telegram Premium

Telegram Premium là một dịch vụ đăng ký tùy chọn cho phép mở khóa các tính năng độc quyền bổ sung phía khách hàng và phía API, đồng thời giúp hỗ trợ phát triển ứng dụng. Nó là một phần của Telegram kiếm tiền bền vững – được thúc đẩy bởi người dùng của chúng tôi, thay vì nhà quảng cáo hay cổ đông. Bằng cách này, Telegram có thể duy trì độc lập và ưu tiên người dùng trước tiên.

Telegram Business

Người dùng có thể biến tài khoản Telegram của họ thành một tài khoản doanh nghiệp, truy cập vào các tính năng kinh doanh như giờ mở cửa, vị trí, trả lời nhanh, tin nhắn tự động, trang bắt đầu tùy chỉnh, hỗ trợ chatbot và nhiều hơn nữa.

Hầu hết các tính năng của Telegram Business đều có sẵn cho Telegram Premium » người đăng ký; bot kinh doanh kết nối » cũng có sẵn cho người dùng không phải trả phí.

Telegram Stars

Telegram Stars là các vật phẩm ảo cho phép người dùng mua hàng hóa và dịch vụ kỹ thuật số từ bot và ứng dụng nhỏ bên trong hệ sinh thái Telegram, gửi quà tặng cho người sáng tạo nội dung trên nền tảng Telegram, v.v.

Đăng ký

Bot và kênh có thể tạo đăng ký, định kỳ tính phí người dùng một khoản nhất định Telegram Stars để đổi lấy nội dung và dịch vụ.

Nội dung được bảo vệ

Người dùng và bot muốn giữ tin nhắn của họ riêng tư, cũng như chủ sở hữu Nhóm và Kênh muốn giữ nội dung chỉ dành cho thành viên có thể hạn chế việc chuyển tiếp tin nhắn từ trò chuyện của họ, điều này cũng ngăn chặn chụp màn hình, vô hiệu hóa chuyển tiếp tin nhắn (việc cố gắng chuyển tiếp các tin nhắn được bảo vệ sẽ phát ra một ĐANG GIỚI HẠN CHUYỂN TIẾP TRÒ CHUYỆN lỗi RPC) và hạn chế khả năng lưu phương tiện từ bài viết.

Quà tặng

Người dùng có thể gửi Quà tặng cho bạn bè của họ. Người nhận quà có thể hiển thị chúng trên trang hồ sơ của mình hoặc biến chúng thành Telegram Stars ». Telegram Stars có thể được sử dụng cho nhiều mục đích, bao gồm hỗ trợ các nhà sáng tạo và mua dịch vụ trong các mini app.

Tài liệu Telegram API