# Telegram

<div id="bkmrk-%D0%94%D0%BB%D1%8F-%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8-%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB">Для интеграции канала Telegram c платформой Metabot24 необходимо создать аккаунт и задать адрес бота в Telegram.</div><div id="bkmrk-"></div><div id="bkmrk--0"></div><iframe allowfullscreen="allowfullscreen" frameborder="0" height="446" src="https://www.youtube.com/embed/aYD18P5kwk4" style="width: 731px; height: 429px;" title="Metabot24. Интеграция с Telegram" width="759"></iframe>

### Настройки канала

<p class="callout info">Для настройки интеграции рекомендуется использовать ПК версию мессенджера Telergam.</p>

В поиске по ID необходимо найти **@BotFather**.

В найденном боте следует открыть список команд и выбрать функцию **/newbot**.

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-03/scaled-1680-/qJDqjBltO4C10UnX-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-03/qJDqjBltO4C10UnX-image.png)

Затем нужно ввести имя нового бота (то, что будет отображаться в Именной строке).

[![метабот бот.png](https://docs.metabot24.ru/uploads/images/gallery/2025-03/scaled-1680-/t3UU1APHwboot8RW-metabot-bot.png)](https://docs.metabot24.ru/uploads/images/gallery/2025-03/t3UU1APHwboot8RW-metabot-bot.png)

Название может быть на любом языке и может быть созвучно с вашим бизнесом. Например, **primerbot**.

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2023-01/scaled-1680-/krW46PZ5njG7Yigl-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2023-01/krW46PZ5njG7Yigl-image.png)

Далее укажите ID для мессенджера (то, что будет использоваться для ссылки), оно может совпадать с именем бота для удобства.

[![метабот бот.png](https://docs.metabot24.ru/uploads/images/gallery/2025-03/scaled-1680-/c2PEFkEmWf7MkqEn-metabot-bot.png)](https://docs.metabot24.ru/uploads/images/gallery/2025-03/c2PEFkEmWf7MkqEn-metabot-bot.png)

Например, укажем со словом test **test\_rpimerbot**.

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2023-01/scaled-1680-/PNmYkSeJHu5lEfoi-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2023-01/PNmYkSeJHu5lEfoi-image.png)

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

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2023-01/scaled-1680-/XPO7IPN8ZxtpeL7b-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2023-01/XPO7IPN8ZxtpeL7b-image.png)

Перейдите в **Настройки бота** в раздел подраздел **Каналы**.

Нажмите кнопку **Новая привязка** и выберите канал Telegram, вставьте токен.

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-03/scaled-1680-/aJXqRwqyZzxodTCV-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-03/aJXqRwqyZzxodTCV-image.png)

Остальные параметры можете заполнить по желанию:<label for="in_photo_behavior"></label>

