Sorry the username must end in bot e g tetris bot or tetrisbot

03.09.202203.09.2022 admin 0 Comments

Sorry the username must end in bot e g tetris bot or tetrisbot

БОТ В ТЕЛЕГРАМ

Наша интеграция с Telegram позволяет вам добавить Telegram bot в ваш аккаунт WhatsHelp. Обратите внимание, что вы должны быть авторизованы в Телеграмме для создания нового бота.

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

Создание нового бота происходит при помощи официального бота Телеграм @BotFather.

Начните диалог с этим ботом и при помощи команды ‘/newbot’ создайте собственного.

После указания всех необходимых параметров, вы получите Токен (секретный ключ) для доступа к боту через API. Данный ключ понадобится для подключения бота к WhatsHelp.

Подключение Telegram

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

Установка приветственного сообщения

КАК ПОЛУЧИТЬ ТОКЕН?

BotFather

BotFather is the one bot to rule them all. It will help you create new bots and change settings for existing ones.

Creating a new bot

Use the /newbot command to create a new bot. The BotFather will ask you for a name and username, then generate an authorization token for your new bot.

The name of your bot is displayed in contact details and elsewhere.

The Username is a short name, to be used in mentions and telegram.me links. Usernames are 5-32 characters long and are case insensitive, but may only include Latin characters, numbers, and underscores. Your bot’s username must end in ‘bot’, e.g. ‘tetris_bot’ or ‘TetrisBot’.

The token is a string along the lines of 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw that is required to authorize the bot and send requests to the Bot API. Keep your token secure and store it safely, it can be used by anyone to control your bot.

Generating an authorization token

If your existing token is compromised or you lost it for some reason, use the /token command to generate a new one.

Botfather commands

The remaining commands are pretty self-explanatory:

Please note, that it may take a few minutes for changes to take effect.

Пишем Telegram-бота на Rust, который будет запускать код на… Rust?

Доброй ночи! Сегодня хотелось бы кратко рассказать о том, как написать Telegram-бота на Rust, который будет запускать код на Rust. У статьи нет цели произвести полное погружение в API telegram_bot, Serde, Telegram или в нюансы разработки на Rust. Она скорее носит ознакомительный характер. Числа Пеано с помощью системы типов складывать не будем.

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

Для начала создадим бота и получим HTTP API токен.

Заходим к этому парню и пишем следующее:

Alright, a new bot. How are we going to call it? Please choose a name for your bot.

Done! Congratulations on your new bot. You will find it at t.me/rustlanguage_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you’ve finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this. Use this token to access the HTTP. API: %TOKEN% For a description of the Bot API, see this page: https://core.telegram.org/bots/api

Отлично. Бот создан. %TOKEN% — это, собственно, и есть токен.

Rust Playground

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

Перейдя по ссылке, введём простую hello-world программу:

Вроде бы всё прозрачно и понятно. Попробуем воспроизвести из консоли:

Отлично, поехали дальше.

Пишем бота

Добавим следующие зависимости в Cargo.toml :

Кратко опишу, зачем они нужны:

Serde предназначена для сериализации/десериализации данных в различных форматах. В данном случае нам необходима работа с JSON (serde_json) и щепотка кодогенерации (serde_derive);

Hyper для работы с сетью будем использовать HTTP-клиент, который она предоставляет для взаимодействия с Rust Playground. Так как взаимодействие производится по протоколу HTTPS, ещё необходима батарейка в виде hyper-rustls ;

В src/main.rs подключим все необходимые библиотеки и модули:

Примечание: #[macro_use] используется для включения в область видимости текущей программы макросов из библиотеки, к которой был применён данный атрибут.

В данной строке импортируем модули из корня библиотеки для определения типа сообщения, метода «прослушки», структуры представляющей API Telegram:

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

Определим структуру для нашего запроса в Rust Playground:

В главной функции программы main создадим инстанс Telegram API и заставим его печатать всё, что пришло боту в сообщении:

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

Немного разберём, что мы написали выше.

Под конец создаём цикл обработки сообщений при помощи функции listen и сопоставления по шаблону типа сообщения:

Условимся, что код мы будем передавать только в текстовом виде. Файлы и прочее исключим. Для этого, как вы могли заметить, все остальные варианты перечисления MessageType просто игнорируются.

