Как обновить бота telegram

7

Чат-бот вместо сайта и мобильного приложения: как бизнесу использовать новые возможности Telegram

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

Команда Telegram не просто подкрутила пару винтиков — по сути, она предложила революционную концепцию. Разработчикам чат-ботов предоставили средства для создания разнообразных интерфейсов на JavaScript. Это означает, что телеграм-боты 2.0 смогут без преувеличения заменить любое мобильное приложение или сайт. Новые функции работают и в веб-версии мессенджера.

Давайте сравним, что умели чат-боты в Telegram до обновлений и какими они могут стать сейчас.

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

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

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

Пример интерфейса можно увидеть в демонстрационном боте @DurgerKingBot.

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

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

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

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

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

FMCG-компании могут реализовать в Telegram интерактивную программу лояльности c провекой чеков и выдачей купонов. А HR-отделам крупных организаций будет удобно использовать обновленных ботов для онбординга или создания корпоративного университета.

Здесь возникает вопрос: а зачем вообще переносить мобильное приложение или сайт в Telegram?

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

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

Для компаний, которые активно размещают рекламные сообщения в Telegram, есть отдельная опция: запуск веб-приложений из меню вложений. Это означает, что боты будут предлагать пользователям добавить их иконку в меню, которое открывается нажатием «скрепки». Вот так это выглядит на примере @DurgerKingBot.

Благодаря этой функции клиент сможет запускать бота компании в два клика из любого чата.

До того, как сервис прокачал чат-ботов, у него уже было много преимуществ.

Во-первых, в начале этого года Telegram впервые обошел WhatsApp в России. По данным компании «МегаФон», за первые две недели марта его доля в общем объеме трафика в мессенджерах увеличилась с 48% до 63%.

В это же время доля WhatsApp упала с 48% до 32%. Напомним, что в прошлом году он был безусловным лидером: по информации разных исследований, через него общались от 52 до 82% российских пользователей. Доля Viber остается незначительной, при этом она тоже сократилась — с 5% до 4%.

Во-вторых, WhatsApp принадлежит компании Meta, которая признана экстремистской организацией в России. И хотя его не заблокировали, создание на этой платформе чат-ботов пока под вопросом.

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

Если вы все еще сомневаетесь в перспективах Telegram, добавим, что он завоевал лидерство почти во всех уголках России. Согласно тому же исследованию «МегаФона», на конец 2021 года этот сервис был главным средством общения в 55 регионах, а в начале 2022 года — уже в 82. Ежедневная аудитория Telegram с 24 февраля по 15 марта выросла на 46%, с 31 млн человек до 45,5 млн.

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

Если вы хотите знать больше о том, как технологии помогают компаниям расти и совершенствовать процессы, подписывайтесь на наш телеграм-канал «ИИшечная». Там мы публикуем полезные материалы, подборки мировых новостей о развитии искусственного интеллекта и его применении в решении бизнес-задач.

А потом вашу телегу блочат. И колесо сансары делает новый оборот.

Видимо блокировки соц сеток недавние ничему не учат.

Попытки заблокировать уже были, но как-то у успеху не привели) Да и VPN никто не отменял

Я понял о чем вы. Но предсказывать что будет в будущем основываясь на прошлом заранее неверная позиция. Так просто делать нельзя. На ошибках учатся, знаете?

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

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

По поводу впн, как показали последние события, не особо помогает. Видно падение аудитории в инсте. Нет аудитории, бизнес сосет лапу.

Согласен, но в текущей ситуации никто не может предсказать, что будет дальше. Уйдут одни соц сети/мессенджеры — появятся новые, аудитория сама по себе не исчезнет, а просто перекачует в какой-то другой канал: новый или существующий. Поэтому нужно просто быть антихрупким, так сказать, и подстраиваться под эти изменения. Пока есть какой-то работающий инструмент, его, как мне кажется, нужно по максимуму использовать, заблокируют, нужно искать новый и использовать уже его.

Это так и есть. Да их нужно использовать, но при этом иметь хотя бы небольшой сайт.

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

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

Более менее серьезному бизнесу сайт всегда нужен

Да, заблочат прослушку для всей страны. Пока Дуров устраивает PR акции, что он точно не пёс Путина. Телеграм будет превращаться в супер-апп для выкачки мегатон данных с жителей

где же посадки на основании мегатонн данных?