- **Использовать inline-кнопки** <span style="font-weight: 400;">— в</span>место списка вариантов в боте будет выводиться inline-кнопка отдельно для каждого варианта из меню;
- **Реакция на фото** <span style="font-weight: 400;">— в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать фото отправленные пользователем, либо реагировать при помощи NLP или выводом меню;</span>
- **Контекст NLP для фото** <span style="font-weight: 400;">— контекст NLP для реакции на фото;</span>
- **Отключить Fallback для фото** <span style="font-weight: 400;">— при игнорировании фото, не активировать для него Fallback скрипт;</span>
- **Реакция на файлы (документы)** <span style="font-weight: 400;">— в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать файлы отправленные пользователем, либо реагировать при помощи NLP или выводом меню;</span>
- **Контекст NLP для файлов (документов)** <span style="font-weight: 400;">— контекст NLP для реакции на файлы;</span>
- **Отключить Fallback для файлов (документов)** <span style="font-weight: 400;">— при игнорировании файлов, не активировать для них Fallback скрипт; </span>
- **Реакция на видео** <span style="font-weight: 400;">— в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать видео отправленные пользователем, либо реагировать при помощи NLP или выводом меню;</span>
- **Контекст NLP для видео** <span style="font-weight: 400;">— контекст NLP для реакции на видео;</span>
- **Отключить Fallback для видео** <span style="font-weight: 400;">— при игнорировании видео, не активировать для него Fallback скрипт;</span>
- **Реакция на аудио** <span style="font-weight: 400;">— в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать аудио отправленные пользователем, либо реагировать при помощи NLP или выводом меню;</span>
- **Контекст NLP для аудио** <span style="font-weight: 400;">— контекст NLP для реакции на аудио;</span>
- **Отключить Fallback для аудио** <span style="font-weight: 400;">— при игнорировании аудио, не активировать для него Fallback скрипт;</span>
- **Реакция на голосовые сообщения** <span style="font-weight: 400;">— в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать голосовые сообщения отправленные пользователем, либо реагировать при помощи NLP или выводом меню;</span>
- **Контекст NLP для голосовых сообщений** <span style="font-weight: 400;">— контекст NLP для реакции на голосовые сообщения;</span>
- **Отключить Fallback для голосовых сообщений** <span style="font-weight: 400;">— при игнорировании голосовых сообщений, не активировать для них Fallback скрипт;</span>
- **Реакция на стикер** <span style="font-weight: 400;">— в зависимости от выбора пункта из выпадающего списка, бот будет либо игнорировать стикеры отправленные пользователем, либо реагировать при помощи NLP или выводом меню;</span>
- **Контекст NLP для стикера** <span style="font-weight: 400;">— контекст NLP для реакции на стикеры;</span>
- **Отключить Fallback для стикера** <span style="font-weight: 400;">— при игнорировании стикера, не активировать для него Fallback скрипт.</span>

<p class="callout warning"><span style="font-weight: 400;">Если оставить настройки файлов без изменений, то бот будет реагировать на них вызовом Fallback-а.</span></p>

Нажмите кнопку **Сохранить**. Новая привязка создана и для завершения настройки необходимо нажать ссылку **Вебхук**.

<p class="callout warning">Не забудьте сгенерировать **Вебхук** в поле **Операции**, иначе операция привязки бота к каналу не будет завершена.</p>

[![Без имени.png](https://docs.metabot24.ru/uploads/images/gallery/2024-09/scaled-1680-/Hpv1EG4nCeQcAksE-bez-imeni.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-09/Hpv1EG4nCeQcAksE-bez-imeni.png)

Далее необходимо подтвердить или отменить выполняемую операцию. Оставьте версию без изменений, как было предложено.

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-03/scaled-1680-/A8kUJihRtJP86qwZ-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-03/A8kUJihRtJP86qwZ-image.png)

Подключение к каналу Telegram завершено.

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

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2023-01/scaled-1680-/3bCzE0xcEk6ef5dS-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2023-01/3bCzE0xcEk6ef5dS-image.png)

Нажмите кнопку **Запустить**. На экране должно появиться приветственное сообщение — это свидетельствует о правильности привязки канала.

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2023-01/scaled-1680-/MWVR4zGg35iaVm7P-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2023-01/MWVR4zGg35iaVm7P-image.png)

### <span style="font-weight: 400;">Оформление карточки бота</span>

<span style="font-weight: 400;">Чтобы наполнить бота информацией необходимо выбрать раздел **/mybots** *—* **edit your bots \[beta\]** в сообщении с помощью или меню.</span>

<span style="font-weight: 400;">Выберите бота, которого хотите изменить и н</span><span style="font-weight: 400;">ажмите кнопку **Edit Bot**.</span>