Мы обрабатываем запрос только лишь в случае, если сообщение начинается с определённой команды ( /rust ):

А так же вытаскиваем код программы, которую необходимо скомпилировать:

Обрабатываем пришедший ответ:

Отправка результатов компиляции в чат:

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

Проверяем работоспособность

Вывод в консоль:

Заключение

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

Sorry the username must end in bot e g tetris bot or tetrisbot

This project its to create an echo bot for Telegram

##The BotFather is the manager of the BotSystem

BotFather is the one bot to rule them all. It will help you create new bots and change settings for existing ones.

Create a new bot Use the /newbot command to create a new bot. The BotFather will ask you for a «name» and «username», then generate an authorization token for your new bot.

it’s a little tricky that you need two names. The important name it´s username. It’s the way the people will call your bot.

The name of your bot will be displayed in contact details and elsewhere.

The token is a string along the lines of 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw that will be required to authorize the bot and send requests to the Bot API.

Generate an authorization token for your bot If your existing token is compromised or you lost it for some reason, use the /token command to generate a new one.

Bot generation example:

BotFather Alright, a new bot. How are we going to call it? Please choose a name for your bot.

BotFather Sorry, this username is already taken. Think of something different.

BotFather Done! Congratulations on your new bot. You will find it at telegram.me/zyx_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands.

Use this token to access the HTTP API: 116169643:AAGHoOYKNAjvCH1YtTaKGzUYn1tXQLA6rx8

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

BotFather Choose a bot to generate a new token.

BotFather You can use this token to access HTTP API: 9999999999:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

Comunicating with your bot

You should call the telegram yourBot API to get info about the messages it receives:

All queries to the Telegram Bot API must be served over HTTPS and need to be presented in this form: https://api.telegram.org/bot/METHOD_NAME. Like this for example:

*Important: bot its bot, not the name of your bot.

With this call, remembert to put your own bot access key

We support GET and POST HTTP methods. Use either URL query string or application/x-www-form-urlencoded or multipart/form-data for passing parameters in Bot API requests.

The response contains a JSON object, which always has a Boolean field ‘ok’ and may have an optional String field ‘description’ with a human-readable description of the result. If ‘ok’ equals true, the request was successful and the result of the query can be found in the ‘result’ field. In case of an unsuccessful request, ‘ok’ equals false and the error is explained in the ‘description’. An Integer ‘error_code’ field is also returned, but its contents are subject to change in the future.

In this case you will get something like this.

All methods in the Bot API are case-insensitive. All queries must be made using UTF-8.

Getting chat input

There are two mutually exclusive ways to get chat input. Incoming updates are stored on the server until the bot receives them either way, but they will not be kept longer than 24 hours.

Regardless of which option you choose, you will receive JSON-serialized Update objects as a result.

GetUpdates: it’s an active option. You need to call Telegram to get info SetWebhook: it’s a pasive option. telegram will make a post call ehenever he receives a message.

Update This object represents an incoming update.

|update_id|Integer|The update‘s unique identifier. Update identifiers start from a certain positive number and increase sequentially. This ID becomes especially handy if you’re using Webhooks, since it allows you to ignore repeated updates or to restore the correct update sequence, should they get out of order.| |message|Message|Optional. New incoming message of any kind — text, photo, sticker, etc.|

With getUpdates you can setup a pooling mechanism to pool data from the bot and process it, we will use this method in our examples (only to obtain a chat_id).

getUpdates Use this method to receive incoming updates using long polling (wiki). An Array of Update objects is returned.

|offset|Integer|Optional|Identifier of the first update to be returned. Must be greater by one than the highest among the identifiers of previously received updates. By default, updates starting with the earliest unconfirmed update are returned. An update is considered confirmed as soon as getUpdates is called with an offset higher than its update_id.| |limit|Integer|Optional|Limits the number of updates to be retrieved. Values between 1—100 are accepted. Defaults to 100| |timeout|Integer|Optional|Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling|

If there are not mesaages, you receive this

If there are mesaages, you receive something like this

In thes case, two messages, the beggining of the conversation and the message «hola».

With setWebhook we can setup a «callback» url where the bot will push everything received into a conversation.

Use this method to specify a url and receive incoming updates via an outgoing webhook. Whenever there is an update for the bot, we will send an HTTPS POST request to the specified url, containing a JSON-serialized Update. In case of an unsuccessful request, we will give up after a reasonable amount of attempts.