Если бы вы знали какая идеология у Павла Дурова, вы бы так не писали. Все его технологии в последнее время связаны с максимальной свободой слова, и не только слова. Чтобы государство не могло вмешаться в это. Посмотрите его проект The Open Network.

Посмотрел. Они же вроде отказались от этой идеи официально. Я понимаю что вы написали. Но я бы не верил всему что заявляет Дуров. Слова это мишура, главное поступки.

это телега, кого надо телега.
вангую что из нее будут лепить wechat по-русски, чтоб сразу всё было под надзором — и деньги, и разговоры.

Просто риск есть всегда. И надо думать наперед. Будущее таит в себе столько неожиданного.

Если бы у кого-нибудь спросили, полгода назад, возможно ли что США заморозят резервы РФ. Я думаю что они сказали бы нет.

Верхах сидят люди православные, устраивают библейские сценарии. Вместо яблока — телеграм. Запретят еще больше искушений и скачиваний будет.
Хм,или это уже было пару лет назад? Когда Роскомпозор бегал дырявой сеточкой и ловил телегу

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

Вс связи с последними событиями, это еще более очевидно.

Не знаю что то,а телегу пока ни разу не блочили

"Вместо" плохая затея, чем больше каналов вы используете тем проще клиенту найти вас. Использование одного канала в случае изменения обстоятельств обычно приводит к слезам.

Мобильные приложения для разовых покупок неудобно устанавливать и захламлять телефон. А сделать заказ через бота с удобством на уровне приложения в самый раз����

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

На саму телегу нагрузка не сильно ложится. Мы в студии проверили — в случае с Durker King можно открыть отдельно js-сайт, который встроен в окно Телеграм.

Скоро вообще все переедет в Телеграм, будем там и чатиться, и продукты на дом заказывать, и услуги жкх оплачивать, музыку слушать и фильмы смотреть
Хотя большинство из этого списка уже можно там делать.

В Китае вичат уже давно так работает)

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

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

Вот недавно после апдейта телеги обсуждал с коллегами, а можно ли реально заменить ботом продукт (без сайта и мобильного приложения). Технически — да, будут конечно ограничения по аналитике например, но услуги предоставлять можно. Но лично моя позиция, что у меня все равно нет доверия ко всему где есть название бот и например я бы побоялся давать данные карты для оплаты или какие-то персональные данные типа скана паспорта или типа того, а многим продуктам это нужно. Ну и как-то меньше доверия к компании у которой мало технического стафа который можно увидеть. Я считаю, что как дополнительный канал взаимодействия с клиентом бот это хорошо, но для компании с именем, с которой был уже опыт взаимодействия вне бота. Т.е. как второстепенный канал предоставления услуг — отлично, но как основной канал он будет вызывать меньше доверия, чем тот же сайт.

Ребят, а уже кто-то делал веб-боты? Или только этот пример с бургерами и все?

Почему обновление ботов Telegram — это настоящий прорыв

Внимательные пользователи Telegram знают, что последнее обновление совершило тихую революцию, причем не только внутри мессенджера, но и в Сети в целом. Правда, пока это никто толком не заметил. Но это пока.

Я, естественно, говорю про новые возможности для создания ботов. Вы скажите: «Ну и что? Боты в Telegram были всегда». Но вот в чём дело: с 2015 по апрель 2022 боты хоть и решали множество задач, но интерфейсом напоминали в лучшем случае текстовый квест из 80-ых. Теперь же это полноценный «стор» приложений или, если хотите, метавселенная.

Нововведение даёт возможность создавать интерфейсы на JavaScript. А это значит, что внутри мессенджера можно делать целые мобильные приложения, сайты, игры — вы ограничены только своей фантазией (и своими кодерами). Это, простите за англицизм, game changer.

Демо-бот @DurgerKingBot, сделанный командой мессенджера, уже демонстрирует функциональность условного Glovo (чтоб не обижать игроков российского рынка). И это только начало: через шаг — Сбер и Альфа делают своих ботов на замену удалённых мобильных приложений, через два —условный Epic сделает на их базе казуальную игру, через три — у нас вообще исчезнут какие-либо причины выходить из Telegram. Боты могут закрыть любые потребности для бизнеса, сервисов и медиа.

Я связался с Александром Корсом, создателем конструктора ботов Botmaker, у которого в конце прошлого года брал интервью для своего канала. И на примере своего конструктора он вживую показал, как может выглядеть реализация подобных ботов.

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

