# Интеграция Уведомления в Telegram

{% hint style="warning" %}
**Внимание!** Данная интеграция предназначена для взаимодействия бота Senler с ботом Telegram, в частности, для отправки уведомлений.
{% endhint %}

{% hint style="info" %}
**Заявление об ограничении ответственности.**

Данная интеграция является ознакомительной и находится на стадии бета-тестирования.

Доступ к услуге предоставляется в режиме - как есть.

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

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

Код интеграции свободен и доступен по адресу:

<https://github.com/SenlerBot/senler_telegram_notify>
{% endhint %}

{% hint style="info" %}
**Заявление о хранении и обработке персональных данных.**

Интеграция не собирает и не хранит никаких данных ваших пользователей.

Обработка данных производится на территории РФ с использованием:

<https://cloud.yandex.ru/services/functions>
{% endhint %}

### Возможный кейс использования

Отправка необходимых данных лида при определённых событиях, происходящих в боте Senler, в Telegram-бота.

### Как работает интеграция

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

### Инструкция по использованию

1\. **Установка интеграции "Уведомления в Telegram"**

Первым делом необходимо установить интеграцию "Уведомления в Telegram" в вашем личном кабинете Senler. Для этого:

1. Перейдите в раздел **Интеграции**.
2. Найдите и установите интеграцию **"Уведомления в Telegram"**.

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FM6KEH12IwVGenruwfvFC%2Fimage.png?alt=media&#x26;token=789c3d12-5381-45ff-9c0c-eee406235eec" alt=""><figcaption><p>Установка интеграции "Уведомления в Telegram"</p></figcaption></figure>

#### 2. Настройка интеграции в чат-боте <a href="#a46fbc42-7024-4ccb-a963-d4d8ec600c83" id="a46fbc42-7024-4ccb-a963-d4d8ec600c83"></a>

После установки интеграции:

1. Перейдите в чат-бота, где планируете использовать интеграцию.
2. Создайте новый шаг с интеграцией "Уведомления в Telegram". Это можно сделать через контекстное меню или нажав на кнопку “+”.

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FYAKeePftGy4Y9COmqpxi%2Fimage.png?alt=media&#x26;token=7ae8707e-138a-4de3-93cf-b89cfa210914" alt=""><figcaption><p>Создание шага с интеграцией "Уведомления в Telegram"</p></figcaption></figure>

#### 3. Настройка шага с интеграцией <a href="#id-18993de8-f173-4422-84db-033796bce4dc" id="id-18993de8-f173-4422-84db-033796bce4dc"></a>

В настройках шага с интеграцией необходимо ввести следующие значения:

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FdBbv9B2KkTx275rJIq9d%2Fimage.png?alt=media&#x26;token=005e4281-5df6-48ba-bdd4-6579d913b075" alt=""><figcaption><p>Приватные настройки</p></figcaption></figure>

1. **Введите токен бота**

Введите токен вашего бота в Телеграм. О том, как его получить, подробно описано в инструкции ниже:

{% content-ref url="broken-reference" %}
[Broken link](https://help.senler.ru/senler/kanaly/vkontakte/integracii/broken-reference)
{% endcontent-ref %}

{% hint style="warning" %}
**Важно:** Для работы данной интеграции необходим новый бот, созданный в BotFather. Боты, созданные ранее и подключённые к другим сервисам, могут не подойти.
{% endhint %}

2. **Введите chatID**

Введите chatID вашего Telegram-чата. О том, как его получить, подробно описано в инструкции ниже:

{% content-ref url="../../../help/faq/obshie-voprosy/poluchenie-identifikatorov-id-sushnostei-ispolzuemykh-v-telegram" %}
[poluchenie-identifikatorov-id-sushnostei-ispolzuemykh-v-telegram](https://help.senler.ru/senler/help/faq/obshie-voprosy/poluchenie-identifikatorov-id-sushnostei-ispolzuemykh-v-telegram)
{% endcontent-ref %}

{% hint style="warning" %}
**Внимание!** Чтобы бот в Telegram мог отправлять вам сообщения, заранее запустите этого бота.
{% endhint %}

3. **Добавление авторизационных данных**

После ввода токена и chatID нажмите кнопку **Add**.

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FNOwjqbkoM2tmBwbCpX8X%2Fimage.png?alt=media&#x26;token=a3c47524-b940-4700-a742-a00d2670360d" alt=""><figcaption><p>Добавление вашего бота Telegram в настройках шага с интеграцией</p></figcaption></figure>

Если данные введены корректно, в окне отобразится информация о ваших авторизационных данных.

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2F1vWjc3n6rqAw5EEmzxqb%2Fimage.png?alt=media&#x26;token=8316c0f8-81df-459b-8f03-7a5619c3153b" alt=""><figcaption><p>Добавленные данные в шаге с интеграцией</p></figcaption></figure>

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

#### 4. Настройка текста уведомления <a href="#id-3f69a3ff-76df-48b8-93dd-201219f28e1b" id="id-3f69a3ff-76df-48b8-93dd-201219f28e1b"></a>

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

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FyAxajvC3LrxYvJNiucVD%2Fimage.png?alt=media&#x26;token=dfc59ab9-bbb2-4485-8615-cc52855d3a79" alt=""><figcaption><p>Поле ввода текста уведомления в настройках шага с интеграцией</p></figcaption></figure>

> Например, если подписчик оставил номер телефона, вы можете отправить уведомление менеджерам с этим номером.

#### 5. Пример использования <a href="#e0ba0636-da77-43bb-9039-3dc84c803784" id="e0ba0636-da77-43bb-9039-3dc84c803784"></a>

Создайте схему чат-бота, в которой после получения определённой информации от пользователя (например, номера телефона) следует шаг с интеграцией "Уведомления в Telegram".

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2F4voFnyXLCfOXwiMbHU0K%2Fimage.png?alt=media&#x26;token=100ecdb8-c93b-4fcf-ae50-c29c73bb859d" alt=""><figcaption><p>Пример использовании интеграции в схеме бота</p></figcaption></figure>

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

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2Fff6UXK0jPcz2FXycOxlj%2Fimage.png?alt=media&#x26;token=ae245fe7-e973-4cb4-8c96-4ccbe040b6aa" alt=""><figcaption><p>Указанный текст уведомления в настройках шага с интеграцией</p></figcaption></figure>

#### 6. Результат работы интеграции <a href="#id-4e5903a3-dd75-4709-a245-3037fb1d670b" id="id-4e5903a3-dd75-4709-a245-3037fb1d670b"></a>

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

<figure><img src="https://3357342088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZN10WvcXgl30afEjLBp4%2Fuploads%2FtdzCkeACumOGZABIPGQb%2Fimage.png?alt=media&#x26;token=f4492290-02d2-40fd-8c0f-e818bb9d2bb0" alt=""><figcaption><p>Уведомление в Telegram</p></figcaption></figure>

### Как запустить самостоятельно

Любой желающий может запустить интеграцию самостоятельно. Для этого потребуется аккаунт в облачном провайдере (например, Yandex Cloud) и базовые технические навыки.

**Преимущества самостоятельного запуска:**

* **Полный контроль:** Весь программный код будет выполняться в ваших учетных записях облачного провайдера.
* **Отсутствие конкуренции:** Интеграция не будет конкурировать с другими участниками сервиса.
* **Индивидуальные лимиты:** Все лимиты провайдера будут только в вашем распоряжении.

Код приложения оптимизирован для размещения на Yandex Function. У данной услуги есть бесплатный тариф в 1 миллион запусков в месяц, чего достаточно для большинства сценариев.

{% embed url="<https://youtu.be/103Z-1cxsM4>" %}
Наглядный пример самостоятельного запуска интеграции
{% endembed %}