If you’d like to make sure that the Webhook request comes from Telegram, we recommend using a secret path in the URL, e.g. www.example.com/. Since nobody else knows your bot‘s token, you can be pretty sure it’s us.

To send a message:

The remaining commands are pretty self-explanatory:

/setname – change your bot’s name. /setdescription — changes the bot’s description, a short text of up to 512 characters, describing your bot. Users will see this text at the beginning of the conversation with the bot, titled ‘What can this bot do?’. /setabouttext — changes the bot’s about info, an even shorter text of up to 120 characters. Users will see this text on the bot’s profile page. When they share your bot with someone, this text will be sent together with the link. /setuserpic — changes the bot‘s profile pictures. It’s always nice to put a face to a name. /setcommands — changes the list of commands supported by your bot. Each command has a name (must start with a slash ‘/’, alphanumeric plus underscores, no more than 32 characters, case-insensitive), parameters, and a text description. Users will see the list of commands whenever they type ‘/’ in a conversation with your bot. /setjoingroups — determines whether your bot can be added to groups or not. Any bot must be able to process private messages, but if your bot was not designed to work in groups, you can disable this. /setprivacy — determines which messages your bot will receive when added to a group. With privacy mode disabled, the bot will receive all messages. We recommend leaving privacy mode enabled. /deletebot — deletes your bot and frees its username. Please note, that it may take a few minutes for changes to take effect.

How to create a bot?

There’s a… bot for that. Just talk add BotFather to your Telegram and continue as follows. Once you’ve created a bot and received your authorization token, head down to the Installation page to see what you can do to get it up and running

Create a new bot: use the /newbot command to create a new bot. The BotFather will ask you for a name and username, then generate an authorization token for your new bot.

The name of your bot will be displayed in contact details and elsewhere. The Username is a short name, to be used in mentions and telegram.me links. Usernames are 5-32 characters long and are case insensitive, but may only include Latin characters, numbers, and underscores. Your bot’s username must end in ‘bot’, e.g. ‘tetris_bot’ or ‘TetrisBot’. The Bot Token is a string along the lines of 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw that will be required to authorize the bot and send requests to the Bot API.

Generate an authorization token for your bot If your existing token is compromised or you lost it for some reason, use the /token command to generate a new one.

Edit settings: the remaining commands are pretty self-explanatory:

Sorry the username must end in bot e g tetris bot or tetrisbot

Copy raw contents

Create a Telegram Bot with Botfather

BotFather is the one bot to rule them all. It will help you create new bots and change settings for existing ones. Commands known by Botfather

Creating a new Bot

@botfather replies with Alright, a new bot. How are we going to call it? Please choose a name for your bot.

Type whatever name you want for your bot.

@botfather replies with Good. Now let’s choose a username for your bot. It must end in bot. Like this, for example: TetrisBot or tetris_bot.

@botfather replies with:

Done! Congratulations on your new bot. You will find it at telegram.me/telesample_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands.

Use this token to access the HTTP API: 123456789:AAG90e14-0f8-40183D-18491dDE

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

Note down the ‘token’ mentioned above.

Type /setprivacy to @botfather.

@botfather replies with Choose a bot to change group messages settings.

Type @telesample_bot (change to the username you set at step 5 above, but start it with @ )

@botfather replies with

Type Disable to let your bot receive all messages sent to a group. This step is up to you actually.

@botfather replies with Success! The new status is: DISABLED. /help

Bots: An introduction for developers

Bots are third-party applications that run inside Telegram. Users can interact with bots by sending them messages, commands and inline requests. You control your bots using HTTPS requests to Telegram’s Bot API.

Telegram keeps evolving and adding new features, so this document may contain outdated information.
We expect to finish updating the FAQ, Bot Manuals, and other documents by the end of Summer 2022.

To name just a few things, you could use bots to:

Get customized notifications and news. A bot can act as a smart newspaper, sending you relevant content as soon as it’s published.

Accept payments from Telegram users. A bot can offer paid services or work as a virtual storefront. Read more »
Demo Shop Bot, Demo Store

Create custom tools. A bot may provide you with alerts, weather forecasts, translations, formatting or other services.
Markdown bot, Sticker bot, Vote bot, Like bot