Задолго до реализации web-интерфейса мы начали создавать чат-боты для разного бизнеса, которые привлекали, возвращали и повышали качество обслуживания их клиентов. Теперь в наши наработки мы будем внедрять web-интерфейс. Кстати, наш сервис уже готов дать коробочные решения для разных ниш, тем самым мы обеспечим бизнес эффективным инструментом.

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

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

А это уже совершенно новый сценарий пользования смартфоном и ПК. Не говорите потом, что я вас не предупреждал.

Справочник по Bot API

Bot API представляет из себя HTTP-интерфейс для работы с ботами в Telegram.

Подробнее о том, как создать и настроить своего бота, читайте в статье с информацией для разработчиков.

Авторизация бота

Каждому боту при создании присваивается уникальный токен вида 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 . В документации для простоты вместо него будет использоваться <token> . Подробнее о том, как получить или заменить токен для вашего бота, читайте в этой статье.

Отправка запросов

Все запросы к Telegram Bot API должны осуществляться через HTTPS в следующем виде: https://api.telegram.org/bot<token>/НАЗВАНИЕ_МЕТОДА . Например:

Допускаются GET и POST запросы. Для передачи параметров в Bot API доступны 4 способа:

Ответ придёт в виде JSON-объекта, в котором всегда будет булево поле ok и опциональное строковое поле description , содержащее человекочитаемое описание результата. Если поле ok истинно, то запрос прошёл успешно и результат его выполнения можно увидеть в поле result . В случае ошибки поле ok будет равно false , а причины ошибки будут описаны в поле description . Кроме того, в ответе будет целочисленное поле error_code , но коды ошибок будут изменены в будущем.

Все методы регистрозависимы и должны быть в кодировке UTF-8.

Отправка запросов при получении обновления

Если ваш бот работает через вебхуки, то вы можете осуществить запрос к Bot API одновременно с отправкой ответа на вебхук. Для передачи параметров нужно использовать один из типов:

• application/json
• application/x-www-form-urlencoded
• multipart/form-data

Метод для вызова должен быть определён в запросе в поле method . Однако, имейте в виду: невозможно узнать статус и результат такого запроса.

Примеры таких запросов описаны в FAQ.

Получение обновлений

Существует два диаметрально противоположных по логике способа получать обновления от вашего бота: getUpdates и вебхуки. Входящие обновления будут храниться на сервере до тех пор, пока вы их не обработаете, но не дольше 24 часов.

Независимо от способа получения обновлений, в ответ вы получите объект Update, сериализованный в JSON.

Update

Этот объект представляет из себя входящее обновление. Под обновлением подразумевается действие, совершённое с ботом — например, получение сообщения от пользователя.

Только один из необязательных параметров может присутствовать в каждом обновлении.

getUpdates

Этот метод используется для получения обновлений через long polling (wiki). Ответ возвращается в виде массива объектов Update.

Примечание:

1. Этот метод не будет работать, если у вас уже подключен webhook.
2. Во избежания повторяющихся обновлений, рекомендуется высчитывать offset каждый раз заново.

setWebhook

Этот метод необходим для задания URL вебхука, на который бот будет отправлять обновления. Каждый раз при получении обновления на этот адрес будет отправлен HTTPS POST с сериализованным в JSON объектом Update. При неудачном запросе к вашему серверу попытка будет повторена умеренное число раз.

Для большей безопасности рекомендуется включить токен в URL вебхука, например, так: https://yourwebhookserver.com/<token> . Так как никто посторонний не знает вашего токена, вы можете быть уверены, что запросы к вашему вебхуку шлёт именно Telegram.

Примечание:

1. При подключенном и настроенном вебхуке метод getUpdates не будет работать.
2. При использовании самоподписанного сертификата, вам необходимо загрузить публичный ключ с помощью параметра certificate .
3. На текущий момент отправка обновлений через вебхуки доступна только на эти порты: 443, 80, 88, 8443.

getWebhookInfo

Содержит информацию о текущем состоянии вебхука.

Доступные типы

Все типы, использующиеся в Bot API, являются JSON-объектами.

Для хранения всех полей типа Integer безопасно использовать 32-битные знаковые целые числа, если не указано иначе.

Этот объект представляет бота или пользователя Telegram.

Этот объект представляет собой чат.

Message

Этот объект представляет собой сообщение.

MessageEntity

Этот объект представляет одну из особых сущностей в текстовом сообщении. Например: хештеги, имена пользователей, ссылки итд.

PhotoSize

