Ландроматик бот не работает

Боты: информация для разработчиков

Боты — специальные аккаунты в Telegram, созданные для того, чтобы автоматически обрабатывать и отправлять сообщения. Пользователи могут взаимодействовать с ботами при помощи сообщений, отправляемых через обычные или групповые чаты. Логика бота контролируется при помощи HTTPS запросов к нашему API для ботов.

Общие сведения

Что могут делать боты?

Вот несколько примеров использования ботов:

• Интеграция с другими сервисами. Например, бот может отправлять комментарии или управлять «умным домом». Или, например, отправлять вам уведомления при совершении каком-то действия или события (Примеры: GitHub Bot, Image Bot).
• Утилиты и инструменты. Бот может отображать погоду, переводить тексты или предупреждать о предстоящих событиях по вашему запросу (Например: бот опросов).
• Одно- и многопользовательские игры. Бот может поиграть с вами в шашки или шахматы, проводить викторины и так далее. (Пример: Trivia bot).
• Социальные сервисы. Бот может находить вам собеседника, основываясь на ваших общих интересах и увлечениях. (Пример: HotOrBot).
• Все, что вам захочется. Бота можно запрограммировать для чего угодно. Разве что посуду они помыть не смогут.

Как работают боты?

Как уже было сказано ранее, роботы — особые аккаунты, которые не требуют номера телефона при создании. По сути, эти аккаунты играют роль интерфейса к вашему сервису, который работает на удалённом сервере.

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

Рекомендуем также ознакомиться с подробным описанием Bot API.

Как создать бота?

Для этого есть. Бот. Просто напишите пользователю @BotFather и следуйте его инструкциям. Как только вы создали бота и получили свой ключ (токен) авторизации, переходите в раздел документации Bot API, чтобы начать настраивать вашего бота.

Чем бот отличается от обычного аккаунта?

• У роботов нет статусов «онлайн» и «был в сети», вместо этого отображается надпись «бот».
• Для ботов выделено ограниченное место на серверах — все сообщения будут удалены по прошествии определённого срока после обработки.
• Боты не могут сами начать общение с пользователем. Пользователь должен либо добавить робота в группу, либо первым начать с ним диалог. Для этого можно использовать ссылки вида t.me/ или поиск по имени пользователя.
• Имя пользователя у робота должно заканчиваться на «bot» (например, @controllerbot).
• При добавлении в конференцию, по умолчанию робот не получает всех сообщений (см. режим приватности).
• Роботы никогда не спят, не едят и не жалуются (если только вы не запрограммируете их на обратное).

Суперспособности

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

Инлайн-режим

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

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

Под капотом у игр — HTML5, поэтому вы можете создавать игры любой сложности. На данный момент командой Telegram созданы несколько демо-игр:

Клавиатуры

Одна из самых необычных возможностей Bot API — кастомизированные клавиатуры. При передаче сервером ответа есть возможность передать команду на отображение специальной клавиатуры с предустановленными вариантами ответа (см. ReplyKeyboardMarkup). Клиент Telegram, получив сообщение, отобразит пользователю вашу клавиатуру. Нажатие на клавишу сразу же отправит на сервер соответствующую команду. Таким образом можно значительно упростить взаимодействие робота с пользователем. На данный момент для отображения на клавише могут использоваться эмодзи и текст. Вот несколько примеров таких клавиатур:

За более подробной информацией обращайтесь к описанию метода sendMessage.

Команды

Команды представляют собой более гибкий способ общения с ботом. Рекомендуется следующий синтаксис:

Команда должна начинаться с символа косой черты «/» и не может быть длиннее 32 символов. Команды могут состоять из букв латинского алфавита, цифр и подчёркивания. Несколько примеров:

Сообщения, начинающиеся с косой черты, будут всегда доставляться боту (точно также, как и при ответе на его сообщения и на @упоминания бота в чате). Приложения Telegram будут:

• Предлагать список поддерживаемых команд с их описанием, когда пользователь введёт символ косой черты «/» (чтобы этот пункт работал, вам необходимо задать описание команд у @BotFather). Нажатие на описание приведёт к отправке этой команды.
• Показывать кнопку (/) в поле ввода текста во всех чатах с ботами. Нажатие на эту кнопку отобразит список доступных команд.
• Подсвечивать /команды в сообщениях. При нажатии на такую подсвеченную команду, она будет сразу же отправлена боту.

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

Это происходит автоматически, если вы выбираете команду из списка доступных.

Глобальные команды

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

• /start — начинает общение с пользователем (например, отправляет приветственное сообщение). В эту команду также можно передавать дополнительные аргументы (см. внешнее связывание).
• /help — отображает сообщение с помощью по командам. Оно может представлять собой короткое сообщение о вашем боте и список доступных команд.
• /settings — (по возможности) возвращает список возможных настроек и команды для их изменения.