Build single- and multiplayer games. A bot can offer rich HTML5 experiences, from simple arcades and puzzles to 3D-shooters and real-time strategy games.
GameBot, Gamee

Build social services. A bot could connect people looking for conversation partners based on common interests or proximity.

Do virtually anything else. Except for dishes — bots are terrible at doing the dishes.

At the core, Telegram Bots are special accounts that do not require an additional phone number to set up. Users can interact with bots in two ways:

Messages, commands and requests sent by users are passed to the software running on your servers. Our intermediary server handles all encryption and communication with the Telegram API for you. You communicate with this server via a simple HTTPS-interface that offers a simplified version of the Telegram API. We call that interface our Bot API.

A detailed description of the Bot API is available on this page »

There’s a… bot for that. Just talk to BotFather (described below) and follow a few simple steps. Once you’ve created a bot and received your authentication token, head down to the Bot API manual to see what you can teach your bot to do.

You may also like to check out some code examples here »

Telegram bots are unique in many ways — we offer two kinds of keyboards, additional interfaces for default commands and deep linking as well as text formatting, integrated payments and more.

Users can interact with your bot via inline queries straight from the text input field in any chat. All they need to do is start a message with your bot’s username and then type a query.

Having received the query, your bot can return some results. As soon as the user taps one of them, it is sent to the user’s currently opened chat. This way, people can request content from your bot in any of their chats, groups or channels.

Check out this blog to see a sample inline bot in action. You can also try the @sticker and @music bots to see for yourself.

We’ve also implemented an easy way for your bot to switch between inline and PM modes.

You can use bots to accept payments from Telegram users around the world.

Bots can offer their users HTML5 games to play solo or to compete against each other in groups and one-on-one chats. The platform allows your bot to keep track of high scores for every game played in every chat. Whenever there’s a new leader in the game, other playing members in the chat are notified that they need to step it up.

Since the underlying technology is HTML5, the games can be anything from simple arcades and puzzles to multiplayer 3D-shooters and real-time strategy games. Our team has created a couple of simple demos for you to try out:

You can also check out the @gamee bot that has more than 20 games.

Traditional chat bots can of course be taught to understand human language. But sometimes you want some more formal input from the user — and this is where custom keyboards can become extremely useful.

Whenever your bot sends a message, it can pass along a special keyboard with predefined reply options (see ReplyKeyboardMarkup). Telegram apps that receive the message will display your keyboard to the user. Tapping any of the buttons will immediately send the respective command. This way you can drastically simplify user interaction with your bot.

We currently support text and emoji for your buttons. Here are some custom keyboard examples:

For more technical information on custom keyboards, please consult the Bot API manual (see sendMessage).

There are times when you’d prefer to do things without sending any messages to the chat. For example, when your user is changing settings or flipping through search results. In such cases you can use Inline Keyboards that are integrated directly into the messages they belong to.

Unlike with custom reply keyboards, pressing buttons on inline keyboards doesn’t result in messages sent to the chat. Instead, inline keyboards support buttons that work behind the scenes: callback buttons, URL buttons and switch to inline buttons.

When callback buttons are used, your bot can update its existing messages (or just their keyboards) so that the chat remains tidy. Check out these sample bots to see inline keyboards in action: @music, @vote, @like.

Commands present a more flexible way to communicate with your bot. The following syntax may be used:

A command must always start with the ‘/’ symbol and may not be longer than 32 characters. Commands can use latin letters, numbers and underscores. Here are a few examples:

Messages that start with a slash are always passed to the bot (along with replies to its messages and messages that @mention the bot by username). Telegram apps will:

If multiple bots are in a group, it is possible to add bot usernames to commands in order to avoid confusion:

This is done automatically when commands are selected via the list of suggestions. Please remember that your bot needs to be able to process commands that are followed by its username.

In order to make it easier for users to navigate the bot multiverse, we ask all developers to support a few basic commands. Telegram apps will have interface shortcuts for these commands.

Users will see a Start button when they first open a conversation with your bot. Help and Settings links will be available in the menu on the bot’s profile page.

You can use bold, italic or fixed-width text, as well as inline links in your bots’ messages. Telegram clients will render them accordingly.