Этот объект представляет изображение определённого размера или превью файла / стикера.

Audio

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

Document

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

Sticker

Этот объект представляет стикер.

Video

Этот объект представляет видеозапись.

Voice

Этот объект представляет голосовое сообщение.

Contact

Этот объект представляет контакт с номером телефона.

Location

Этот объект представляет точку на карте.

Venue

Этот объект представляет объект на карте.

UserProfilePhotos

Этот объект содержит фотографии профиля пользователя.

Этот объект представляет файл, готовый к загрузке. Он может быть скачан по ссылке вида https://api.telegram.org/file/bot<token>/<file_path> . Ссылка будет действительна как минимум в течение 1 часа. По истечении этого срока она может быть запрошена заново с помощью метода getFile.

ReplyKeyboardMarkup

Этот объект представляет клавиатуру с опциями ответа (см. описание ботов).

KeyboardButton

Этот объект представляет одну кнопку в клавиатуре ответа. Для обычных текстовых кнопок этот объект может быть заменён на строку, содержащую текст на кнопке.

Внимание:

ReplyKeyboardHide

После получения сообщения с этим объектом, приложение Telegram свернёт клавиатуру бота и отобразит стандартную клавиатуру устройства (с буквами). По умолчанию клавиатуры бота отображаются до тех пор, пока не будет принудительно отправлена новая или скрыта старая клавиатура. Исключение составляют одноразовые клавиатуры, которые скрываются сразу после нажатия на какую-либо кнопку (см. ReplyKeyboardMarkup).

InlineKeyboardMarkup

Этот объект представляет встроенную клавиатуру, которая появляется под соответствующим сообщением.

Внимание:

InlineKeyboardButton

Этот объект представляет одну кнопку встроенной клавиатуры. Вы обязательно должны задействовать ровно одно опциональное поле.

Внимание:

CallbackQuery

Этот объект представляет входящий запрос обратной связи от инлайн-кнопки с заданным callback_data .

Если кнопка, создавшая этот запрос, была привязана к сообщению, то в запросе будет присутствовать поле message .

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

ForceReply

Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot‘s message and tapped ’Reply’). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.

Пример:

• Explain the user how to send a command with parameters (e.g. /newpoll question answer1 answer2). May be appealing for hardcore users but lacks modern day polish.
• Guide the user through a step-by-step process. ‘Please send me your question’, ‘Cool, now let’s add the first answer option‘, ’Great. Keep adding answer options, then send /done when you‘re ready’.

The last option is definitely more attractive. And if you use ForceReply in your bot‘s questions, it will receive the user’s answers even if it only receives replies, commands and mentions — without any extra work for the user.

ResponseParameters

Содержит информацию о том, почему запрос не был успешен.

InputFile

This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.

Resending files without reuploading

There are two ways of sending a file (photo, sticker, audio etc.). If it‘s a new file, you can upload it using multipart/form-data. If the file is already on our servers, you don’t need to reupload it: each file object has a file_id field, you can simply pass this file_id as a parameter instead.

• It is not possible to change the file type when resending by file_id. I.e. a video can’t be sent as a photo, a photo can’t be sent as a document, etc.
• It is not possible to resend thumbnails.
• Resending a photo by file_id will send all of its sizes.

Inline mode objects

Objects and methods used in the inline mode are described in the Inline mode section.

Доступные методы

getMe

A simple method for testing your bot’s auth token. Requires no parameters. Returns basic information about the bot in form of a User object.

sendMessage

Use this method to send text messages. On success, the sent Message is returned.

Formatting options

The Bot API supports basic formatting for messages. You can use bold and italic text, as well as inline links and pre-formatted code in your bots’ messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.

Note that Telegram clients will display an alert to the user before opening an inline link (‘Open this link?’ together with the full URL).

Markdown style

To use this mode, pass Markdown in the parse_mode field when using sendMessage. Use the following syntax in your message:

HTML style

To use this mode, pass HTML in the parse_mode field when using sendMessage. The following tags are currently supported:

• Only the tags mentioned above are currently supported.
• Tags must not be nested.
• All < , > and & symbols that are not a part of a tag or an HTML entity must be replaced with the corresponding HTML entities ( < with &lt; , > with &gt; and & with &amp; ).
• All numerical HTML entities are supported.
• The API currently supports only the following named HTML entities: &lt; , &gt; , &amp; and &quot; .

forwardMessage

Use this method to forward messages of any kind. On success, the sent Message is returned.

