API-интерфейсы Telegram

Мы предлагаем три вида API для разработчиков. API для ботов позволяет легко создавать программы, использующие сообщения Telegram в качестве интерфейса. Telegram API и TDLib позволяют вам создавать свои собственные клиенты Telegram. Вы можете использовать оба API бесплатно. Наконец, API шлюза позволяет любому бизнесу, приложению или веб-сайту отправлять коды подтверждения через Telegram вместо традиционных SMS.

Вы также можете добавить Виджеты Telegram на ваш сайт.

Дизайнеры могут создавать анимированные стикеры и эмодзи или пользовательские темы для Telegram.

API для ботов

Этот API позволяет подключать ботов к нашей системе. Telegram-боты — это специальные учетные записи, для настройки которых не требуется дополнительный номер телефона. Эти учетные записи служат интерфейсом для кода, выполняющегося где-то на вашем сервере.

Чтобы использовать это, вам не нужно ничего знать о том, как работает наш протокол шифрования MTProto — наш промежуточный сервер выполнит все шифрование и связь с Telegram API за вас. Вы общаетесь с этим сервером через простой интерфейс HTTPS, который предлагает упрощенную версию API Telegram.

Узнайте больше об API для ботов здесь »

Разработчики ботов также могут использовать платёжный API, чтобы принимать платежи от пользователей Telegram по всему миру.

TDLib – создайте свой собственный Telegram

Даже если вы ищете максимальную настройку, вам не обязательно создавать приложение с нуля. Попробуйте наш Библиотека базы данных Telegram (или просто TDLib), инструмент для сторонних разработчиков, который позволяет легко создавать быстрые, безопасные и многофункциональные приложения Telegram.

TDLib берёт на себя все детали сетевого взаимодействия, шифрование и локальное хранение данных, чтобы вы могли уделять больше времени дизайну, адаптивным интерфейсам и красивой анимации.

TDLib поддерживает все функции Telegram и упрощает разработку приложений Telegram на любой платформе. Его можно использовать на Android, iOS, Windows, macOS, Linux и практически в любой другой системе. Библиотека имеет открытый исходный код и совместима практически с любым языком программирования.

Узнайте больше о TDLib здесь »

API шлюза

API Telegram Gateway позволяет любому бизнесу, приложению или веб-сайту отправлять коды авторизации через Telegram вместо традиционных SMS, предлагая мощный и удобный способ снизить затраты и одновременно повысить безопасность и скорость доставки кодов 1 миллиарду активных пользователей Telegram в месяц. Пользователи будут мгновенно получать сообщения с кодами в специальном чате внутри Telegram.

API шлюза Telegram можно протестировать совершенно бесплатно. Узнайте больше здесь »

API Telegram

Этот API позволяет вам создавать свои собственные клиенты Telegram. Он на 100% открыт для всех разработчиков, желающих создавать приложения Telegram на нашей платформе. Не стесняйтесь изучать открытый исходный код существующих приложений Telegram для примеров того, как здесь все работает. Не забудьте зарегистрироваться ваше приложение в нашей системе.

Начало работы
Безопасность
Оптимизация
Методы API

Начало работы

Создание приложения

Как получить идентификатор вашего приложения и создать новое приложение Telegram.

Авторизация пользователя

Как зарегистрировать телефон пользователя, чтобы начать использовать API.

Двухфакторная аутентификация

Как войти в учетную запись пользователя, если у него включена 2FA, и как изменить пароль.

вход по QR-коду

QR-код поток входа в систему.

Ключи доступа

Telegram позволяет создать на вашем устройстве ключ доступа для мгновенного входа в Telegram с помощью PIN-кода или биометрических данных, таких как Face ID и отпечатки пальцев, вместо кода SMS.

Обработка ошибок

Как правильно обрабатывать ошибки возврата API.

Работа с разными дата-центрами

Как подключиться к ближайшей точке доступа DC для более быстрого взаимодействия с API и на что следует обратить внимание при разработке клиента.

Обработка обновлений

Как подписаться на обновления и правильно с ними обращаться.

Обработка PUSH-уведомлений

Как подписаться и правильно с ними обращаться.

Каналы, супергруппы, гигагруппы и базовые группы

Как работать с каналами, супергруппами, гигагруппами, базовыми группами и в чем между ними разница.

Форумы

Telegram позволяет создавать форумы с несколькими разными темами.