Bots are frequently added to groups in order to augment communication between human users, e.g. by providing news, notifications from external services or additional search functionality. This is especially true for work-related groups. Now, when you share a group with a bot, you tend to ask yourself “How can I be sure that the little rascal isn’t selling my chat history to my competitors?” The answer is — privacy mode.

A bot running in privacy mode will not receive all messages that people send to the group. Instead, it will only receive:

On one hand, this helps some of us sleep better at night (in our tinfoil nightcaps), on the other — it allows the bot developer to save a lot of resources, since they won’t need to process tens of thousands irrelevant messages each day.

Privacy mode is enabled by default for all bots, except bots that were added to the group as admins (bot admins always receive all messages). It can be disabled, so that the bot receives all messages like an ordinary user (the bot will need to be re-added to the group for this change to take effect). We only recommend doing this in cases where it is absolutely necessary for your bot to work — users can always see a bot’s current privacy setting in the group members list. In most cases, using the force reply option for the bot’s messages should be more than enough.

Telegram bots have a deep linking mechanism, that allows for passing additional parameters to the bot on startup. It could be a command that launches the bot — or an authentication token to connect the user’s Telegram account to their account on some external service.

Following a link with the start parameter will open a one-on-one conversation with the bot, showing a START button in the place of the input field. If the startgroup parameter is used, the user is prompted to select a group to add the bot to. As soon as a user confirms the action (presses the START button in their app or selects a group to add the bot to), your bot will receive a message from that user in this format:

PAYLOAD stands for the value of the start or startgroup parameter that was passed in the link.

Some bots need extra data from the user to work properly. For example, knowing the user’s location helps provide more relevant geo-specific results. The user’s phone number can be very useful for integrations with other services, like banks, etc.

Bots can ask a user for their location and phone number using special buttons. Note that both phone number and location request buttons will only work in private chats.

When these buttons are pressed, Telegram clients will display a confirmation alert that tells the user what’s about to happen.

BotFather is the one bot to rule them all. It will help you create new bots and change settings for existing ones.

Use the /newbot command to create a new bot. The BotFather will ask you for a name and username, then generate an authentication token for your new bot.

The name of your bot is displayed in contact details and elsewhere.

The Username is a short name, to be used in mentions and t.me links. Usernames are 5-32 characters long and are case insensitive, but may only include Latin characters, numbers, and underscores. Your bot’s username must end in ‘bot’, e.g. ‘tetris_bot’ or ‘TetrisBot’.

The token is a string along the lines of 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw that is required to authorize the bot and send requests to the Bot API. Keep your token secure and store it safely, it can be used by anyone to control your bot.

If your existing token is compromised or you lost it for some reason, use the /token command to generate a new one.

The remaining commands are pretty self-explanatory:

Edit bots

Edit settings

Manage games

Please note, that it may take a few minutes for changes to take effect.

Millions choose Telegram for its speed. To stay competitive in this environment, your bot also needs to be responsive. In order to help developers keep their bots in shape, Botfather will send status alerts if it sees something is wrong.

We will be checking the number of replies and the request/response conversion rate for popular bots (

300 requests per minute: but don’t write this down as the value may change in the future). If we get abnormally low readings, you will receive a notification from Botfather.

By default, you will only get one alert per bot per hour. Each alert has the following buttons:

We will currently notify you about the following issues:

Your bot is sending much fewer messages than it did in the previous weeks. This is useful for newsletter-style bots that send out messages without prompts from the users. The larger the value, the more significant the difference.

Your bot is not replying to all messages that are being sent to it (the request/response conversion rate for your bot was too low for at least two of the last three 5-minute periods). To provide a good user experience, please respond to all messages that are sent to your bot. Respond to message updates by calling send… methods (e.g. sendMessage).

Your bot is not replying to all inline queries that are being sent to it, calculated in the same way as above. Respond to inline_query updates by calling answerInlineQuery.

Your bot is not replying to all callback queries that are being sent to it (with or without games), calculated in the same way as above. Respond to callback_query updates by calling answerCallbackQuery.

Please note that the status alerts feature is still being tested and will be improved in the future.

That’s it for the introduction. You are now definitely ready to proceed to the BOT API MANUAL.

If you’ve got any questions, please check out our Bot FAQ »

Telegram бот на PHP пошаговая инструкция

Предисловие