При попытке начать общение с роботом, пользователь увидит кнопку СТАРТ. На странице профиля бота также будут доступны ссылки Помощь и Настройки.

Режим приватности

Ботов часто добавляют в группы, чтобы получать различную информацию — новости, уведомления и т.д. Однако, при добавлении бота вы наверняка спрашивали себя: «А что если этот маленький засранец пересылает всю групповую переписку куда-то “налево”?» Именно поэтому у роботов есть режимы приватности.

Робот с включенным режимом приватности не будет получать всех сообщений, а только сообщения, удовлетворяющие этим условиям:

• Сообщения, начинающиеся с символа косой черты «/» (см. раздел Команды)
• Сообщения, содержащие @упоминание бота
• Ответы на сообщения бота
• Служебные сообщения (о добавлении пользователя, смены изображения группы и т.д.)

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

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

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

Внешнее связывание

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

У каждого робота есть ссылка, при помощи которой можно начать с ним диалог — https://t.me/ . К этой ссылке можно добавить параметры *start или startgroup со значением длиной до 64 символов. Пример:

Допустимо использование символов A-Z , a-z , 0-9 , _ и — . Мы рекомендуем использовать base64url для кодирования параметров.

Переход по ссылке с параметром start начнет чат с ботом, при этом в поле ввода текста будет отображаться кнопка СТАРТ. При переходе по ссылке с параметром startgroup пользователю будет предложено добавить бота в одну из доступных групп. Как только пользователь подтвердит своё действие (нажмёт на кнопку СТАРТ или выберет группу), бот получит сообщение следующего формата:

В PAYLOAD будет значение параметра start или startgroup , который был передан в ссылке.

Пример реализации внешнего связывания

Предположим, сайт example.com хочет отправлять пользователю уведомления с помощью Telegram-бота. Ниже приведено описание последовательности действий для реализации отправки уведомлений пользователю с ID 123 .

1. Создайте бота с любым именем, например, @ExampleComBot
2. Настройте вебхук для входящих сообщений
3. Сгенерируйте ключ достаточной длины, напр. $memcache_key = ‘TESTKEY’
4. Запишите значение 123 с ключом $memcache_key в Memcache на 3600 секунд (один час)
5. Отправьте пользователю ссылку https://t.me/ExampleComBot?start=TESTKEY
6. Настройте обработчик веб-хуков так, чтобы он запрашивал в Memcached значение входящего параметра каждый раз, когда приходит сообщение, начинающееся со /start . Если ключ существует, записываем chat_id, переданный в веб-хук, в telegram_chat_id для пользователя 123 . Удаляем ключ из Memcache.
7. Теперь, если мы хотим отправить сообщение пользователю 123 , сначала проверяем telegram_chat_id . Если оно существует, используем метод sendMessage, чтобы отправить пользователю сообщение.

BotFather

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

Создание бота

Напишите команду /newbot , чтобы создать нового робота. BotFather спросит у вас имя нового бота и предложит придумать username.

Имя (name) будет отображаться в контактах и чатах.

Username — короткое имя на латинице, которое используется для упоминаний бота и в ссылках на профиль в telegram.me. Username должен состоять из букв латинского алфавита, подчёркиваний и цифр и быть длиной от 5 до 32 символов. Также имя пользователя обязательно должно заканчиваться на «bot», например: «tetris_bot» или «TetrisBot».

Ключ (токен) это набор символов вида 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw , который нужен, чтобы получать и отправлять сообщения с помощью Bot API.

Создание токена

Если вы потеряли или утратили доступ к токену, отправьте команду /token , чтобы сгенерировать новый.

Настройки

• /setname — Изменить имя робота.
• /setdescription — Изменить описание робота, представляющее собой короткий текст с описанием бота. Пользователи увидят его в самом начале, под заголовком «Что умеет этот робот?».
• /setabouttext — Изменить информацию о боте, ещё более короткий текст, отображающийся в профиле бота. Ещё, если кто-то поделится вашим ботом, то вместе со ссылкой на него отправится этот текст.
• /setuserpic — Изменить аватарку бота. Картинки — всегда хорошо.
• /setcommands — Изменить список команд бота. Каждая команда состоит из собственно командного слова, начинающегося с символа косой черты («/») и короткого описания. Пользователи увидят список команд при вводе символа «/».
• /setjoingroups — Определяет, можно ли добавлять вашего бота в группы.
• /setprivacy — Определяет, все ли сообщения видит ваш бот в группах. В выключенном состоянии роботу будут отправляться все сообщения.
• /deletebot — Удалить бота и его имя пользователя.

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

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

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

Источник

Не работают боты в telegram: причины и решение проблемы