Боты также могут использовать темы, если это разрешено через @botfather.

Прямые сообщения в каналы

Telegram поддерживает прямые сообщения каналам, которые также можно использовать для предложения (даже платных) публикаций на каналах.

Статистика канала

Telegram предлагает подробную статистику по каналам и супергруппам.

Просмотры сообщений и показатели чтения

Как сообщить о состоянии чтения, просмотрах публикаций на канале, показателях чтения сообщений и прослушивании музыки.

Методы вызова

Дополнительные возможности вызова методов.

Загрузка и скачивание файлов

Как правильно передавать большие пакеты данных.

Пагинация

Как получить результаты из больших списков объектов.

Конфигурация клиента

API MTProto имеет несколько параметров конфигурации клиента, которые можно получить с помощью соответствующих методов.

Звонки

Telegram поддерживает индивидуальные звонки с шифрованием E2E.

Групповые звонки

Telegram поддерживает групповые вызовы с шифрованием E2E.

Безопасность

Секретные чаты, сквозное шифрование

Сквозное шифрование сообщений.

Совершенная прямая секретность

Привязка временных ключей авторизации к постоянным.

Сквозное шифрование в голосовых и видеозвонках

Звонки со сквозным шифрованием.

Сквозное шифрование в групповых вызовах

Групповые звонки со сквозным шифрованием.

Совершенная прямая секретность в секретных чатах

Повторный ввод секретных чатов для обеспечения полной прямой секретности.

Порядковые номера в секретных чатах

Как назначить и интерпретировать seq_no счетчики в секретных чатах.

Оптимизация

Оптимизация клиента

Способы улучшения взаимодействия API.

Методы API

Список доступных методов

Список доступных методов высокого уровня.

API TL-схема, как JSON

Текстовое и JSON-представление типов и методов, используемых в API.

Журнал изменений слоев

Подробный журнал изменений доступных версий схемы.

Другие статьи

Работа с ботами с использованием MTProto API

Как работать с ботами с помощью MTProto API.

Возможности ИИ

Telegram предлагает множество функций искусственного интеллекта, основанных на Cocoon — децентрализованная сеть, предназначенная для обеспечения максимальной конфиденциальности.

Идентификаторы диалогов API ботов

Идентификатор диалога API для ботов — это единая уникальная 64-битная последовательность идентификаторов одноранговых узлов, полученная из последовательностей идентификаторов пользователя, чата, канала и секретного чата, сохраняющая уникальность для всех из них.

Эта страница определяет, как преобразовать идентификаторы узлов MTProto в идентификаторы диалогов API для ботов и наоборот.

Управляемые боты

Пользователи могут создавать управляемый ботов (которые управляются конкретным ботом-менеджером) напрямую через API MTProto, без взаимодействия с @BotFather.

Команды

Боты предложить набор команд, которые пользователи могут использовать приватно или в чате.

Кнопки

Пользователи могут взаимодействовать с вашим ботом через кнопки или даже встроенные кнопки, прямо из встроенного сообщения в любой чат.

Кнопка меню

Боты могут выбирать поведение кнопки меню, отображаемой рядом с полем ввода текста.

Встроенные запросы

Пользователи могут взаимодействовать с вашим ботом через встроенные запросы, прямо из поле ввода текста в любой чат.

Игры

Боты могут предлагать пользователям игры HTML5, в которые можно играть в одиночку или соревноваться друг с другом в группах и чатах один на один; как работать с играми в MTProto API.

Мини-приложения

Боты могут предлагать пользователям интерактивные Мини-приложения HTML5 полностью заменить любой веб-сайт.

Партнерские программы

Разработчики могут открывать партнерские программы для своих мини-приложение - позволяя создатели контента, другое разработчики мини-приложений и любой пользователь Telegram продвигать его и получать комиссионные от покупок, сделанных людьми, которых они пригласили.

Меню вложений

Боты могут устанавливать пункты меню вложений, предлагая удобные и универсальные мини-приложения.

Редактирование информации о боте

Пользователи могут редактировать и локализовать изображение профиля, имя, текст и описание ботов, которыми они владеют; то же самое могут сделать и сами боты.

ИИ-боты

Боты Telegram предлагают ряд функций для чат-ботов с искусственным интеллектом.

Гостевой режим

Гостевых ботов можно запрашивать по имени пользователя из любого несекретного частного чата, группы и супергруппы, публикуя свои результаты непосредственно в чате, даже если они не являются его участниками.