<span style="font-weight: 400;"><span style="font-weight: normal;"><span style="font-size: 14pt; font-family: 'Times New Roman', serif; color: #000000; background-color: transparent; font-weight: 400; font-style: normal; font-variant: normal; white-space-collapse: preserve;">[![редактирование бота.png](https://docs.metabot24.ru/uploads/images/gallery/2024-02/scaled-1680-/GSyjFvbokjFRFoLQ-redaktirovanie-bota.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-02/GSyjFvbokjFRFoLQ-redaktirovanie-bota.png)</span></span></span>

<span style="font-weight: 400;">Далее выберите, что именно хотите изменить: название, описание или информацию о боте. </span>

<p class="callout warning"><span style="font-weight: 400;">Команды тоже можно поставить, но данный функционал работает не во всех логических сценариях ботов, тут нужно продумывать дополнительные запросы в НЛП системы.</span></p>

- <span style="font-weight: 400;">**Edit Name** — м</span>еняет имя в главной строке. Введите новое имя и отправьте боту (замена моментальная);

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2025-03/scaled-1680-/FKPXlIBXaoLRi1K3-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2025-03/FKPXlIBXaoLRi1K3-image.png)

- <span style="font-weight: 400;">**Edit Description** — м</span><span style="font-weight: 400;">еняет первое сообщение, приглашающее к диалогу. </span><span style="font-weight: 400;">Введите текст и отправьте боту (замена моментальная);</span>

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2025-03/scaled-1680-/JfnJAk2yf8jjUmbK-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2025-03/JfnJAk2yf8jjUmbK-image.png)

- <span style="font-weight: 400;">**Edit About** — м</span><span style="font-weight: 400;">еняет описание бота в карточке аккаунта. </span><span style="font-weight: 400;">Введите описание, объем 120 символов (замена моментальная);</span>

<span style="font-weight: 400;"><span id="bkmrk--24" style="font-weight: normal;"><span style="font-size: 14pt; font-family: 'Times New Roman', serif; color: #000000; background-color: transparent; font-weight: 400; font-style: italic; font-variant: normal; white-space-collapse: preserve;"><span style="border-width: initial; border-style: none; display: inline-block; overflow: hidden; width: 384px; height: 240px;">![](https://lh7-us.googleusercontent.com/TtEInZwHm0i11MMS_S8_CGnk9kXZQ0zK_hZdPREFwsoBq0OzwGry4fiTF5C31lMJ7GVQUf9js76pAI8pDukL5EzGqBJ_csk1197t0-44ocvXz8FtkvTBUaqZSGaThbo0mElw6MP9z3zqZTTeE7bTGHw)</span></span></span></span>

---

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2025-03/scaled-1680-/N0rkxy1VFePs1gBR-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2025-03/N0rkxy1VFePs1gBR-image.png)

<p class="callout info"><span style="font-weight: 400;">Команда Метабот очень просит своих клиентов указывать в описании сотрудничество, если это позволяет политика компании: **Сделано вместе с @MetabotBot**.</span></p>

- <span style="font-weight: 400;">**Edit Botpic** — м</span><span style="font-weight: 400;">еняет аватар аккаунта. </span><span style="font-weight: 400;">Отправьте фото. Не файл, а именно фото через телефон любого формата, размером не менее 150х150 пикселей - замена моментальная. Какое-то время у бота может показываться галерея предыдущих аватаров, но через день галерея автоматически сбросится и останется только последнее отправленное фото;</span>