Сloudflare telegram bot не работает — если ты увидел эту ошибку, ты попал по адресу! В статье расскажем про оценку сертификата и что делать, если telegram bot не работает. Боты в Телеграмм значительно облегчают работу в приложении, обеспечивают комфортное и удобное общение, ускоряют выполнение некоторых функций, а также предоставляют дополнительные возможности, полезные при переписке. Иногда пользователь Telegram сталкивается с тем, что команды, отправляемые роботу, не срабатывают, и, соответственно, запросы не выполняются. Что делать, если у вас не работают боты в телеграмм, и чем это обусловлено, читайте ниже.

Причины возникновения неполадок

• Неправильная формулировка. При ошибке в запросе программа не получит отправленное сообщение, и не сможет выполнить команду;
• Удаление или блокировка профиля в сервисном центре компании Telegram. В таком случае возобновление его работы невозможно. Чаще всего это происходит с не востребованными или бесполезными страницами/с теми, на кого поступают жалобы. Ни в коем случае не устанавливайте поддельных, ложных роботов, созданных сомнительными пользователями для замены блокированных;
• Бот, в коде которого есть ошибки. Телеграмм предоставляет пользователю самостоятельно создавать ботов. Если при его создании код был написан и работает неправильно, наличие погрешностей будет препятствовать выполнению команды, несмотря на то, что робот получит сообщения.;
• Недостаточное количество добавленного боту телеграмм мультимедийного контента. Ваши команды могут быть не выполнены из-за того, что при создании вы не добавили в него необходимое количество слов или файлов;
• Устаревшая версия Telegram. В обновленном варианте приложения разработчики могли внести некоторые изменения в функционирование программы телеграмм, вследствие чего привычные команды перестают срабатывать.

Предотвращение проблемы

Если у вас собственный робот в Telegram, нужно найти ошибку в его коде и исправить ее.

• Рекомендуется написать команду @Botfather — он поможет создать новые программы Telegram и устранить ошибки в предыдущих, будет отправлять вам инструкции с указаниями для написания правильного кода;
• При некорректной работе в группах или прочих сообществах Telegram нужно написать @BotFather сообщение “/setprivacy”. В таком случае он начнет получать команды. Его прошлая неактивность обусловлена тем, что компания телеграмм установила ограничения в их функционировании в групповых чатах. Подробнее о работе ботов и некоторых деталях читайте в разделе “Помощь”;

При поиске Telegram будьте аккуратны с выбором правильного варианта. Иногда те или иные страницы телеграмм блокируют на определенное время, и в этот период появляются фейки, или, как их еще называют, зеркала. Такие роботы часто разрабатываются пользователями, не имеющими опыта в данной процедуре, и, как следствие, работают с ошибками. Чтобы отличить настоящего робота от фейкового, смотрите на его название и адрес. Под именем адрес робота обязательно должен начинаться с символа “@”.
Если на вашем смартфоне не установлена последняя версия телеграмм, сделайте это. Данный шаг не только избавит вас от проблемы, но и предотвратит возникновение новых.
Бот в мессенджере – это программа, которая способна реагировать на команды пользователя. Команды предопределены программным кодом и предлагаются клиенту уже готовые. Иногда случаются сбои. Разберем причины, почему не работает бот в Телеграмм.

Как понять, что сервис не работает

В некоторых случаях бот сам сообщает о прекращении своей деятельности. Это происходит, если создатель позаботился предусмотреть подобное сообщение. Например, для @voiceri_bot вы можете увидеть стартовое сообщение о том, что у автора закончились деньги и желание на хостинг. Многие боты Телеграмм не отвечают и просто не реагируют на команды.

Причины отказа

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

Ошибка на стороне сервера Телеграмм

Программный код любого робота основан на отправке запросов, созданных командами Telegram Bot API. Принимает их сервер https://api.telegram.org. Если по какой-либо причине на нем произошел сбой, ни один сервис вообще работать не будет. В таком случае следует просто дождаться, когда сервер поднимут и он начнет нормально функционировать.

Ошибка на стороне сервера программы

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

Ошибка в запросе

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

Проблема со связью

Часто не работает бот Телеграмм, если на стороне пользователя или сервера, где размещен робот, нет подключения к Интернет. Если для хостинга – это аварийная ситуация, то у пользователей такое может происходить довольно часто. Особенно с мобильным Интернетом. Проверьте качество и устойчивость соединения. Сервисы Телеграмм, осуществляющие поиск информации в сети, могут действовать медленно или вообще ничего не делать при постоянных разрывах связи. Попробуйте улучшить качество коннекта, или ждите, когда оно наладится у провайдера.

Технические работы

Бот в Телеграмме не отвечает и в случаях проведения технических работ по его оптимизации. Обычно разработчики об этом сообщают. Следует дождаться их окончания.

Большое количество запросов

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

Источник