Общение между ботами »

Боты могут получать и отправлять сообщения другим ботам и от них в группах, частных чатах и чатах, если включен режим связи «бот-бот».

Истории

Пользователи и каналы Telegram могут легко публиковать и просматривать истории через API.

Акцентные цвета

Пользователи и каналы Telegram могут изменить цвет акцента и фоновый рисунок страницы своего профиля и своих сообщений!

Настройки конфиденциальности

Telegram позволяет пользователям задавать детальные настройки конфиденциальности, выбирая, какие пользователи могут или не могут взаимодействовать с ними определенными способами.

Поиск и фильтры

Telegram позволяет применять детальные фильтры сообщений при поиске сообщений в чатах.
Это позволяет серверу фильтровать сообщения на основе текстового запроса и даже по их типу, и эта функция часто используется графическими клиентами для реализации таких функций, как галерея чата, изображения профиля чата и многое другое.

Опросы

Telegram позволяет отправлять опросы и викторины, за которые могут голосовать тысячи, если не миллионы пользователей в чатах и каналах.

Контрольные списки

Премиум-пользователи теперь могут создавать совместные контрольные списки в любом чате для отслеживания задач и координации команд, а также управлять списками покупок и дел.

Реакции

Telegram позволяет пользователям реагировать на любое сообщение с помощью определенных смайлов, вызывая милые анимации Лотти.

Эффекты анимированных сообщений

Telegram позволяет добавлять к отправляемым сообщениям эффектные анимированные эффекты.

Категории эмодзи

Интерфейсы выбора стикеров, пользовательских смайлов и GIF-файлов должны предлагать список категорий для быстрой фильтрации результатов по (списку) смайлов или по каким-либо другим критериям.

Статус эмодзи

Telegram позволяет пользователям устанавливать смайлик или пользовательские смайлы в качестве статуса, чтобы показывать его рядом с именем в чатах и профилях.

Пригласительные ссылки и запросы на присоединение

Каналы, базовые группы и супергруппы могут иметь общедоступное имя пользователя или частную ссылку для приглашения: частные ссылки для приглашения могут быть дополнительно расширены за счет запросов на присоединение для каждого пользователя.

Права администратора, запрета и права по умолчанию для каналов, супергрупп и групп.

Как обрабатывать права администратора, детальные запреты и глобальные разрешения в каналах, группах и супергруппах.

Дискуссионные группы

Группы может быть связано с канал как дискуссионная группа, позволяя пользователям обсуждать сообщения.

Комментарии к каналу и цепочки сообщений

Telegram позволяет комментировать пост на канале или на общем групповое сообщение, благодаря тредам сообщений.

Журнал администратора

И супергруппы, и каналы предлагают так называемую журнал администратора, журнал недавних соответствующих действий супергруппы и канала, таких как изменение настроек группы/канала или информации от имени администратора, удаление и блокировка пользователей и многое другое.

Закрепленные сообщения

Telegram позволяет закреплять несколько сообщений поверх определенного чата.

Теги участника/администратора группы

Участники групповых чатов (как базовых, так и супергрупп) теперь могут добавлять тег рядом с именем — чтобы показать их роль на работе, что они изучают в школе и многое другое.

Упоминания

Telegram позволяет упоминать других пользователей в случае неотложных дел по поводу утенка и быстро переходить к этим упоминаниям, чтобы как можно быстрее их прочитать.

Запланированные сообщения

Telegram позволяет планировать сообщения.

Живые геолокации

Telegram позволяет отправлять в чат данные о геолокации пользователя в реальном времени, при необходимости устанавливая оповещение о приближении.

Одноранговая база данных

Как работать с информацией о пирах в API.

Мин конструкторы

Иногда, пользователь и канал Конструкторы, встречающиеся в обновлениях группового чата, могут не содержать полной информации о пользователе: на этой странице объясняется, как обращаться с такими конструкторами.

Удаление аккаунта

Как удалить аккаунт Telegram.

Импортированные сообщения

Telegram позволяет импортировать сообщения и медиафайлы из зарубежных чат-приложений.

Telegram Паспорт

Как работать с Telegram Паспорт напрямую с помощью API MTProto.

Платежи в Telegram

Как работать с Telegram Payments напрямую с помощью MTProto API.

Сторонняя проверка