sendPhoto

Use this method to send photos. On success, the sent Message is returned.

sendAudio

Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .mp3 format. On success, the sent Message is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future.

For sending voice messages, use the sendVoice method instead.

sendDocument

Use this method to send general files. On success, the sent Message is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future.

sendSticker

Use this method to send .webp stickers. On success, the sent Message is returned.

sendVideo

Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as Document). On success, the sent Message is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.

sendVoice

Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .ogg file encoded with OPUS (other formats may be sent as Audio or Document). On success, the sent Message is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future.

sendLocation

Use this method to send point on the map. On success, the sent Message is returned.

sendVenue

Use this method to send information about a venue. On success, the sent Message is returned.

sendContact

Use this method to send phone contacts. On success, the sent Message is returned.

sendChatAction

Use this method when you need to tell the user that something is happening on the bot’s side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status).

Пример:

We only recommend using this method when a response from the bot will take a noticeable amount of time to arrive.

getUserProfilePhotos

Use this method to get a list of profile pictures for a user. Returns a UserProfilePhotos object.

getFile

Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path> , where <file_path> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling getFile again.

kickChatMember

Use this method to kick a user from a group or a supergroup. In the case of supergroups, the user will not be able to return to the group on their own using invite links, etc., unless unbanned first. The bot must be an administrator in the group for this to work. Returns True on success.

Внимание:

unbanChatMember

Use this method to unban a previously kicked user in a supergroup. The user will not return to the group automatically, but will be able to join via link, etc. The bot must be an administrator in the group for this to work. Returns True on success.

answerCallbackQuery

Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.

Inline mode methods

Methods and objects used in the inline mode are described in the Inline mode section.

Updating messages

The following methods allow you to change an existing message in the message history instead of sending a new one with a result of an action. This is most useful for messages with inline keyboards using callback queries, but can also help reduce clutter in conversations with regular chat bots.

Please note, that it is currently only possible to edit messages without reply_markup or with inline keyboards.

editMessageText

Use this method to edit text messages sent by the bot or via the bot (for inline bots). On success, the edited Message is returned.

editMessageCaption

Use this method to edit captions of messages sent by the bot or via the bot (for inline bots). On success, the edited Message is returned.

editMessageReplyMarkup

Use this method to edit only the reply markup of messages sent by the bot or via the bot (for inline bots). On success, the edited Message is returned.

Inline-режим

The following methods and objects allow your bot to work in inline mode.
Please see our Introduction to Inline bots for more details.

To enable this option, send the /setinline command to @BotFather and provide the placeholder text that the user will see in the input field after typing your bot’s name.

InlineQuery

This object represents an incoming inline query. When the user sends an empty query, your bot could return some default or trending results.

answerInlineQuery

Use this method to send answers to an inline query. On success, True is returned.
No more than 50 results per query are allowed.

InlineQueryResult

This object represents one result of an inline query. Telegram clients currently support results of the following 19 types:

InlineQueryResultArticle

Represents a link to an article or web page.

InlineQueryResultPhoto

Represents a link to a photo. By default, this photo will be sent by the user with optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the photo.

InlineQueryResultGif

Represents a link to an animated GIF file. By default, this animated GIF file will be sent by the user with optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the animation.

InlineQueryResultMpeg4Gif

Represents a link to a video animation (H.264/MPEG-4 AVC video without sound). By default, this animated MPEG-4 file will be sent by the user with optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the animation.

InlineQueryResultVideo

Represents a link to a page containing an embedded video player or a video file. By default, this video file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the video.

InlineQueryResultAudio

Represents a link to an mp3 audio file. By default, this audio file will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the audio.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultVoice

Represents a link to a voice recording in an .ogg container encoded with OPUS. By default, this voice recording will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the the voice message.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultDocument

Represents a link to a file. By default, this file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the file. Currently, only .PDF and .ZIP files can be sent using this method.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultLocation

Represents a location on a map. By default, the location will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the location.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultVenue

Represents a venue. By default, the venue will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the venue.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultContact

Represents a contact with a phone number. By default, this contact will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the contact.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultCachedPhoto

Represents a link to a photo stored on the Telegram servers. By default, this photo will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the photo.

InlineQueryResultCachedGif

Represents a link to an animated GIF file stored on the Telegram servers. By default, this animated GIF file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with specified content instead of the animation.

InlineQueryResultCachedMpeg4Gif

