# Telegram

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

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FO7TF7f3TbXwIl0QDU7KV%2FTelegram_1.jpg?alt=media&#x26;token=6e2c5700-b0de-4587-8447-5542bb2187f9" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FNxtyu1iu1gPR7Xp7fbLy%2Fimage.png?alt=media&#x26;token=80c6f1be-d7f6-4657-8c5e-09c97b975c88" alt="Скриншот настроек канала &#x22;Telegram&#x22; с выделенным полем &#x22;Токен&#x22;"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F9bwmSrl02fAlWeLFEMSh%2FPic4.png?alt=media&#x26;token=a74ade6e-b6e9-45cd-82e3-896d3a5c2ea4" alt="Скриншот приложения Telegram с открытым ботом BotFather. Начало диалога с ботом"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FepZ0caZQO02HueAxpJ0q%2Fic5.png?alt=media&#x26;token=54619cf3-da64-4f14-9c97-822891d22b68" alt="Скриншот диалога с ботом BotFather, указание на пункт /token"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FHmwkazjcfvFn9twjpeoz%2Fimage.png?alt=media&#x26;token=fa3a536a-463d-4237-9d15-7e1ca354fd00" alt="Скриншот меню настроек канала Telegram, введённый токен, указание на кнопку &#x22;Сохранить&#x22;"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F18Wf4vmbqsyBjbnhbHvj%2Fimage.png?alt=media&#x26;token=4efb3cfe-129a-41fb-b979-678a640490a9" alt="Скриншот настроек канала Telegram после подключения"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FqRzAKcHJxA9zIUqDi5Tb%2Fimage.png?alt=media&#x26;token=70512afc-2db9-4310-98dc-e944a2a3f9ab" alt="Скриншот настроек канала Telegram после подключения, выделено поле &#x22;Сообщение при команде /start&#x22;"><figcaption></figcaption></figure>
{% endstep %}

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FBJfgph45dU9UeBMV4rrZ%2Fimage.png?alt=media&#x26;token=d6574d04-981d-4307-80eb-fe979b2db5f3" 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="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FHVk07rWA3wiHd8JpHOvo%2FScrin1.png?alt=media&#x26;token=47cc958e-802b-4953-a301-4b37e6d62ade" alt="Скриншот общения с ботом @PremiumBot, отправлена команда /start, получено сообщение с инвойсом на оплату Telegram Premium" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FNU9mSMnSBn2I24gVlTNX%2FScrin2.png?alt=media&#x26;token=1c2767e3-66c9-4d8f-ba34-57d0bf7463ee" alt="Скриншот из бота BotFather после отправки команды /mybots, выделен один из ботов" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FxPOT6jPOqXwAczIyWTBA%2FScrin3.png?alt=media&#x26;token=fad93958-b7f6-4e88-8d6a-6ece2dd7b2ac" alt="Скриншот из бота BotFather после отправки команды /mybots и выбора бота, выделена кнопка &#x22;Bot Settings&#x22;" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FnxdmIo1zR0WoCin6lZK5%2FScrin4.png?alt=media&#x26;token=faa28edc-f25a-4780-bc1d-4a873cd9540e" alt="Скриншот из бота BotFather после отправки команды /mybots, выбора бота и перехода в его настройки, выделена кнопка &#x22;Business Mode&#x22;" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FtVkSVaF0teXaS5db4ZNv%2FScrin5.png?alt=media&#x26;token=5f1dfb2b-ba50-4dd8-a904-fd81223b1f54" alt="Скриншот из бота BotFather после отправки команды /mybots, выбора бота и перехода в его настройки, настройки Business Mode, выделена кнопка &#x22;Turn on&#x22;" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FKMDefj45ATSACnyPJbQn%2Fcrin7.png?alt=media&#x26;token=baf6b1c3-011e-424e-a386-d25fb5417529" alt="Скриншот из бота BotFather после отправки команды /mybots, выбора бота и перехода в его настройки, настройки Business Mode и включения этого режима, выделен юзернейм бота" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FQ2DEkYLv2Fpse6ylCSaA%2FPicccc.png?alt=media&#x26;token=8fa67f6f-f3d5-4043-9b3f-4555ced79363" alt="Скриншот настроек Telergam на iOS, выделена кнопка перехода в настройки" width="332"><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FDRnbgA7XsVTwk55dW7bs%2F%D0%A0%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB%20%D0%91%D0%B8%D0%B7%D0%BD%D0%B5%D1%81.png?alt=media&#x26;token=a808b636-b7be-48bb-a5f8-7d37933f4a33" alt="Скриншот настроек Telergam на iOS, выделен пункт &#x22;Telegram для бизнеса&#x22;" width="330"><figcaption></figcaption></figure>
{% endstep %}

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FsNaM0zVbAtRLckX0RvtM%2F%D0%9F%D0%B8%D0%BA%D1%815.png?alt=media&#x26;token=7b2daeae-6d88-47b3-b98c-ece67bd50d0a" alt="Скриншот настроек Telergam на iOS, настроки для бизнеса, выделено поле с вводом юзернейма бота" width="554"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FNxkPSroEq9PCCJdItd8Y%2FGbrc6.png?alt=media&#x26;token=49c320ca-1f89-4ac1-b113-66dfebadd739" alt="Скриншот настроек Telergam на iOS, настроки для бизнеса, в поле для юзернейма бота введен бот, выделена кнопка добавления бота" width="557"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FpgQyw6HiRwptHu1Y8Alp%2FDone.png?alt=media&#x26;token=8fbd5d48-0cd9-49db-9473-9d66e72031f2" 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="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FBfW6tsHUrfW9x472CncK%2Fimage.png?alt=media&#x26;token=892a9973-665e-402b-a41f-9dc7d878aa97" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F9Uv8aKSM0NZm7TcXvr1S%2Fimage.png?alt=media&#x26;token=fd95cded-4c20-4f91-9926-cf941311c338" 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="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F18pvqLUFXGj8DC3UqpwP%2Fimage.png?alt=media&#x26;token=aef12c5f-4896-418f-a3f7-06e707c31df5" alt="Скриншот настроек канала Telegram после подключения, выделены поля &#x22;Чёрный список&#x22; и &#x22;Белый список&#x22;"><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FmydXoHZa2cOO2oyKxZtM%2Fimage.png?alt=media&#x26;token=12f0ad70-5fa2-49c4-a890-b4fa8242ea68" alt="Скриншот настроек канала Telegram после подключения, выделен переключатель &#x22;Отвечать в группах только при упоминании&#x22;"><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fei6qmTZcxeGIb4n1urHL%2Fimage.png?alt=media&#x26;token=1877460c-81d4-42a8-888f-24e5a70135a0" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F5zRXUD891v7NvqxksfJH%2Fimage.png?alt=media&#x26;token=84ff8c6f-f872-4877-ad30-18dfe179ef54" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FMyy0d9y9qQI7hdwNjOMO%2Fimage.png?alt=media&#x26;token=b7164972-04a4-4642-9b52-5bbf58179bec" alt="" width="312"><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FFNO6LtaKeegZW1bLYjpR%2Fimage.png?alt=media&#x26;token=1e6882c4-7f5c-495f-819a-f69b0bb4d31b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fzx1DYLOwL0tAqRgj3QfR%2Fimage.png?alt=media&#x26;token=4c66e8b0-e77b-4e5e-a1c1-e78ebe124d30" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FNcj79iMyRNEJe2b2X6cn%2Fimage.png?alt=media&#x26;token=b8a91922-53e3-422e-b553-27db4cbf8cef" alt="Скриншот настроек канала Telegram после подключения, выделен переключатель &#x22;Очищать контекст по команде /start&#x22;"><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FAD2e7cTLy1BYFk2M2ndb%2Fimage.png?alt=media&#x26;token=1b9dc8fa-6c62-4002-8bbc-dfe732ab70c6" alt="Скриншот настроек канала Telegram после подключения, выделен переключатель &#x22;Пометка о прочтении у бизнес-ботов&#x22;"><figcaption></figcaption></figure>

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

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