Чтобы еще больше повысить прозрачность в Telegram, официальные сторонние сервисы умеют назначать дополнительные значки проверки к аккаунтам пользователей и чатам — чтобы предотвращать мошенничество и уменьшить дезинформацию.

Стилизованный текст с объектами сообщений

Как создать стилизованный текст с помощью объектов сообщений.

Работа с GIF-файлами

Клиенты Telegram поддерживают отображение GIF-файлов.

Работа со стикерами.

Клиенты Telegram поддерживают отображение анимированных, статических и видеостикеров.

Работа с пользовательскими смайлами

Telegram позволяет включать собственные анимированные, статические и видеосмайлы непосредственно в сообщения.

Работа с анимированными смайлами

Графические клиенты Telegram должны преобразовывать смайлы в соответствующие анимированные версии.

Работа с анимированными кубиками

Telegram поддерживает отправку анимированные кости смайлики.

Черновики сообщений

Как обрабатывать черновики сообщений.

Папки

Работа с папками.

Высший рейтинг коллег

Если включен, рейтинг лучшие коллеги указывает на актуальность часто используемого узла в определенном категория (часто отправляющие сообщения пользователи, часто используемые боты, встроенные боты, часто посещаемые каналы и т. д.).

Обработка ссылок на файлы

Как обрабатывать ссылки на файлы.

Бесшовный вход в Telegram

Обработка запросов авторизации по URL-адресу входа в Telegram.

Обои

Как работать с фоном чата.

Звуки уведомлений

Как работать со звуками уведомлений в чате.

Транскрипция сообщений

Как расшифровать голосовые сообщения.

Перевод сообщений

Telegram позволяет переводить сообщения чата и Telegram Премиум пользователи могут даже включить перевод чата в реальном времени.

Встроенная система антиспама

Администраторы супергрупп с определенным количеством участников могут раскрыть всю превентивную мощь собственных алгоритмов защиты от спама Telegram, включив новый агрессивный режим для автоматических спам-фильтров.

Коллекционирование

Пользователи Telegram могут облегчить другим возможность связаться с ними или найти их общедоступные группы и каналы через имена пользователей: клиенты также могут назначить несколько Фрагмент » коллекционные имена пользователей к принадлежащим им аккаунтам, супергруппам и каналам; Фрагмент » также позволяет приобретать коллекционные номера телефонов, которые можно использовать для регистрации учетных записей Telegram.

Telegram Премиум

Telegram Premium — это дополнительная служба подписки, которая открывает дополнительные эксклюзивные функции на стороне клиента и API, а также помогает поддерживать разработку приложения. Это часть Telegram устойчивая монетизация – движимая нашими пользователями, а не рекламодателями или акционерами. Таким образом, Telegram может оставаться независимым и в первую очередь расставлять приоритеты для своих пользователей.

Telegram Бизнес

Пользователи могут превратить свою учетную запись Telegram в бизнес-аккаунт, получая доступ к бизнес-функциям, таким как часы работы, местоположение, быстрые ответы, автоматические сообщения, настраиваемая стартовая страница, поддержка чат-ботов и многое другое.

Большинство функций Telegram Business доступны Telegram Премиум » подписчики; подключенные бизнес-боты » также доступны пользователям, не являющимся Премиум-пользователями.

Telegram Старс

Telegram Stars — это виртуальные предметы, которые позволяют пользователям приобретать цифровые товары и услуги у ботов и мини-приложений внутри экосистемы Telegram, отправлять подарки создателям контента на платформе Telegram и многое другое.

Подписки

Боты и каналы могут создавать подписки, периодически взимая с пользователей определенную сумму. Telegram Старс в обмен на контент и услуги.

Защищенный контент

Пользователи и боты, которые хотят сохранить свои сообщения конфиденциальными, а также владельцы групп и каналов, которые хотят, чтобы их контент был доступен только участникам, могут ограничить пересылку сообщений из своего чата, что также предотвращает создание снимков экрана и отключает пересылку сообщений (попытка переслать защищенные сообщения будет выдавать сообщение CHAT_FORWARDS_RESTRICTED Ошибка RPC) и ограничивает возможность сохранения медиа из постов.

Подарки

Пользователи могут отправлять Подарки своим друзьям. Получатели подарков могут отображать их на страницах своего профиля или превращать в Telegram Звезды ». Telegram Stars можно использовать для многих целей, включая поддержку авторов и покупку услуг в мини-приложениях.