Represents a link to a video animation (H.264/MPEG-4 AVC video without sound) stored on the Telegram servers. By default, this animated MPEG-4 file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the animation.

InlineQueryResultCachedSticker

Represents a link to a sticker stored on the Telegram servers. By default, this sticker will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the sticker.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultCachedDocument

Represents a link to a file stored on the Telegram servers. By default, this file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the file. Currently, only pdf-files and zip archives can be sent using this method.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultCachedVideo

Represents a link to a video file stored on the Telegram servers. By default, this video file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the video.

InlineQueryResultCachedVoice

Represents a link to a voice message stored on the Telegram servers. By default, this voice message will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the voice message.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InlineQueryResultCachedAudio

Represents a link to an mp3 audio file stored on the Telegram servers. By default, this audio file will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the audio.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InputMessageContent

This object represents the content of a message to be sent as a result of an inline query. Telegram clients currently support the following 4 types:

InputTextMessageContent

Represents the content of a text message to be sent as the result of an inline query.

InputLocationMessageContent

Represents the content of a location message to be sent as the result of an inline query.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InputVenueMessageContent

Represents the content of a venue message to be sent as the result of an inline query.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

InputContactMessageContent

Represents the content of a contact message to be sent as the result of an inline query.

Note: This will only work in Telegram versions released after 9 April, 2016. Older clients will ignore them.

ChosenInlineResult

Represents a result of an inline query that was chosen by the user and sent to their chat partner.

Боты теперь умеют предоставлять пользователям возможность поиграть в HTML5-игры. Создать игру можно при помощи бота @BotFather и команды /newgame. Обратите внимание, что для создания игры вам нужно принять соглашение.

• Игры — новый тип контента, представленный объектами Game и InlineQueryResultGame.
• Как только вы создали игру с помощью бота BotFather, вы сможее отправлять игры в чаты или при помощи метода sendGame, или используя встроенный режим с методом InlineQueryResultGame.
• Если вы отправите сообщение с игрой без каких-либо кнопок, к нему автоматически добавится кнопка ‘Играть в ИмяИгры‘. Когда кто-то нажмёт на эту кнопку, вашему боту придёт CallbackQuery с параметром game_short_name. После этого вы должны предоставить корректный URL страницы с игрой, который автоматически откроется во встроенном браузере у пользователя.
• Вы можете сами добавить сколько угодно кнопок к сообщению с игрой. Пожалуйста, обратите внимание, что первая кнопка в первом ряду всегда должна открывать игру. Для этого существует поле callback_game в объекте InlineKeyboardButton. Остальные кнопки могут быть какими угодно: ссылки на сайт игры, вызов правил, и т. д.
• Чтобы описание игры выглядело более привлекательно, вы можете загрузить GIF-анимацию с геймплеем игры. Сделать это можно при помощи бота BotFather (пример такой игры: Lumberjack).
• В сообщении с игрой также будет отображаться таблица рекордов для текущего чата. Чтобы отображать рекорды в чате с игрой, вы можете использовать метод setGameScore. Добавьте параметр edit_message, чтобы автоматически обновлять сообщение с таблицей рекордов.
• Чтобы отобразить таблицу рекордов прямо в вашем приложении, используйте метод getGameHighScores.
• Вы можете добавить кнопки «Поделиться», которые позволят пользователям отправлять свои результаты в чаты или группы.

sendGame

Этот метод используется для отправки игры в виде обычного сообщения. В случае успеха возвращает объект с отправленным сообщением Message.

Этот объект представляет собой игру.

Animation

Чтобы сообщение с игрой выглядело более привлекательно, вы можете загрузить для игры анимацию с геймплее. Этот объект представляет собой файл анимации, который будет отображён в сообщении с игрой.

CallbackGame

Заглушка, пока не содержит никакой информации.

setGameScore

Используйте этот метод, чтобы обновить игровой счёт определённого пользователя. Если сообщение было отправлено ботом, вернёт отредактированное сообщение Message, иначе True. Вернёт ошибку, если вы попытаетесь установить новый счёт меньше, чем текущий.

getGameHighScores

Используйте этот метод, чтобы получить данные для таблицы рекордов. Этот метод возвращает счёт указанного пользователя и нескольких его соседей по таблице. В случает успеха вернёт массив объектов GameHighScore.

GameHighScore

Этот объект представляет собой один из рядов таблицы рекордов игры.

Сайт про Telegram на русском (неофициальный).

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