У меня появилась необходимость создать telegram бота на php, так как это один из основных языков, который я использую в своих разработках. Безусловно, для этого есть большие библиотеки, например на github, среди них есть достаточно хорошие, но часть из них либо плохо, либо вообще не документированы. Также сложности возникают, когда нужно немного поменять или добавить функционал, необходимо изучить десятки файлов, устранять возникающие ошибки, когда нужно просто добавить кнопку. Для простых действий можно вполне обойтись библиотекой Guzzle, для удобства построения запросов, вместо стандартного CURL, так как telegram API просто обрабатывает запросы в формате JSON и возвращает результат, как и многие другие API.

Скачать исходники, описанные ниже, можно в конце статьи.

Все запросы к telegram API обрабатываются следующим образом, это всего лишь запрос на адрес: https://api.telegram.org/bot /METHOD_NAME. Где после bot подставляется полученный от @BotFather токен, затем /название_метода. Ссылка на оф. сайт, с описанием всех методов telegram API https://core.telegram.org/bots/api#available-methods

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

Шаг 1 — Подготовка среды

Для работы нам потребуется:

Шаг 2 — Получение токена

Токен бота — это как его идентификатор в системе, он необходим для формирования запросов к api. Процесс его получения достаточно простой, в строке поиска telegram вводим @BotFather и находим аккаунт.

Переходим в чат с @BotFather и пишем команду /newbot

В ответ получаем:

Alright, a new bot. How are we going to call it? Please choose a name for your bot. — Что означает: Хорошо, новый бот. Как мы собираемся это назвать? Пожалуйста, выберите имя для вашего бота.

Отправляем следующим сообщением название бота, в примере: testingbot, получаем ответ: Good. Now let’s choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot. — Что означает: Хорошо. Теперь давайте выберем имя пользователя для вашего бота. Оно должно заканчиваться на `бот`. Вот так, например: Tetris Bot или tetris_bot.

Следующим сообщением я отправил testing99_bot, но получил ответ, что такое имя пользователя занято : Sorry, this username is already taken. Please try something different. Такое сообщение свидетельствует о том, что такое имя пользователя занято. Значит необходимо выбрать другое, в итоге вот такое было свободно botfortest99_bot. И мы получаем такое сообщение, содержащее токен токен.

Done! Congratulations on your new bot. You will find it at t.me/botfortest99_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you’ve finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.

Use this token to access the HTTP API:

Keep your token secure and store it safely, it can be used by anyone to control your bot.

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

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

Шаг 3 — Регистрация хука

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

Для установки вебхука(скрипта), который будет обрабатывать команды и отвечать на сообщения, необходимо открыть в браузере такую строку:

https://api.telegram.org/bot5236473451:AAEAjVbZY0kbxOLwBFYTV4j1YXRs77HmJEI/setWebhook?url=https://ae-nekrasov.ru/devbot/index.php

В результате открытия этой строки в браузере и нажатии кнопки enter, мы получаем такое сообщение : <«ok»:true,»result»:true,»description»:»Webhook was set»>— это означает, что вебхук установлен и теперь отправленные боту сообщения будут приходить на этот адрес.

Шаг 4 — Прием и обработка сообщений от пользователей

Чтобы принимать и обрабатывать сообщения нужно понять модель взаимодействия с telegram API и куда и в каком формате нам будут приходить сообщения.

Отправляем нашему боту несколько сообщений и посмотрим, что будет в файле apidata.txt.

Содержимое файла apidata.txt

Просмотрев содержимое файла, мы видим, что достаточно много данных нам отправляет telegram API. Исходя из этого, можно перейти к построению обработчика. Дальнейшие действия предполагают, что подготовка среды(см. Шаг1) Вы прошли и Вам будет понятно, что происходит дальше.

В директорию, где находится файл index.php размещаем файл composer.json, со следующим содержимым :

И выполняем в терминале команду composer require, в результате мы увидим что-то вроде:

Это означает, что необходимые пакеты с зависимостями установились, появилась папка vendor. Для своих классов создаем директорию src, в корне проекта. Там разместим первый класс Api и файл соответственно называется Api.php, со следующим содержимым:

В коде выше, был создан класс Api и внутри него метод sendMessage, на основе данных описанных в официальной документации telegram API по отправке сообщений https://core.telegram.org/bots/api#sendmessage

