Как создать телеграмм Бот, канал про инвестиции, "t.me"
Добавлено: 15 июл 2022, 20:11
Боты - это сторонние приложения, которые запускаются внутри Telegram. Пользователи могут взаимодействовать с ботами, отправляя им сообщения, команды и встроенные запросы. Вы управляете своими ботами, используя HTTPS-запросы к Bot API Telegram.
Полный справочник по API для разработчиков доступен здесь.
Telegram продолжает развиваться и добавлять новые функции, поэтому этот документ может содержать устаревшую информацию.
Мы ожидаем завершить обновление FAQ, руководств по ботам и других документов к концу лета 2022 года.
1. Что я могу сделать с ботами?
Чат с ботом, также показывающий результаты поиска от встроенного бота @gif
Чтобы назвать лишь несколько вещей, вы могли бы использовать ботов для:
Получайте настраиваемые уведомления и новости. Бот может действовать как умная газета, отправляя вам релевантный контент сразу после его публикации.
Интеграция с другими сервисами. Бот может обогащать чаты Telegram контентом из внешних сервисов.
Бот Gmail, GIF-бот, бот IMDB, Вики-бот, Музыкальный бот, бот Youtube, GitHubBot
Принимайте платежи от пользователей Telegram. Бот может предлагать платные услуги или работать как виртуальная витрина. Подробнее »
Бот демонстрационного магазина, демонстрационный магазин
Создавайте собственные инструменты. Бот может предоставлять вам оповещения, прогнозы погоды, переводы, форматирование или другие услуги.
Бот для уценки, бот для стикеров, бот для голосования, Лайк-бот
Создавайте одиночные и многопользовательские игры. Бот может предложить богатый интерфейс HTML5, от простых аркад и головоломок до 3D-шутеров и стратегий в реальном времени.
GameBot, Gamee
Создавайте социальные сервисы. Бот может объединять людей, которые ищут собеседников, на основе общих интересов или близости.
Делайте практически все остальное. За исключением посуды — боты ужасно моют посуду.
2. Как работают боты?
По сути, боты Telegram - это специальные учетные записи, для настройки которых не требуется дополнительный номер телефона. Пользователи могут взаимодействовать с ботами двумя способами:
Отправляйте сообщения и команды ботам, открывая чат с ними или добавляя их в группы.
Отправляйте запросы непосредственно из поля ввода, введя @username бота и запрос. Это позволяет отправлять контент из встроенных ботов непосредственно в любой чат, группу или канал.
Сообщения, команды и запросы, отправляемые пользователями, передаются программному обеспечению, работающему на ваших серверах. Наш промежуточный сервер обрабатывает все шифрование и обмен данными с API Telegram за вас. Вы общаетесь с этим сервером через простой HTTPS-интерфейс, который предлагает упрощенную версию API Telegram. Мы называем этот интерфейс нашим API ботов.
Подробное описание API ботов доступно на этой странице »
3. Как мне создать бота?
Отец ботов. Нажмите, чтобы получить изображение в высоком разрешении
Для этого есть ... бот. Просто поговорите с BotFather (описано ниже) и выполните несколько простых шагов. После того, как вы создали бота и получили свой токен аутентификации, перейдите к руководству по API ботов, чтобы узнать, чему вы можете научить своего бота.
Вы также можете ознакомиться с некоторыми примерами кода здесь »
4. Чем боты отличаются от людей?
Боты не имеют статуса онлайн и не имеют отметок времени последнего просмотра, вместо этого в интерфейсе отображается метка "бот".
У ботов ограниченное облачное хранилище — старые сообщения могут быть удалены сервером вскоре после их обработки.
Боты не могут инициировать диалоги с пользователями. Пользователь должен либо добавить их в группу, либо сначала отправить им сообщение. Люди могут использовать t.me/<bot_username>ссылки или поиск по имени пользователя, чтобы найти вашего бота.
Имена пользователей ботов всегда заканчиваются на "бот" (например, @TriviaBot, @GitHub_bot).
При добавлении в группу боты не получают все сообщения по умолчанию (см. Режим конфиденциальности).
Боты никогда не едят, не спят и не жалуются (если специально не запрограммировано иное).
5. Привилегии ботов
Боты Telegram уникальны во многих отношениях — мы предлагаем два вида клавиатур, дополнительные интерфейсы для команд по умолчанию и глубокие ссылки, а также форматирование текста, интегрированные платежи и многое другое.
Встроенный режим
Пользователи могут взаимодействовать с вашим ботом с помощью встроенных запросов прямо из поля ввода текста в любом чате. Все, что им нужно сделать, это начать сообщение с именем пользователя вашего бота, а затем ввести запрос.
Получив запрос, ваш бот может вернуть некоторые результаты. Как только пользователь нажимает на одного из них, он отправляется в открытый в данный момент чат пользователя. Таким образом, люди могут запрашивать контент у вашего бота в любом из своих чатов, групп или каналов.
Ознакомьтесь с этим блогом, чтобы увидеть пример встроенного бота в действии. Вы также можете попробовать @sticker и @music bots, чтобы убедиться в этом сами.
Новое поле ввода
Мы также внедрили простой способ для вашего бота переключаться между режимами inline и PM.
Узнайте больше о встроенном режиме »
Платежная платформа
Вы можете использовать ботов для приема платежей от пользователей Telegram по всему миру.
Отправляйте счета в любой чат, в том числе в группы и каналы.
Создавайте счета, которые могут пересылаться и использоваться несколькими покупателями для заказа товаров.
Используйте встроенный режим, чтобы помочь пользователям показывать ваши товары и услуги своим друзьям и сообществам.
Разрешайте чаевые от пользователей с предустановленными и настраиваемыми суммами.
Принимайте платежи от пользователей в мобильных или настольных приложениях.
Попробуйте @ShopBot создать тестовый счет–фактуру или отправьте сообщение @ShopBot ...в любой чат для получения встроенного счета-фактуры.
Посмотрите Demo Shop на примере канала Telegram, используемого в качестве виртуальной витрины.
Узнайте больше о платежной платформе »
Игровая платформа
Боты могут предлагать своим пользователям игры на HTML5 для игры в одиночку или для соревнования друг с другом в группах и в чатах один на один. Платформа позволяет вашему боту отслеживать высокие баллы за каждую игру, сыгранную в каждом чате. Всякий раз, когда в игре появляется новый лидер, другие участники игры в чате получают уведомление о том, что им нужно усилить его.
Игра в чате Внутриигровое табло и кнопка обмена
Поскольку в основе лежит технология HTML5, игры могут быть любыми - от простых аркад и головоломок до многопользовательских 3D-шутеров и стратегий в реальном времени. Наша команда создала пару простых демонстраций, чтобы вы могли попробовать:
Математическая битва
Дровосек
Корсары
Вы также можете проверить бота @gamee, в котором более 20 игр.
Узнайте больше об игровой платформе »
Клавиатуры
Конечно, традиционных чат-ботов можно научить понимать человеческий язык. Но иногда требуется более формальный ввод от пользователя — и именно здесь пользовательские клавиатуры могут стать чрезвычайно полезными.
Всякий раз, когда ваш бот отправляет сообщение, он может передавать его с помощью специальной клавиатуры с предопределенными вариантами ответа (см. ReplyKeyboardMarkup). Приложения Telegram, которые получают сообщение, будут отображать вашу клавиатуру для пользователя. Нажатие любой из кнопок немедленно отправит соответствующую команду. Таким образом, вы можете значительно упростить взаимодействие пользователя с вашим ботом.
В настоящее время мы поддерживаем текст и смайлики для ваших кнопок. Вот несколько примеров пользовательских клавиатур:
Клавиатура для бота для опроса Клавиатура для бота-калькулятора. Потому что вы можете. Клавиатура для простого бота
Для получения дополнительной технической информации о пользовательских клавиатурах, пожалуйста, обратитесь к руководству Bot API (см. SendMessage ).
Встроенные клавиатуры и обновление "на лету"
Бывают случаи, когда вы предпочитаете делать что-то, не отправляя никаких сообщений в чат. Например, когда ваш пользователь меняет настройки или просматривает результаты поиска. В таких случаях вы можете использовать встроенные клавиатуры, которые интегрированы непосредственно в сообщения, которым они принадлежат.
В отличие от пользовательских клавиатур для ответов, нажатие кнопок на встроенных клавиатурах не приводит к отправке сообщений в чат. Вместо этого встроенные клавиатуры поддерживают кнопки, которые работают за кулисами: кнопки обратного вызова, кнопки URL и переключаются на встроенные кнопки.
Кнопки обратного вызова в @music Больше кнопок обратного вызова в @music Кнопка URL
Когда используются кнопки обратного вызова, ваш бот может обновлять свои существующие сообщения (или просто их клавиатуру), чтобы чат оставался аккуратным. Ознакомьтесь с этими примерами ботов, чтобы увидеть встроенные клавиатуры в действии: @music, @vote, @like.
Узнайте больше о встроенных клавиатурах и редактировании на лету »
Команды
Команды представляют собой более гибкий способ общения с вашим ботом. Может использоваться следующий синтаксис:
/command
Команда всегда должна начинаться с символа '/' и не может быть длиннее 32 символов. Команды могут использовать латинские буквы, цифры и символы подчеркивания. Вот несколько примеров:
/get_messages_stats
/set_timer 10min Alarm!
/get_timezone London, UK
Сообщения, начинающиеся с косой черты, всегда передаются боту (вместе с ответами на его сообщения и сообщениями, в которых @упоминается бот по имени пользователя). Приложения Telegram будут:
Предложите список поддерживаемых команд с описанием, когда пользователь вводит "/" (для этого вам нужно предоставить список команд BotFather). Нажатие на команду в списке немедленно отправляет команду.
Показывать дополнительную кнопку (/) в поле ввода во всех чатах с ботами. При нажатии на него вводится '/' и отображается список команд.
Выделите / команды в сообщениях. Когда пользователь нажимает выделенную команду, команда отправляется сразу.
Предлагаемые команды Обратите внимание на новую кнопку в поле ввода, рядом с кнопкой стикера Предлагаемые команды для нескольких ботов
Если в группе несколько ботов, можно добавить имена пользователей ботов в команды, чтобы избежать путаницы:
/start@TriviaBot
/start@ApocalypseBot
Это делается автоматически, когда команды выбираются из списка предложений. Пожалуйста, помните, что ваш бот должен уметь обрабатывать команды, за которыми следует его имя пользователя.
Глобальные команды
Чтобы пользователям было проще ориентироваться в мультивселенной ботов, мы просим всех разработчиков поддерживать несколько основных команд. Приложения Telegram будут иметь ярлыки интерфейса для этих команд.
/start - запускает взаимодействие с пользователем, например, путем отправки приветственного сообщения. Эта команда также может использоваться для передачи дополнительных параметров боту (см. Глубокое связывание)
/help - возвращает справочное сообщение. Это может быть короткий текст о том, что может делать ваш бот, и список команд.
/settings - (если применимо) возвращает настройки бота для этого пользователя и предлагает команды для редактирования этих настроек.
Пользователи увидят кнопку "Пуск" при первом открытии диалога с вашим ботом. Ссылки на справку и настройки будут доступны в меню на странице профиля бота.
Пустой разговор с ботом Страница профиля бота с кнопками "Справка" и "Настройки"
Форматирование: жирный шрифт, курсив, текст фиксированной ширины и встроенные ссылки
Вы можете использовать жирный, курсивный или текст фиксированной ширины, а также встроенные ссылки в сообщениях ваших ботов. Клиенты Telegram будут отображать их соответствующим образом.
Подробнее читайте в руководстве по API ботов »
Режим конфиденциальности
Боты часто добавляются в группы, чтобы улучшить общение между пользователями-людьми, например, путем предоставления новостей, уведомлений от внешних служб или дополнительных функций поиска. Это особенно верно для рабочих групп. Теперь, когда вы делитесь группой с ботом, вы, как правило, спрашиваете себя: “Как я могу быть уверен, что маленький негодяй не продает историю моего чата моим конкурентам?” Ответ — режим конфиденциальности.
Бот, работающий в режиме конфиденциальности, не будет получать все сообщения, которые люди отправляют в группу. Вместо этого он получит только:
Сообщения, начинающиеся с косой черты '/' (см. Команды выше)
Ответы на собственные сообщения бота
Служебные сообщения (люди, добавленные или удаленные из группы и т. Д.)
Сообщения от каналов, участником которых он является
С одной стороны, это помогает некоторым из нас лучше спать по ночам (в наших ночных колпаках из фольги), с другой — это позволяет разработчику ботов экономить много ресурсов, поскольку им не нужно обрабатывать десятки тысяч нерелевантных сообщений каждый день.
Режим конфиденциальности включен по умолчанию для всех ботов, кроме ботов, которые были добавлены в группу в качестве администраторов (администраторы ботов всегда получают все сообщения). Его можно отключить, чтобы бот получал все сообщения, как обычный пользователь (бота нужно будет повторно добавить в группу, чтобы это изменение вступило в силу). Мы рекомендуем делать это только в тех случаях, когда это абсолютно необходимо для работы вашего бота — пользователи всегда могут увидеть текущие настройки конфиденциальности бота в списке участников группы. В большинстве случаев использования опции принудительного ответа на сообщения бота должно быть более чем достаточно.
Итак, какие именно сообщения получит мой бот? »
Глубокая привязка
Боты Telegram имеют механизм глубокой привязки, который позволяет передавать дополнительные параметры боту при запуске. Это может быть команда, которая запускает бота, или токен аутентификации для подключения учетной записи пользователя Telegram к его учетной записи в какой—либо внешней службе.
У каждого бота есть ссылка, которая открывает диалог с ним в Telegram — https://t.me/<bot username>. Вы можете добавить в эту ссылку параметры start или startgroup со значениями длиной до 64 символов. Например:
https://t.me/triviabot?startgroup=test
A-Z, a-z, 0-9, _и -разрешены. Мы рекомендуем использовать base64url для кодирования параметров с двоичным и другими типами содержимого.
Переход по ссылке с параметром start откроет диалог один на один с ботом, показывая кнопку START вместо поля ввода. Если используется параметр startgroup, пользователю предлагается выбрать группу для добавления бота. Как только пользователь подтвердит действие (нажмет кнопку "ПУСК" в своем приложении или выберет группу для добавления бота), ваш бот получит сообщение от этого пользователя в этом формате:
/start PAYLOAD
PAYLOAD обозначает значение параметра start или startgroup, который был передан в ссылке.
Пример глубокой компоновки
Предположим, веб-сайт example.com хотел бы отправлять уведомления своим пользователям через Telegram-бота. Вот что они могли бы сделать, чтобы включить уведомления для пользователя с идентификатором123.
Создайте бота с подходящим именем пользователя, например @ExampleComBot
Настройте веб-хук для входящих сообщений
Создайте случайную строку достаточной длины, например $memcache_key = "vCH1vGWJxfSeofSAs0K5PA"
Поместите значение 123с ключом $memcache_keyв Memcache на 3600 секунд (один час)
Покажите нашему пользователю кнопку https://t.me/ExampleComBot?start=vCH1vGWJxfSeofSAs0K5PA
Настройте процессор webhook для запроса Memcached с параметром, который передается во входящих сообщениях, начиная с /start. Если ключ существует, запишите идентификатор chat_id, переданный в webhook, как telegram_chat_id для пользователя 123. Удалите ключ из Memcache.
Теперь, когда мы хотим отправить уведомление пользователю123, проверьте, есть ли у него поле telegram_chat_id . Если да, используйте метод SendMessage в API ботов, чтобы отправить им сообщение в Telegram.
Местоположение и количество
Некоторые боты нуждаются в дополнительных данных от пользователя для правильной работы. Например, знание местоположения пользователя помогает получить более релевантные гео-специфические результаты. Номер телефона пользователя может быть очень полезен для интеграции с другими сервисами, такими как банки и т. Д.
Боты могут запрашивать у пользователя его местоположение и номер телефона с помощью специальных кнопок. Обратите внимание, что кнопки запроса номера телефона и местоположения будут работать только в приватных чатах.
Кнопки обмена номерами телефонов и местоположением
При нажатии этих кнопок клиенты Telegram будут отображать оповещение о подтверждении, которое сообщает пользователю, что должно произойти.
Руководство: количество и расположение кнопок »
6. Отец ботов
Переходите к началу, чтобы узнать все о ботах Telegram »
BotFather - это единственный бот, который управляет ими всеми. Это поможет вам создавать новых ботов и изменять настройки для существующих.
Создание нового бота
Используйте команду /newbot для создания нового бота. BotFather запросит у вас имя и имя пользователя, а затем сгенерирует токен аутентификации для вашего нового бота.
Имя вашего бота отображается в контактных данных и в других местах.
Имя пользователя - это короткое имя, которое используется в упоминаниях и t.me ссылки. Имена пользователей имеют длину 5-32 символа и не зависят от регистра, но могут содержать только латинские символы, цифры и символы подчеркивания. Имя пользователя вашего бота должно заканчиваться на 'bot', например 'tetris_bot' или 'TetrisBot'.
Токен - это строка110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw, подобная той, которая требуется для авторизации бота и отправки запросов в API бота. Сохраняйте свой токен в безопасности и храните его безопасно, он может быть использован кем угодно для управления вашим ботом.
Генерация токена аутентификации
Если ваш существующий токен скомпрометирован или вы потеряли его по какой-либо причине, используйте команду /token для создания нового.
Команды Botfather
Остальные команды не требуют пояснений:
/mybots — возвращает список ваших ботов с удобными элементами управления для редактирования их настроек
/ mygames — делает то же самое для ваших игр
Редактировать ботов
/setname – измените имя вашего бота.
/setdescription — измените описание бота, короткий текст длиной до 512 символов, описывающий вашего бота. Пользователи увидят этот текст в начале разговора с ботом под названием "Что может сделать этот бот?".
/setabouttext — измените информацию о боте, еще более короткий текст до 120 символов. Пользователи увидят этот текст на странице профиля бота. Когда они делятся с кем-то вашим ботом, этот текст отправляется вместе со ссылкой.
/setuserpic — измените изображения профиля бота. Всегда приятно приложить лицо к имени.
/setcommands — измените список команд, поддерживаемых вашим ботом. Пользователи будут видеть эти команды как предложения, когда они будут вводить /в чате с вашим ботом. У каждой команды есть имя (должно начинаться с косой черты ‘/’, буквенно-цифровое плюс подчеркивание, не более 32 символов, без учета регистра), параметры и текстовое описание. Пользователи будут видеть список команд всякий раз, когда они вводят "/" в разговоре с вашим ботом.
/deletebot — удалите своего бота и освободите его имя пользователя.
Редактировать настройки
/setinline — переключение встроенного режима для вашего бота.
/setinlinegeo - запрашивать данные о местоположении для предоставления встроенных результатов на основе местоположения.
/setjoingroups — укажите, можно ли добавлять вашего бота в группы или нет. Любой бот должен уметь обрабатывать личные сообщения, но если ваш бот не был предназначен для работы в группах, вы можете отключить это.
/setprivacy — укажите, какие сообщения будет получать ваш бот при добавлении в группу. Если режим конфиденциальности отключен, бот будет получать все сообщения. Мы рекомендуем оставить режим конфиденциальности включенным. Вам нужно будет повторно добавить бота в существующие группы, чтобы это изменение вступило в силу.
Управление играми
/newgame — создайте новую игру.
/ listgames — получите список ваших игр.
/editgame — редактировать игру.
/deletegame — удалить существующую игру.
Пожалуйста, обратите внимание, что для вступления изменений в силу может потребоваться несколько минут.
Оповещения о состоянии
Миллионы выбирают Telegram за его скорость. Чтобы оставаться конкурентоспособным в этой среде, ваш бот также должен быть отзывчивым. Чтобы помочь разработчикам поддерживать своих ботов в форме, Botfather будет отправлять оповещения о состоянии, если увидит, что что-то не так.
Мы будем проверять количество ответов и коэффициент конверсии запросов / ответов для популярных ботов (~ 300 запросов в минуту: но не записывайте это, так как значение может измениться в будущем). Если мы получим аномально низкие значения, вы получите уведомление от Botfather.
Реагирование на предупреждения
По умолчанию вы будете получать только одно оповещение на каждого бота в час. Каждое оповещение имеет следующие кнопки:
Исправлено. Используйте это, если вы обнаружили проблему с вашим ботом и исправили ее. Если вы нажмете кнопку исправления, мы возобновим отправку оповещений обычным способом, чтобы вы могли узнать, сработало ли ваше исправление в течение 5-10 минут, вместо того, чтобы ждать час.
Поддержка. Используйте это, чтобы открыть чат с @BotSupport, если вы не видите никаких проблем с вашим ботом или считаете, что проблема на нашей стороне.
Отключение звука на 8 часов / 1 Вт. Используйте это, если вы не можете исправить своего бота в данный момент. Это отключит все оповещения для данного бота на указанный период времени. Мы не рекомендуем использовать эту опцию, так как ваши пользователи могут перейти на более стабильного бота. Вы можете включить оповещения в настройках вашего бота через Botfather.
Отслеживаемые проблемы
В настоящее время мы будем уведомлять вас о следующих проблемах:
1.
Too few **private messages** are sent compared to previous weeks: **{value}**
Ваш бот отправляет гораздо меньше сообщений, чем в предыдущие недели. Это полезно для ботов в стиле рассылки новостей, которые рассылают сообщения без запросов от пользователей. Чем больше значение, тем существеннее разница.
2.
Too few replies to incoming **private messages**. Conversion rate: **{value}**
Ваш бот не отвечает на все отправляемые ему сообщения (коэффициент конверсии запросов / ответов для вашего бота был слишком низким по крайней мере в течение двух из последних трех 5-минутных периодов). Чтобы обеспечить хороший пользовательский интерфейс, пожалуйста, отвечайте на все сообщения, которые отправляются вашему боту. Отвечайте на обновления сообщений , вызывая методы отправки ... (например, SendMessage).
3.
Too few answers to **inline queries**. Conversion rate: **{value}**
Ваш бот не отвечает на все встроенные запросы, которые ему отправляются, рассчитанные так же, как и выше. Отвечайте на обновления inline_query, вызывая answerInlineQuery .
4.
Too few answers to **callback queries**. Conversion rate: **{value}**
Too few answers to **callback game queries**. Conversion rate: **{value}**
Ваш бот не отвечает на все отправляемые ему запросы обратного вызова (с играми или без игр), рассчитанные таким же образом, как указано выше. Отвечайте на обновления callback_query, вызывая answerCallbackQuery .
Обратите внимание, что функция оповещения о состоянии все еще тестируется и будет улучшена в будущем.
Вот и все для введения. Теперь вы определенно готовы перейти к РУКОВОДСТВУ по API БОТОВ.
<a href=https://t.me/investors_channel>квалифицированный инвестор</a> рассказывает Канал Инвестор, также затрагиваем темы - ищу инвестора, лучшие инвесторы, доход инвестора, стану инвестором и многие другие.
Полный справочник по API для разработчиков доступен здесь.
Telegram продолжает развиваться и добавлять новые функции, поэтому этот документ может содержать устаревшую информацию.
Мы ожидаем завершить обновление FAQ, руководств по ботам и других документов к концу лета 2022 года.
1. Что я могу сделать с ботами?
Чат с ботом, также показывающий результаты поиска от встроенного бота @gif
Чтобы назвать лишь несколько вещей, вы могли бы использовать ботов для:
Получайте настраиваемые уведомления и новости. Бот может действовать как умная газета, отправляя вам релевантный контент сразу после его публикации.
Интеграция с другими сервисами. Бот может обогащать чаты Telegram контентом из внешних сервисов.
Бот Gmail, GIF-бот, бот IMDB, Вики-бот, Музыкальный бот, бот Youtube, GitHubBot
Принимайте платежи от пользователей Telegram. Бот может предлагать платные услуги или работать как виртуальная витрина. Подробнее »
Бот демонстрационного магазина, демонстрационный магазин
Создавайте собственные инструменты. Бот может предоставлять вам оповещения, прогнозы погоды, переводы, форматирование или другие услуги.
Бот для уценки, бот для стикеров, бот для голосования, Лайк-бот
Создавайте одиночные и многопользовательские игры. Бот может предложить богатый интерфейс HTML5, от простых аркад и головоломок до 3D-шутеров и стратегий в реальном времени.
GameBot, Gamee
Создавайте социальные сервисы. Бот может объединять людей, которые ищут собеседников, на основе общих интересов или близости.
Делайте практически все остальное. За исключением посуды — боты ужасно моют посуду.
2. Как работают боты?
По сути, боты Telegram - это специальные учетные записи, для настройки которых не требуется дополнительный номер телефона. Пользователи могут взаимодействовать с ботами двумя способами:
Отправляйте сообщения и команды ботам, открывая чат с ними или добавляя их в группы.
Отправляйте запросы непосредственно из поля ввода, введя @username бота и запрос. Это позволяет отправлять контент из встроенных ботов непосредственно в любой чат, группу или канал.
Сообщения, команды и запросы, отправляемые пользователями, передаются программному обеспечению, работающему на ваших серверах. Наш промежуточный сервер обрабатывает все шифрование и обмен данными с API Telegram за вас. Вы общаетесь с этим сервером через простой HTTPS-интерфейс, который предлагает упрощенную версию API Telegram. Мы называем этот интерфейс нашим API ботов.
Подробное описание API ботов доступно на этой странице »
3. Как мне создать бота?
Отец ботов. Нажмите, чтобы получить изображение в высоком разрешении
Для этого есть ... бот. Просто поговорите с BotFather (описано ниже) и выполните несколько простых шагов. После того, как вы создали бота и получили свой токен аутентификации, перейдите к руководству по API ботов, чтобы узнать, чему вы можете научить своего бота.
Вы также можете ознакомиться с некоторыми примерами кода здесь »
4. Чем боты отличаются от людей?
Боты не имеют статуса онлайн и не имеют отметок времени последнего просмотра, вместо этого в интерфейсе отображается метка "бот".
У ботов ограниченное облачное хранилище — старые сообщения могут быть удалены сервером вскоре после их обработки.
Боты не могут инициировать диалоги с пользователями. Пользователь должен либо добавить их в группу, либо сначала отправить им сообщение. Люди могут использовать t.me/<bot_username>ссылки или поиск по имени пользователя, чтобы найти вашего бота.
Имена пользователей ботов всегда заканчиваются на "бот" (например, @TriviaBot, @GitHub_bot).
При добавлении в группу боты не получают все сообщения по умолчанию (см. Режим конфиденциальности).
Боты никогда не едят, не спят и не жалуются (если специально не запрограммировано иное).
5. Привилегии ботов
Боты Telegram уникальны во многих отношениях — мы предлагаем два вида клавиатур, дополнительные интерфейсы для команд по умолчанию и глубокие ссылки, а также форматирование текста, интегрированные платежи и многое другое.
Встроенный режим
Пользователи могут взаимодействовать с вашим ботом с помощью встроенных запросов прямо из поля ввода текста в любом чате. Все, что им нужно сделать, это начать сообщение с именем пользователя вашего бота, а затем ввести запрос.
Получив запрос, ваш бот может вернуть некоторые результаты. Как только пользователь нажимает на одного из них, он отправляется в открытый в данный момент чат пользователя. Таким образом, люди могут запрашивать контент у вашего бота в любом из своих чатов, групп или каналов.
Ознакомьтесь с этим блогом, чтобы увидеть пример встроенного бота в действии. Вы также можете попробовать @sticker и @music bots, чтобы убедиться в этом сами.
Новое поле ввода
Мы также внедрили простой способ для вашего бота переключаться между режимами inline и PM.
Узнайте больше о встроенном режиме »
Платежная платформа
Вы можете использовать ботов для приема платежей от пользователей Telegram по всему миру.
Отправляйте счета в любой чат, в том числе в группы и каналы.
Создавайте счета, которые могут пересылаться и использоваться несколькими покупателями для заказа товаров.
Используйте встроенный режим, чтобы помочь пользователям показывать ваши товары и услуги своим друзьям и сообществам.
Разрешайте чаевые от пользователей с предустановленными и настраиваемыми суммами.
Принимайте платежи от пользователей в мобильных или настольных приложениях.
Попробуйте @ShopBot создать тестовый счет–фактуру или отправьте сообщение @ShopBot ...в любой чат для получения встроенного счета-фактуры.
Посмотрите Demo Shop на примере канала Telegram, используемого в качестве виртуальной витрины.
Узнайте больше о платежной платформе »
Игровая платформа
Боты могут предлагать своим пользователям игры на HTML5 для игры в одиночку или для соревнования друг с другом в группах и в чатах один на один. Платформа позволяет вашему боту отслеживать высокие баллы за каждую игру, сыгранную в каждом чате. Всякий раз, когда в игре появляется новый лидер, другие участники игры в чате получают уведомление о том, что им нужно усилить его.
Игра в чате Внутриигровое табло и кнопка обмена
Поскольку в основе лежит технология HTML5, игры могут быть любыми - от простых аркад и головоломок до многопользовательских 3D-шутеров и стратегий в реальном времени. Наша команда создала пару простых демонстраций, чтобы вы могли попробовать:
Математическая битва
Дровосек
Корсары
Вы также можете проверить бота @gamee, в котором более 20 игр.
Узнайте больше об игровой платформе »
Клавиатуры
Конечно, традиционных чат-ботов можно научить понимать человеческий язык. Но иногда требуется более формальный ввод от пользователя — и именно здесь пользовательские клавиатуры могут стать чрезвычайно полезными.
Всякий раз, когда ваш бот отправляет сообщение, он может передавать его с помощью специальной клавиатуры с предопределенными вариантами ответа (см. ReplyKeyboardMarkup). Приложения Telegram, которые получают сообщение, будут отображать вашу клавиатуру для пользователя. Нажатие любой из кнопок немедленно отправит соответствующую команду. Таким образом, вы можете значительно упростить взаимодействие пользователя с вашим ботом.
В настоящее время мы поддерживаем текст и смайлики для ваших кнопок. Вот несколько примеров пользовательских клавиатур:
Клавиатура для бота для опроса Клавиатура для бота-калькулятора. Потому что вы можете. Клавиатура для простого бота
Для получения дополнительной технической информации о пользовательских клавиатурах, пожалуйста, обратитесь к руководству Bot API (см. SendMessage ).
Встроенные клавиатуры и обновление "на лету"
Бывают случаи, когда вы предпочитаете делать что-то, не отправляя никаких сообщений в чат. Например, когда ваш пользователь меняет настройки или просматривает результаты поиска. В таких случаях вы можете использовать встроенные клавиатуры, которые интегрированы непосредственно в сообщения, которым они принадлежат.
В отличие от пользовательских клавиатур для ответов, нажатие кнопок на встроенных клавиатурах не приводит к отправке сообщений в чат. Вместо этого встроенные клавиатуры поддерживают кнопки, которые работают за кулисами: кнопки обратного вызова, кнопки URL и переключаются на встроенные кнопки.
Кнопки обратного вызова в @music Больше кнопок обратного вызова в @music Кнопка URL
Когда используются кнопки обратного вызова, ваш бот может обновлять свои существующие сообщения (или просто их клавиатуру), чтобы чат оставался аккуратным. Ознакомьтесь с этими примерами ботов, чтобы увидеть встроенные клавиатуры в действии: @music, @vote, @like.
Узнайте больше о встроенных клавиатурах и редактировании на лету »
Команды
Команды представляют собой более гибкий способ общения с вашим ботом. Может использоваться следующий синтаксис:
/command
Команда всегда должна начинаться с символа '/' и не может быть длиннее 32 символов. Команды могут использовать латинские буквы, цифры и символы подчеркивания. Вот несколько примеров:
/get_messages_stats
/set_timer 10min Alarm!
/get_timezone London, UK
Сообщения, начинающиеся с косой черты, всегда передаются боту (вместе с ответами на его сообщения и сообщениями, в которых @упоминается бот по имени пользователя). Приложения Telegram будут:
Предложите список поддерживаемых команд с описанием, когда пользователь вводит "/" (для этого вам нужно предоставить список команд BotFather). Нажатие на команду в списке немедленно отправляет команду.
Показывать дополнительную кнопку (/) в поле ввода во всех чатах с ботами. При нажатии на него вводится '/' и отображается список команд.
Выделите / команды в сообщениях. Когда пользователь нажимает выделенную команду, команда отправляется сразу.
Предлагаемые команды Обратите внимание на новую кнопку в поле ввода, рядом с кнопкой стикера Предлагаемые команды для нескольких ботов
Если в группе несколько ботов, можно добавить имена пользователей ботов в команды, чтобы избежать путаницы:
/start@TriviaBot
/start@ApocalypseBot
Это делается автоматически, когда команды выбираются из списка предложений. Пожалуйста, помните, что ваш бот должен уметь обрабатывать команды, за которыми следует его имя пользователя.
Глобальные команды
Чтобы пользователям было проще ориентироваться в мультивселенной ботов, мы просим всех разработчиков поддерживать несколько основных команд. Приложения Telegram будут иметь ярлыки интерфейса для этих команд.
/start - запускает взаимодействие с пользователем, например, путем отправки приветственного сообщения. Эта команда также может использоваться для передачи дополнительных параметров боту (см. Глубокое связывание)
/help - возвращает справочное сообщение. Это может быть короткий текст о том, что может делать ваш бот, и список команд.
/settings - (если применимо) возвращает настройки бота для этого пользователя и предлагает команды для редактирования этих настроек.
Пользователи увидят кнопку "Пуск" при первом открытии диалога с вашим ботом. Ссылки на справку и настройки будут доступны в меню на странице профиля бота.
Пустой разговор с ботом Страница профиля бота с кнопками "Справка" и "Настройки"
Форматирование: жирный шрифт, курсив, текст фиксированной ширины и встроенные ссылки
Вы можете использовать жирный, курсивный или текст фиксированной ширины, а также встроенные ссылки в сообщениях ваших ботов. Клиенты Telegram будут отображать их соответствующим образом.
Подробнее читайте в руководстве по API ботов »
Режим конфиденциальности
Боты часто добавляются в группы, чтобы улучшить общение между пользователями-людьми, например, путем предоставления новостей, уведомлений от внешних служб или дополнительных функций поиска. Это особенно верно для рабочих групп. Теперь, когда вы делитесь группой с ботом, вы, как правило, спрашиваете себя: “Как я могу быть уверен, что маленький негодяй не продает историю моего чата моим конкурентам?” Ответ — режим конфиденциальности.
Бот, работающий в режиме конфиденциальности, не будет получать все сообщения, которые люди отправляют в группу. Вместо этого он получит только:
Сообщения, начинающиеся с косой черты '/' (см. Команды выше)
Ответы на собственные сообщения бота
Служебные сообщения (люди, добавленные или удаленные из группы и т. Д.)
Сообщения от каналов, участником которых он является
С одной стороны, это помогает некоторым из нас лучше спать по ночам (в наших ночных колпаках из фольги), с другой — это позволяет разработчику ботов экономить много ресурсов, поскольку им не нужно обрабатывать десятки тысяч нерелевантных сообщений каждый день.
Режим конфиденциальности включен по умолчанию для всех ботов, кроме ботов, которые были добавлены в группу в качестве администраторов (администраторы ботов всегда получают все сообщения). Его можно отключить, чтобы бот получал все сообщения, как обычный пользователь (бота нужно будет повторно добавить в группу, чтобы это изменение вступило в силу). Мы рекомендуем делать это только в тех случаях, когда это абсолютно необходимо для работы вашего бота — пользователи всегда могут увидеть текущие настройки конфиденциальности бота в списке участников группы. В большинстве случаев использования опции принудительного ответа на сообщения бота должно быть более чем достаточно.
Итак, какие именно сообщения получит мой бот? »
Глубокая привязка
Боты Telegram имеют механизм глубокой привязки, который позволяет передавать дополнительные параметры боту при запуске. Это может быть команда, которая запускает бота, или токен аутентификации для подключения учетной записи пользователя Telegram к его учетной записи в какой—либо внешней службе.
У каждого бота есть ссылка, которая открывает диалог с ним в Telegram — https://t.me/<bot username>. Вы можете добавить в эту ссылку параметры start или startgroup со значениями длиной до 64 символов. Например:
https://t.me/triviabot?startgroup=test
A-Z, a-z, 0-9, _и -разрешены. Мы рекомендуем использовать base64url для кодирования параметров с двоичным и другими типами содержимого.
Переход по ссылке с параметром start откроет диалог один на один с ботом, показывая кнопку START вместо поля ввода. Если используется параметр startgroup, пользователю предлагается выбрать группу для добавления бота. Как только пользователь подтвердит действие (нажмет кнопку "ПУСК" в своем приложении или выберет группу для добавления бота), ваш бот получит сообщение от этого пользователя в этом формате:
/start PAYLOAD
PAYLOAD обозначает значение параметра start или startgroup, который был передан в ссылке.
Пример глубокой компоновки
Предположим, веб-сайт example.com хотел бы отправлять уведомления своим пользователям через Telegram-бота. Вот что они могли бы сделать, чтобы включить уведомления для пользователя с идентификатором123.
Создайте бота с подходящим именем пользователя, например @ExampleComBot
Настройте веб-хук для входящих сообщений
Создайте случайную строку достаточной длины, например $memcache_key = "vCH1vGWJxfSeofSAs0K5PA"
Поместите значение 123с ключом $memcache_keyв Memcache на 3600 секунд (один час)
Покажите нашему пользователю кнопку https://t.me/ExampleComBot?start=vCH1vGWJxfSeofSAs0K5PA
Настройте процессор webhook для запроса Memcached с параметром, который передается во входящих сообщениях, начиная с /start. Если ключ существует, запишите идентификатор chat_id, переданный в webhook, как telegram_chat_id для пользователя 123. Удалите ключ из Memcache.
Теперь, когда мы хотим отправить уведомление пользователю123, проверьте, есть ли у него поле telegram_chat_id . Если да, используйте метод SendMessage в API ботов, чтобы отправить им сообщение в Telegram.
Местоположение и количество
Некоторые боты нуждаются в дополнительных данных от пользователя для правильной работы. Например, знание местоположения пользователя помогает получить более релевантные гео-специфические результаты. Номер телефона пользователя может быть очень полезен для интеграции с другими сервисами, такими как банки и т. Д.
Боты могут запрашивать у пользователя его местоположение и номер телефона с помощью специальных кнопок. Обратите внимание, что кнопки запроса номера телефона и местоположения будут работать только в приватных чатах.
Кнопки обмена номерами телефонов и местоположением
При нажатии этих кнопок клиенты Telegram будут отображать оповещение о подтверждении, которое сообщает пользователю, что должно произойти.
Руководство: количество и расположение кнопок »
6. Отец ботов
Переходите к началу, чтобы узнать все о ботах Telegram »
BotFather - это единственный бот, который управляет ими всеми. Это поможет вам создавать новых ботов и изменять настройки для существующих.
Создание нового бота
Используйте команду /newbot для создания нового бота. BotFather запросит у вас имя и имя пользователя, а затем сгенерирует токен аутентификации для вашего нового бота.
Имя вашего бота отображается в контактных данных и в других местах.
Имя пользователя - это короткое имя, которое используется в упоминаниях и t.me ссылки. Имена пользователей имеют длину 5-32 символа и не зависят от регистра, но могут содержать только латинские символы, цифры и символы подчеркивания. Имя пользователя вашего бота должно заканчиваться на 'bot', например 'tetris_bot' или 'TetrisBot'.
Токен - это строка110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw, подобная той, которая требуется для авторизации бота и отправки запросов в API бота. Сохраняйте свой токен в безопасности и храните его безопасно, он может быть использован кем угодно для управления вашим ботом.
Генерация токена аутентификации
Если ваш существующий токен скомпрометирован или вы потеряли его по какой-либо причине, используйте команду /token для создания нового.
Команды Botfather
Остальные команды не требуют пояснений:
/mybots — возвращает список ваших ботов с удобными элементами управления для редактирования их настроек
/ mygames — делает то же самое для ваших игр
Редактировать ботов
/setname – измените имя вашего бота.
/setdescription — измените описание бота, короткий текст длиной до 512 символов, описывающий вашего бота. Пользователи увидят этот текст в начале разговора с ботом под названием "Что может сделать этот бот?".
/setabouttext — измените информацию о боте, еще более короткий текст до 120 символов. Пользователи увидят этот текст на странице профиля бота. Когда они делятся с кем-то вашим ботом, этот текст отправляется вместе со ссылкой.
/setuserpic — измените изображения профиля бота. Всегда приятно приложить лицо к имени.
/setcommands — измените список команд, поддерживаемых вашим ботом. Пользователи будут видеть эти команды как предложения, когда они будут вводить /в чате с вашим ботом. У каждой команды есть имя (должно начинаться с косой черты ‘/’, буквенно-цифровое плюс подчеркивание, не более 32 символов, без учета регистра), параметры и текстовое описание. Пользователи будут видеть список команд всякий раз, когда они вводят "/" в разговоре с вашим ботом.
/deletebot — удалите своего бота и освободите его имя пользователя.
Редактировать настройки
/setinline — переключение встроенного режима для вашего бота.
/setinlinegeo - запрашивать данные о местоположении для предоставления встроенных результатов на основе местоположения.
/setjoingroups — укажите, можно ли добавлять вашего бота в группы или нет. Любой бот должен уметь обрабатывать личные сообщения, но если ваш бот не был предназначен для работы в группах, вы можете отключить это.
/setprivacy — укажите, какие сообщения будет получать ваш бот при добавлении в группу. Если режим конфиденциальности отключен, бот будет получать все сообщения. Мы рекомендуем оставить режим конфиденциальности включенным. Вам нужно будет повторно добавить бота в существующие группы, чтобы это изменение вступило в силу.
Управление играми
/newgame — создайте новую игру.
/ listgames — получите список ваших игр.
/editgame — редактировать игру.
/deletegame — удалить существующую игру.
Пожалуйста, обратите внимание, что для вступления изменений в силу может потребоваться несколько минут.
Оповещения о состоянии
Миллионы выбирают Telegram за его скорость. Чтобы оставаться конкурентоспособным в этой среде, ваш бот также должен быть отзывчивым. Чтобы помочь разработчикам поддерживать своих ботов в форме, Botfather будет отправлять оповещения о состоянии, если увидит, что что-то не так.
Мы будем проверять количество ответов и коэффициент конверсии запросов / ответов для популярных ботов (~ 300 запросов в минуту: но не записывайте это, так как значение может измениться в будущем). Если мы получим аномально низкие значения, вы получите уведомление от Botfather.
Реагирование на предупреждения
По умолчанию вы будете получать только одно оповещение на каждого бота в час. Каждое оповещение имеет следующие кнопки:
Исправлено. Используйте это, если вы обнаружили проблему с вашим ботом и исправили ее. Если вы нажмете кнопку исправления, мы возобновим отправку оповещений обычным способом, чтобы вы могли узнать, сработало ли ваше исправление в течение 5-10 минут, вместо того, чтобы ждать час.
Поддержка. Используйте это, чтобы открыть чат с @BotSupport, если вы не видите никаких проблем с вашим ботом или считаете, что проблема на нашей стороне.
Отключение звука на 8 часов / 1 Вт. Используйте это, если вы не можете исправить своего бота в данный момент. Это отключит все оповещения для данного бота на указанный период времени. Мы не рекомендуем использовать эту опцию, так как ваши пользователи могут перейти на более стабильного бота. Вы можете включить оповещения в настройках вашего бота через Botfather.
Отслеживаемые проблемы
В настоящее время мы будем уведомлять вас о следующих проблемах:
1.
Too few **private messages** are sent compared to previous weeks: **{value}**
Ваш бот отправляет гораздо меньше сообщений, чем в предыдущие недели. Это полезно для ботов в стиле рассылки новостей, которые рассылают сообщения без запросов от пользователей. Чем больше значение, тем существеннее разница.
2.
Too few replies to incoming **private messages**. Conversion rate: **{value}**
Ваш бот не отвечает на все отправляемые ему сообщения (коэффициент конверсии запросов / ответов для вашего бота был слишком низким по крайней мере в течение двух из последних трех 5-минутных периодов). Чтобы обеспечить хороший пользовательский интерфейс, пожалуйста, отвечайте на все сообщения, которые отправляются вашему боту. Отвечайте на обновления сообщений , вызывая методы отправки ... (например, SendMessage).
3.
Too few answers to **inline queries**. Conversion rate: **{value}**
Ваш бот не отвечает на все встроенные запросы, которые ему отправляются, рассчитанные так же, как и выше. Отвечайте на обновления inline_query, вызывая answerInlineQuery .
4.
Too few answers to **callback queries**. Conversion rate: **{value}**
Too few answers to **callback game queries**. Conversion rate: **{value}**
Ваш бот не отвечает на все отправляемые ему запросы обратного вызова (с играми или без игр), рассчитанные таким же образом, как указано выше. Отвечайте на обновления callback_query, вызывая answerCallbackQuery .
Обратите внимание, что функция оповещения о состоянии все еще тестируется и будет улучшена в будущем.
Вот и все для введения. Теперь вы определенно готовы перейти к РУКОВОДСТВУ по API БОТОВ.
<a href=https://t.me/investors_channel>квалифицированный инвестор</a> рассказывает Канал Инвестор, также затрагиваем темы - ищу инвестора, лучшие инвесторы, доход инвестора, стану инвестором и многие другие.