## Кнопки в Telegram

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

**Пример инструкции:**&#x20;

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

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

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

Настройка:

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fz3Vo48fPdWLzMGargZNq%2FPasted%20image%2020250831220125.png?alt=media&#x26;token=4c953c2f-dd2c-4c8a-a57d-87de48258e63" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F4ymLA7o8PE4fFadwq6pf%2FPasted%20image%2020250831220231.png?alt=media&#x26;token=23e20557-c50b-40c6-8745-5fdd4c7b272f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FgUGud5MyCJERFOSVYTYS%2FPasted%20image%2020250831223004.png?alt=media&#x26;token=022f113f-7972-4417-9edf-d56bdba227c7" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FfL4hOCDnWlJYqELxHl3P%2FPasted%20image%2020250831224512.png?alt=media&#x26;token=ee419b61-26ce-43f9-ae69-380b87c04633" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FnDdpTAAzEdsA1ZJDwJvF%2FPasted%20image%2020250831225119.png?alt=media&#x26;token=5b14ba1a-bdae-4e63-85ad-cdd67b79f77f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fn6CcQCZfhKFcKSxpyCOB%2FPasted%20image%2020250831225925.png?alt=media&#x26;token=d981a4fe-19c2-4ae6-b531-5978e8dd1cc1" alt="" width="303"><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FOmTCKsu11YamAMGt1nMO%2Fimage.png?alt=media&#x26;token=1c47b9f8-b926-41cc-9b36-b7487f6b030a" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fmt8gkGtU7eV862e64NOE%2FPasted%20image%2020250831231128.png?alt=media&#x26;token=ce3ebf15-9d90-42df-8037-ea82b7952e6b" alt="" width="307"><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FfW3hPZ0ZZuJdljtegUC6%2Fimage.png?alt=media&#x26;token=07f5fa0c-048e-4dc4-a847-142cce212a6e" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

```
/star link123
```

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FcFwupTNdkwcWlD3SwyAn%2FPasted%20image%2020260120170455.png?alt=media&#x26;token=345b4362-f7a0-4f91-a8f8-39d912172d0d" alt=""><figcaption></figcaption></figure>

Удобно взаимодействовать со стартовым параметром, либо другими параметрами из плейсхолдера, используя запуск по [триггеру](https://docs.suvvy.ai/ru/deistviya/vyzov-deistvii-po-triggeru).&#x20;

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FCtCuxCR1DL9YR5xtgHTc%2FPasted%20image%2020260120170950.png?alt=media&#x26;token=dc55a656-5626-40cb-be58-82b3c66e8b1d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FqRq9v64qkOt54mvJWev6%2FPasted%20image%2020260120171113.png?alt=media&#x26;token=def00373-4d1a-469f-be7a-06a75fed686c" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Ff2P2223QEgCaPgAUN9qq%2Fimage.png?alt=media&#x26;token=d6cbd2c0-f31d-47f6-ae4a-c7f021a8aedc" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fsym5hXqOqBL65R1F8vtY%2Fimage.png?alt=media&#x26;token=a3a30aff-757d-473a-92d3-7735b745fb55" alt=""><figcaption></figcaption></figure>