# Telegram

Telegram – бесплатный онлайн-мессенджер, одно из самых популярных мобильных приложений в мире.

## Что позволяет?

Данный канал позволяет полностью автоматизировать общение с клиентами.

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

### Подключение Савви к боту в Telegram

{% stepper %}
{% step %}
Для того, чтобы подключить Telegram к Вашему боту в Савви, требуется зайти в раздел "Каналы" и выбрать Telegram

<figure><img src="/files/BCJFJjR60BlNbtXm5DwM" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Видим поле, в котором нам требуется прописать токен. Токен — это уникальный идентификатор пользователя в Telegram. Он позволяет серверам определять запросы; шифрует доступ к боту канала, чтобы мошенники не получили его

<figure><img src="/files/ZedbkvofDDnu6tmEz1YL" alt="Скриншот настроек канала &#x22;Telegram&#x22; с выделенным полем &#x22;Токен&#x22;"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Чтобы получить токен, нужно в поисковой строке Telegram вбить [@BotFather](https://t.me/BotFather)

<figure><img src="/files/esni6ReZogzALTgmyKJe" alt="Скриншот приложения Telegram с открытым ботом BotFather. Начало диалога с ботом"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Нажав на кнопку Start мы получаем список команд, которые может выполнить этот бот. Если наша задача получить токен уже существующего бота, тогда нужно выбрать команду /token

<figure><img src="/files/ciRmwy17YxWR6B2J7X9w" alt="Скриншот диалога с ботом BotFather, указание на пункт /token"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
После того, как Вы получили токен в BotFather, пропишите его в поле Telergram и нажмите кнопку "Сохранить"

<figure><img src="/files/mguhAE8zZ2UvcWlcIZRJ" alt="Скриншот меню настроек канала Telegram, введённый токен, указание на кнопку &#x22;Сохранить&#x22;"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Далее перед нами появятся следующие настройки

<figure><img src="/files/sYUrNdto1mIs0SqrWvqI" alt="Скриншот настроек канала Telegram после подключения"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Если мы в поле Сообщение при команде **/start** зададим Приветствие, то бот всегда будет его прописывать при обращении клиента в боте **Telegram**, который уже подключен к Савви:

<figure><img src="/files/eFKKTBrIZaqI0Yx2OTMi" alt="Скриншот настроек канала Telegram после подключения, выделено поле &#x22;Сообщение при команде /start&#x22;"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Нажимаем **Сохранить**.
{% endstep %}
{% endstepper %}

### Подключение Савви к индивидуальной учётке

Вы имеете возможность подключить Савви к индивидуальной учётной записи в Telegram. Для этого есть определённое поле User ID.

<figure><img src="/files/CxXFDIN26uEzuFRUliT1" alt="Скриншот настроек канала Telegram после подключения, выделено поле &#x22;User ID (при подключении бизнес-аккаунта)&#x22;"><figcaption></figcaption></figure>

{% hint style="info" %}
31 марта 2024 года Telegram выпустил полезное обновление — возможность привязать чат-бота к бизнес аккаунту и вести общение бота с клиентами не только в режиме бота, но и когда пользователи пишут на привычный всем Telegram аккаунт.
{% endhint %}

НО: для этого нужен Telegram Premium.

{% stepper %}
{% step %}
Нужно отправить боту [@PremiumBot](https://t.me/PremiumBot) команду `/start`

<figure><img src="/files/GuHEQjNS7W3EE1GVArga" alt="Скриншот общения с ботом @PremiumBot, отправлена команда /start, получено сообщение с инвойсом на оплату Telegram Premium" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Далее, нужно выбрать и оплатить Telegram Premium на нужный вам срок
{% endstep %}

{% step %}
После того, как оплатили, то переходим в @BotFather и нажимаем `/mybots` и выбираем нужного бота

<figure><img src="/files/UXNWXK54gAYorqvCtZnU" alt="Скриншот из бота BotFather после отправки команды /mybots, выделен один из ботов" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Затем нужно выбрать Bot Settings

<figure><img src="/files/XF9EhTvJk8WiEumqQjrS" alt="Скриншот из бота BotFather после отправки команды /mybots и выбора бота, выделена кнопка &#x22;Bot Settings&#x22;" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Далее нажать Business Mode

<figure><img src="/files/X4VXNsNV9rKrUJgHhMPj" alt="Скриншот из бота BotFather после отправки команды /mybots, выбора бота и перехода в его настройки, выделена кнопка &#x22;Business Mode&#x22;" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Затем выбрать `Turn On`

<figure><img src="/files/ZyzqPvFxtt6sv1IQHzV7" alt="Скриншот из бота BotFather после отправки команды /mybots, выбора бота и перехода в его настройки, настройки Business Mode, выделена кнопка &#x22;Turn on&#x22;" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Далее нужно скопировать юзернейм бота

<figure><img src="/files/qr7kntbXDt8f3V5E2ENz" alt="Скриншот из бота BotFather после отправки команды /mybots, выбора бота и перехода в его настройки, настройки Business Mode и включения этого режима, выделен юзернейм бота" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Переходим к настройке **Telegram Business**

{% hint style="warning" %}
Убедитесь, что у вас установлено приложение Telegram самой последней версии.
{% endhint %}

Нужно перейти далее в настройки аккаунта

<figure><img src="/files/cc8j1Ks5nGTS7kfbUxtl" alt="Скриншот настроек Telergam на iOS, выделена кнопка перехода в настройки" width="332"><figcaption></figcaption></figure>

Нужно найти Telegram Business

<figure><img src="/files/7AbsvdsSOJqo7L4WDYNp" alt="Скриншот настроек Telergam на iOS, выделен пункт &#x22;Telegram для бизнеса&#x22;" width="330"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Далее надо перейти в раздел «Чат-боты»
{% endstep %}

{% step %}
В поле «@имя бота» пишем юзернейм нашего бота

<figure><img src="/files/LiYF6qgTT44azytpKalC" alt="Скриншот настроек Telergam на iOS, настроки для бизнеса, выделено поле с вводом юзернейма бота" width="554"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Нажимаем «Добавить»

<figure><img src="/files/LmTIZahxJB7WWfYnDxHv" alt="Скриншот настроек Telergam на iOS, настроки для бизнеса, в поле для юзернейма бота введен бот, выделена кнопка добавления бота" width="557"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Нажимаем «Готово»

<figure><img src="/files/ssiaTKv35Fnd1inzkroM" alt="Скриншот настроек Telergam на iOS, настроки для бизнеса, введен бот, выделена кнопка &#x22;Готово&#x22;" width="558"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Как узнать User ID, Bot ID, Group ID, Channel ID

**ID** — это уникальный номер, который используется для идентификации в Telegram. Он отличается от **@username,** которое можно изменять.

Чтобы узнать свой **User ID**, Bot ID, Group ID или Channel ID выполните следующие шаги:

1. В настройках канала Telegram, необходимо активировать флаг "Обрабатывать команду /get\_id".

<figure><img src="/files/6Cy9NBRUdB9m4E5FBcUd" alt=""><figcaption></figcaption></figure>

2. В чате с ботом отправьте команду /get\_id, после выполнения команды появятся кнопки для получения ID.

<figure><img src="/files/7akFA5Ue9p2Hk3w86gn8" alt=""><figcaption></figcaption></figure>

MY ID - позволяет получить свой ID\
USER ID - позволяет получить ID другого пользователя\
BOT ID - позволяет получить ID бота\
GROUP ID - позволяет получить ID группы\
CHANNEL ID - позволяет получить ID канала

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

### Настройка **чёрного** и **белого** списка пользователей по их **ID**

<figure><img src="/files/4VGP5dLv20uSYDZd0coz" alt="Скриншот настроек канала Telegram после подключения, выделены поля &#x22;Чёрный список&#x22; и &#x22;Белый список&#x22;"><figcaption></figcaption></figure>

Здесь Вы можете вписать **id** пользователей, кому бот не будет отвечать, либо **id** пользователей, кому бот будет отвечать (в этом случае бот будет отвечать исключительно выбранным пользователям).

### Режим ответов бота в группах

<figure><img src="/files/FhZoNCCwKo7W4u7SjAnY" alt="Скриншот настроек канала Telegram после подключения, выделен переключатель &#x22;Отвечать в группах только при упоминании&#x22;"><figcaption></figcaption></figure>

* Если флаг **Отвечать в группах только при упоминании** `❌выключен`, то бот будет отвечать на все сообщения в группе, где он подключен
* Если флаг **Отвечать в группах только при упоминании** `✅включен`, то бот будет отвечать только в том случае, если к Боту обратятся через упоминание: "**@my\_bot** *Привет*".

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

<figure><img src="/files/uCzMo4wtH3TDOS2t0czC" alt=""><figcaption></figcaption></figure>

### Проверка подписки на каналы

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

<figure><img src="/files/pjMDtUSkUNzp93a4We2h" alt=""><figcaption></figcaption></figure>

### Режим ответов бота в группах с темами

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

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

### Как узнать ID темы

Чтобы получить ID темы необходимо выполнить следующие шаги:

1. Кликните правой кнопкой мыши на одном из сообщений в теме, ID которой необходимо получить.

<figure><img src="/files/qiAIvpMrV9RdKH8s6wzn" alt="" width="312"><figcaption></figcaption></figure>

2. Вы получите ссылку в следующем формате:

<figure><img src="/files/cytBMFwmqtM1cknSbDDn" alt=""><figcaption></figcaption></figure>

3. Необходимо взять обведенную часть и прибавить к ней -100.

<figure><img src="/files/IukXXiNZw56agmtlgq4n" alt=""><figcaption></figcaption></figure>

В данном примере ID будет -1002460154739/12

### Режим ответов бота в каналах

Настройка ответов бота при упоминании, при использовании ключевых слов и проверка подписки аналогична Пункту 9.

Очистка контекста на команду **/start**.

<figure><img src="/files/jbifrgCkPHVRpU5Aix0i" alt="Скриншот настроек канала Telegram после подключения, выделен переключатель &#x22;Очищать контекст по команде /start&#x22;"><figcaption></figcaption></figure>

Данная настройка особенно полезна при тестовых диалогах. При вводе в ТГ-бот команды **/start** контекст диалога полностью очищается и можно начинать новый диалог.

Пометка о прочтении у бизнес-ботов

<figure><img src="/files/05i0nIwvxgcherne49jc" alt="Скриншот настроек канала Telegram после подключения, выделен переключатель &#x22;Пометка о прочтении у бизнес-ботов&#x22;"><figcaption></figcaption></figure>

Если Вы хотите, чтобы сообщения в бизнес боте отмечались, как **прочитанные**, то в настройках бизнес бота выдайте разрешение - "**Чтение сообщений**"

В настройках **Савви** включите "**Пометка о прочтении у бизнес ботов**"

## Кнопки в Telegram

{% hint style="warning" %}
Кнопки Савви для Telegram являются **программируемыми (динамическими)**, а не статическими. Они не отображаются в чате Telegram-бота сразу после создания действия в Савви. Кнопки появляются в ходе диалога при вызове соответствующей функции в месте, предусмотренном промптом/инструкцией.

**Пример инструкции:**

**#РАБОТА С ФУНКЦИЯМИ**

* В начале диалога вызвать функцию **send\_telegram\_message()**.
  {% endhint %}

Настроить кнопки можно через создание действия. Добавление кнопок позволит расширить взаимодействие клиента с ботом.

Настройка:

1. Перейдите на вкладку **"Действия"** и нажмите кнопку **"Добавить"**.

<figure><img src="/files/trohcIr2hJOuC8NfhVKD" alt=""><figcaption></figcaption></figure>

2. Выберите действие **"Кнопки в Telegram"**. Процедура добавления данного действия аналогична добавлению других действий.

<figure><img src="/files/G0bc3o1XoiphJWbS51qz" alt=""><figcaption></figcaption></figure>

3. Переходим к настройке шага.

<figure><img src="/files/tOHY8ypuYTeBzrAUniGi" alt=""><figcaption></figcaption></figure>

Доступно **3 варианта** шага:\
**1.** **Добавить кнопки внизу экрана** - внизу экрана в интерфейсе мессенджера будет добавлено заданное количество кнопок с выбранными функциями.\
**2**. **Добавить кнопки под сообщением** - кнопки добавляются после определенного сообщения бота.\
**3.** **Убрать кнопки внизу экрана** - функция позволяет убрать кнопки, которые были добавлены при выборе **Варианта 1**.

#### **Добавить кнопки внизу экрана**

**Параметры клавиатуры**.

Задают поведение клавиатуры при взаимодействии с ней.

<figure><img src="/files/Pzx0zJjFQFb8Z6eB86Pv" alt=""><figcaption></figcaption></figure>

**Принудительно показывать** - запускает принудительный показ кнопок.\
**Подгонять высоту** - адаптирует размер кнопок.\
**Скрывать после использования** - после использования одной из кнопок, панель с кнопками убирается.\
**Показывать подсказку, когда кнопки на экране** - при активации появится поле, в которое Вы можете внести текст подсказки, когда кнопки показаны на экране.

**Добавление кнопки**

1. Для добавления кнопки нажмите на "+"

<figure><img src="/files/GTm56FX9ZMuPsBOT3RBA" alt=""><figcaption></figcaption></figure>

2. Настройка кнопки

<figure><img src="/files/7nnlPbyThKhgIAIBYZhr" alt="" width="303"><figcaption></figcaption></figure>

Вы можете выбрать **1 из 4 типов кнопки**:\
**Отправить сообщение** - отправляет в чат заданный текст, это может быть текст информационного характера, ссылка, либо ключевая фраза, по которой бот выполнит другое действие, в последнем случае мы исключаем ожидание этого слова от пользователя, если есть необходимость завязать дальнейшие действия бота на ключевом слове, использование кнопки в этом случае будет эффективней.\
**Запрос контакта** - позволяет отправить в чат имя, фамилию, указанные в профиле и номер телефона пользователя, может быть удобным при сборе информации о пользователе и заполнения базы данных, либо бронирования услуги.\
**Запрос местоположения** - в чат отправляются координаты и адрес пользователя, вариантом использования могут быть контекстные действия бота в зависимости от геолокации пользователя, например, выбор ближайшего филиала, либо приблизительный расчет доставки, времени ожидания сотрудника.\
**Открыть мини-приложение** - позволяет открыть любую подходящую под требованию ссылку в формате мини-приложения и быстро просмотреть, таким образом клиент может ознакомиться с Вашим сайтом, либо информации об услугах и акциях без необходимости переходить в браузер.

{% hint style="warning" %}
Обратите внимание, что при создании кнопки с функцией открытия ссылок в формате мини-приложения, можно добавить только ссылки с протоколом https.
{% endhint %}

<figure><img src="/files/gTyndu8kwXxRUDcc8fRX" alt=""><figcaption></figcaption></figure>

Для каждой кнопки можно задать уникальное название.

#### **Добавить кнопки под сообщением**

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

<figure><img src="/files/oOtr2xpYiI2YXw0CDQl4" alt="" width="307"><figcaption></figcaption></figure>

Для этого типа кнопок доступно **2 варианта**:\
**1**. **Скопировать текст** - позволяет добавить текст, который будет скопирован при клике, можно задать, например, личный промо-код, либо ссылку на сайт.\
**2**. **Открыть ссылку** - позволяет привязать к кнопке ссылку, которая будет открыта при клике по кнопке.

<figure><img src="/files/rwNGfqq6TpmxQKokPefV" alt=""><figcaption></figcaption></figure>

#### **Убрать кнопки внизу экрана**

Данный вариант шага не имеет специфических настроек. Запуск действия с таким шагом удаляет ранее созданные кнопки внизу экрана.

#### Задание функции удаления:

На вкладке **"Условия срабатывания"** необходимо задать имя функции, по которой будет запускаться действие.

{% hint style="warning" %}
Всегда следует задавать название функции таким образом, чтобы выбранное слово или фраза описывали само действие. Описание должно быть максимально точным. Соблюдение этих правил позволит добиться стабильной работы действия.
{% endhint %}

В инструкции необходимо прописать условие срабатывания и название функции, для примера представим, что функция называется **delete\_button**:

```
Когда клиент прислал свои данные, вызови функцию delete_button.
```

#### Задание аргументов и констант

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

{% hint style="warning" %}
После того, как аргумент или константа созданы, их необходимо добавлять через кнопку в виде шестеренки.
{% endhint %}

#### Дополнительные настройки

Блок настроек аналогичен другим действиям.

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

## Стартовый параметр

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

Стартовый параметр сохраняется в поле *start\_parameter*. Он может быть передан либо в ссылке на бота, например:

```
https://t.me/example_bot?start=link123
```

Либо он может быть введен непосредственно после команды /start:

```
/star link123
```

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

<figure><img src="/files/rXoEo8aW8X07hAPB1XXO" alt=""><figcaption></figcaption></figure>

Удобно взаимодействовать со стартовым параметром, либо другими параметрами из плейсхолдера, используя запуск по [триггеру](/ru/deistviya/vyzov-deistvii-po-triggeru.md).

Рассмотрим на примере получения аналитических данных в кабинете Савви. Для этого необходимо настроить действие **"Базовый шаг"**.

1. Добавьте действие **"Базовый шаг"**. Выберите запуск по триггеру. Установите параметры, указанные на скриншоте.

<figure><img src="/files/jatfpCrM7EOgEU1LYp9N" alt=""><figcaption></figcaption></figure>

2. Установите в действии нужный Вам тег.

<figure><img src="/files/54iuG184ZA12zpFOwbDC" alt=""><figcaption></figcaption></figure>

При выполнении условий, действие в диалоге будет выполнено, и тег проставлен. Бот при этом будет вести диалог, как обычно,- выполнение этого действия не влияет на ведение диалога ботом.

В разделе **"Аналитика"**, Вы сможете посмотреть статистику по тегам.

<figure><img src="/files/HoQ5xNSXPmp7SwMaaAa4" alt=""><figcaption></figcaption></figure>

## Выключение ответов бота

Если Вам по каким-то причинам требуется на время отключить ответы бота в Telegram, то необходимо выключить флаг **"Ответы бота"**.

<figure><img src="/files/w9BNqqqlEp8d0Zwbt9Ia" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.suvvy.ai/ru/kanaly/messendzhery/telegram.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.