Теперь модифицируем файл index.php, чтобы он был такого содержимого:

Если Вы все сделали по инструкции описанной выше, то теперь на любые сообщения бот будет отвечать «Привет». Небольшая gif-ка с результатом работы.

Работает, естественно отвечать на все сообщения «Привет» — это не окончательная функциональность. Теперь нужно как-то обработать входящие сообщения и исходя из содержимого уже отправлять ответ.

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

Также модифицируем файл index.php, новый код:

Теперь бот просто будет повторюшкой, он будет отправлять нам то, что мы ему, ниже gif-ка с примером работы:

Модифицируем index.php, добавим if else ветвления, чтобы отвечать уже в зависимости от того, что нам отправит пользователь, новый код:

Теперь бот отвечает специальным ответом, в зависимости от вопроса, ниже gif-ка с примером работы:

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

Шаг 5 — Обработка команд

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

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

Шаг 6 — Добавление кнопок в чат и обработка нажатий

В рамках данной статьи рассмотрим два варианта кнопок:

Вариант 1. Кнопки в зоне основной клавиатуры

Вариант 2. Кнопки под сообщением

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

Второй вариант обрабатывается немного иначе, я для этого использую даже другой метод отправки сообщения, после нажатия на такую клавиатуру, это обусловлено тем, что при нажатии кнопок в режиме callback query, к нам придет немного другой формат массива с данными, точнее данные([from],[message],[chat]) будут вложены в массив [‘callback_query’]

Для экспериментов с кнопками, необходимо добавить в файл Api.php несколько методов, фрагмент добавляемого кода:

В комментариях к методам описано, для чего каждый из них необходим. Первый метод необходим, чтобы в файле index.php попасть в ветвление, где происходит обработка нажатия кнопок под сообщением. Второй метод немного отличается от стандартного, где происходит отправка сообщений, он необходим для отправки сообщения, когда нажаты кнопки выведенные под сообщением. Третий метод выводит кнопки под сообщением. Четвертый выводит кнопки в зоне стандартной клавиатуры и смайлов.

Также необходимо обновить файл index.php, его новый код:

Если Вы все делали по инструкции, то должен быть такой результат, как на gif-ке ниже:

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

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

Блог Lazarus-программиста

Блог о программировании

Telegram Bot API. Часть 1

Добрый день дорогие читатели. Сегодня я начал экспериментировать с созданием бота для Telegram на Lazarus. Ниже я буду описывать процесс создания бота от А до Я.

Прежде чем начать создавать бота, нужно почитать немного о таких вещах как формат данных JSON, как его парсить, ну и по хорошему документацию Telegram API Bot

Лично Я для облегчения своей работы использовал открытую библиотеку Superobject, которая легко позволяет парсить JSON

Нам интересны следующие файлы:

Данную библиотеку бросаем в папку с проектом и подключаем в Uses.

2. Для работы с https нам так же потребуется 2 библиотеки: libeay32.dll и ssleay32.dll — Скачать, их тоже бросаем в папку с проектом.

3. А для отправки запросов http нам понадобится библиотека Indy, как ее установить читайте здесь: http://www.freepascal.ru/article/lazarus/20100812185950/

Теперь для начала нам нужно создать бота в чате с @BotFather и получить уникальный Token, выглядит он примерно так: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Через любое доступное приложение Telegram, пишет в личку @BotFather следующие команды:

/newbot

Вводим название бота

Если получаем в ответ «Good. Now let’s choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.» значит имя свободно, теперь требуется создать имя бота по которому мы сможем к нему обращаться @имябота. Обязательно нужно чтобы имя вашего бота заканчивалось на bot или _bot

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

«Done! Congratulations on your new bot. You will find it at telegram.me/имябота. You can now add a description, about section and profile picture for your bot, see /help for a list of commands.

Use this token to access the HTTP API:
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

For a description of the Bot API, see this page: https://core.telegram.org/bots/api«

Поздравляю! Пол дела сделано. И последние что мы сделаем в первой статье, это проверим работу нашего токена. Для начала просто в браузере введите: https://api.telegram.org/botВашТокен/GetMe (Например: https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/GetMe)

В ответ мы должны получить:

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

Для начала этого достаточно. В следующий раз расскажу как отсылать, и принимать сообщения с помощью long polling. Спасибо за внимание.