[![метабот бот.png](https://docs.metabot24.ru/uploads/images/gallery/2025-03/scaled-1680-/aIXFUATwOLvx1TG7-metabot-bot.png)](https://docs.metabot24.ru/uploads/images/gallery/2025-03/aIXFUATwOLvx1TG7-metabot-bot.png)

- <span style="font-weight: 400;">**Edit Privacy Policy** — добавление кнопки с ссылкой на политику конфиденциальности бота</span><span style="font-weight: 400;"><span style="font-weight: 400;">. Отправьте публичный URL-адрес на политику конфиденциальности.</span></span>

<span style="font-weight: 400;">[![метабот бот.png](https://docs.metabot24.ru/uploads/images/gallery/2025-03/scaled-1680-/ljXUJHmkIkmDTbTu-metabot-bot.png)](https://docs.metabot24.ru/uploads/images/gallery/2025-03/ljXUJHmkIkmDTbTu-metabot-bot.png)</span>

- <span style="font-weight: 400;">**Edit Commands** — м</span><span style="font-weight: 400;">еняет системные команды бота (замена моментальная).</span>

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-10/scaled-1680-/zQ5TWodpmBJ05vbr-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-10/zQ5TWodpmBJ05vbr-image.png)

<span style="font-weight: 400;">Команды должны быть написаны латиницей, а описание можно написать кириллицей в формате:</span>

<table border="1" class="align-center" id="bkmrk-command1---descripti" style="border-collapse: collapse; width: 34.0746%; height: 42px;"><tbody><tr><td style="width: 100%;"><span style="font-weight: 400;">command1 - Description</span>

<span style="font-weight: 400;">command2 - Another description</span>

</td></tr></tbody></table>

<p class="callout warning align-left"><span style="font-weight: 400;">Если вы будете постепенно добавлять команды, то при создании новых, **не забудьте написать старые**. Порядок вашего написания будет напрямую влиять на отображение в боте.</span></p>

<p class="callout info align-left"><span style="font-weight: 400;">Для связи команд из botFather с платформой перейдите в маршруты. [Документация](https://docs.metabot24.ru/books/03-nastroika-botov/page/marsruty)</span></p>

<p class="callout warning"><span style="font-weight: 400;">Создайте маршрут бота, который будет вызывать скрипт по команде команды. **Регулярное выражение (код команды) должно быть написано с экранированием**.</span></p>

<p class="callout warning"><span style="font-weight: 400;">ВАЖНО: в маршруте с регулярным выражением подписи команды должен быть включен флаг **Действует в диалоге.**</span></p>

<span style="font-weight: 400;"><span id="bkmrk--25" style="font-weight: normal;"><span style="font-size: 14pt; font-family: 'Times New Roman', serif; color: #000000; background-color: transparent; font-weight: bold; font-style: normal; font-variant: normal; white-space-collapse: preserve;"><span style="border-width: initial; border-style: none; display: inline-block; overflow: hidden; width: 602px; height: 41px;">![](https://lh7-us.googleusercontent.com/sa6xDjqg2LZ3fOPjvW5AZYWu-PFbtngBrwwag85psJyM6J1X68VGLAVWN5XWbN7FKBL4jDPlZMHxVFAKxsn7s2VWPzcoKpYegDFcF9NcXl9z5jvPuyWKxxT_GeUxVB8GFPpdyEI45F0w0mJINVKEFQ)</span></span></span></span>

<span style="font-weight: 400;">Также можно добавить маршрут рестарта, для корректного реагирования бота, в случае остановки-перезапуска бота в настройках Telegram.</span>

[![image.png](https://docs.metabot24.ru/uploads/images/gallery/2024-10/scaled-1680-/6HJsn0OvXV6lf6HN-image.png)](https://docs.metabot24.ru/uploads/images/gallery/2024-10/6HJsn0OvXV6lf6HN-image.png)

### Блокировка канала

На платформе реализована реакция на событие **блокировки** бота в Telegram, если приходит событие блокировки, то автоматически блокируется лид, включается параметр **Отключение реакции боа на сообщения лида** и сбрасывается беседа лида.

Также на платформе реализована реакция на событие **разблокирования** бота в Telegram (событие перезагрузки бота), Если приходит событие разблокировки, то автоматически у лида выключается параметр **Отключение реакции боа на сообщения лида**.

Далее после получения вебхука с разблокировкой приходит вебхук с текстом **/start**.

### Mini App

Чтобы создать ссылку на Mini App следуйте шагам:

1\. Перейдите в BotFather Mini App  
2\. Выберите нужного бота из списка  
3\. Нажмите на Mini Apps  
4\. Нажмите на Create Direct Link  
5\. В url вставьте ссылку https://app.metabot24.com/forms/acrihin/instruments  
6\. Заполните полностью metadata  
7\. Ниже допишите адрес ссылки на МА  
8\. Нажмите Create