> For the complete documentation index, see [llms.txt](https://premium.gitbook.io/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://premium.gitbook.io/main/osnovnye-nastroiki/uvedomleniya-administratoram-i-klientam/uvedomleniya-v-telegram.md).

# Уведомления в Telegram

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

{% hint style="warning" %}
Вы находитесь в инструкции для создания телеграм-бота для уведомлений клиентов по заявкам — если же вам нужна инструкция для создания бота для обмена, воспользуйтесь [инструкцией](https://premium.gitbook.io/main/osnovnye-nastroiki/telegram-bot-dlya-obmena) для другого раздела.
{% endhint %}

{% hint style="warning" %}
Для корректной работы бота уведомлений требуется:

* В настройках доп. поля "**Telegram**" обязательно выбран пункт "**Telegram**" для поля "**Автозаполнение**"\
  ![](https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2FZD5fuoO1lyEEh8hpDv1F%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=f258feac-005d-4bf8-929b-c1693037153d)
* У пользователя должен быть добавлен юзернейм из Телеграм в ЛК в вашем обменнике\
  ![](https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2FDDHgkcrTy0Av3LShdPub%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=43f22d51-552c-42df-9687-dd906af5e9f0)
* Пользователь должен активировать вашего бота для уведомлений командой `/start` и получить от него ответ\
  ![](https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2FhDfBJvt9J6czR5OL5Elj%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media\&token=28d75871-83c9-4311-9637-033f7708053a)
  {% endhint %}

{% hint style="warning" %}
Обратите внимание, что шаблоны для **администраторов** и **пользователей** в выпадающем списке являются отдельными сущностями и настраиваются независимо друг от друга (пункты в выпадающем списке)

<img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-2c7b1fd82f0ad4d5b3334c7edb2b13f4488ec719%2Fimage.png?alt=media" alt="" data-size="original"><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-282540c41322e0363cfbb15731960f29c1522f5f%2Fimage.png?alt=media" alt="" data-size="original">
{% endhint %}

## Настройки

1. В Telegram отправьте пользователю [@BotFather](https://t.me/BotFather) сообщение **/newbot** и следуйте инструкциям по созданию бота. После успешного создания бота, отобразится token - скопируйте его в буфер обмена. Другие настройки бота изменять не нужно.
2. В панели управления сайтом (раздел "**Telegram**" ➔ "**Настройки**") в поле "**Token**" укажите токен, который был получен во время создания бота.

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-cf74889647654210156a9faa111443d5cd40a5d1%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Настройки</strong>"</p></figcaption></figure>

{% hint style="info" %}
Если раздел Telegram не отображается в боковой панели - включите модуль в разделе "Модули":

<img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-deeb22e60ae35adb3cdff41393d2e5370cfb153f%2Fimage.png?alt=media" alt="" data-size="original">
{% endhint %}

3. При необходимости логирования действий бота и последующего просмотра логов в разделе "**Telegram**" ➔ "**Лог сообщений**", активируйте следующие опции

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-96d8cd7124625c43e6e005342ed6201df006ec89%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Лог сообщений</strong>"</p></figcaption></figure>

4. В нижней части раздела "**Telegram**" -> "**Настройки**" перейдите по ссылке для регистрации вебхука.

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-dfde8d7dd580fd2cbfac1175589005d93c5b8073%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Настройки</strong>"</p></figcaption></figure>

5. При необходимости пропишите текст сообщений для пользователей бота.

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-3a0163028cde1bc0caa4d4bc5cabfd2a2c44719f%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Настройки</strong>"</p></figcaption></figure>

6. В разделе "**Пользователи**" в профиле вашего пользователя укажите ваш Username из Telegram без @ (если Username отсутствует, то его необходимо задать в настройках Telegram)

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-6bd07bcc25e5901a72a8f60361331f0ae761e617%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Настройки</strong>" в Telegram</p></figcaption></figure>

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-f2f8ca2b4bbee9ff6963888e0330f5ba44c8c450%2Fimage%20(1235).png?alt=media" alt=""><figcaption><p>Раздел "<strong>Пользователи</strong>" -> "<strong>Редактировать</strong>"</p></figcaption></figure>

7. Активируйте бота, отправив ему сообщение **/start** в Telegram.
8. В разделе "**Сообщения" → "Тelegram шаблоны"** настройте необходимые шаблоны для различных статусов заявок и других опций для отправления сообщений от имени бота администраторам и пользователям:

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-28dc121aa06ef260723f2ca588c1a14e1f890c1f%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Сообщения" → "Тelegram шаблоны"</strong></p></figcaption></figure>

{% hint style="warning" %}
Еще раз обращаем ваше внимание, что шаблоны для **администраторов** и **пользователей** в выпадающем списке являются отдельными сущностями и настраиваются независимо друг от друга (пункты в выпадающем списке).

<img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-9af77728ce597c895f94c30c8b8af725d8a51fd8%2Fimage.png?alt=media" alt="" data-size="original"><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-cfcffe5f5d1aff7f2f80f9ff95d5513a7f3c92d4%2Fimage%20(2258).png?alt=media" alt="" data-size="original">
{% endhint %}

{% hint style="success" %}
Начиная с версии 2.6 также можно отправлять сообщения только тем контактам, что указаны в настройках направления обмена, вкладка "**Настройки уведомлений**".

Добавлена возможность указать персональные **e-mail/аккаунт в telegram/номер телефона** для получения уведомления о заявке в этом направлении администратору/оператору (если одно или несколько полей для контактов заполнены, передача данных из шаблона выше будет осуществляться **только на указанные контакты**, игнорируя список администраторов в общем шаблоне для уведомлений).

<img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-00607074b9ba620a9f3d270c71447da05213b1fc%2Fimage.png?alt=media" alt="" data-size="original">
{% endhint %}

Настройки шаблона:

* **Отправлять**: "Да" — отправляем сообщения, "Нет" — не отправляем.
* **Telegram username администратора (без @)** — username администратора, на который он будет получать уведомления. Через запятую можно указать несколько username, если у вас несколько администраторов.
* **Текст** — текст отправляемого сообщения. Над полем для ввода текст, вы найдете панель с \[шорткодами]. Используйте их в тексте письма и в заголовке письма, чтобы в отправляемых сообщениях отображались данные из заявок.

9. Для того чтобы использовать бота, необходимо добавить дополнительное поле "Телеграм" в каждое направление обмена, которое будет использовать бота.

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-4de3e054070c10d04aab5700533ce6f707377c57%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Направления обменов</strong>" -> "<strong>Доп. поля</strong>"</p></figcaption></figure>

Это необходимо для того, чтобы на странице обменника в направлениях обмена отображалось поле для ввода Username пользователем обменника

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-1f38879f1fba09faa71d2a322e20f8c58a988ef0%2Fimage.png?alt=media" alt=""><figcaption><p>Страница обмена</p></figcaption></figure>

10. Для того, что использовать бота, пользователь обменника может указать свой Username в Telegram в настройках профиля (при этом он будет автоматически подставляться в поле "Телеграм", если оно будет присутствовать при создании заявки (набор полей определяется администратором для каждого направления индивидуально)) или при создании каждой заявки указывать Username вручную.

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-d47a8623b1c9e9eaab7488915da606007023a70c%2Fimage.png?alt=media" alt=""><figcaption><p>Личный кабинет пользователя в обменнике</p></figcaption></figure>

{% hint style="info" %}
По умолчанию администраторам сообщения не отправляются, если администратор сам меняет статус заявки в админке (раздел "**Заявки**") - если вам необходимо, чтобы сообщения всегда отправлялись администратору, эту опцию необходимо активировать в разделе "**Настройки обменника**" -> "**Основные настройки**" -> "**Другие настройки**", пункт "Отправлять email админу, если админ сам меняет статус заявки".

<img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-8651a3927ccf62e9a367f93d4829d5a5e0791aa1%2Fimage%20(833).png?alt=media" alt="" data-size="original">
{% endhint %}

{% hint style="warning" %}
Для того, чтобы получать уведомления в Telegram - каждому пользователя **обязательно** нужно "стартовать" бота на своём аккаунте
{% endhint %}

## Диагностика неисправностей

**Примечание для администраторов обменника:**\
Чаще всего клиенты забывают запустить бота Telegram — из-за этого они не получают уведомления. Чтобы этого избежать, в шаблон Telegram-уведомления (например, “**Новая заявка**”) рекомендуется добавлять инструкцию:\
“Для получения уведомлений по заявке, пожалуйста, сначала перейдите в нашего Telegram-бота и нажмите **\Start.**”. Без активации бота с помощью этой кнопки Telegram не позволяет отправлять сообщения от имени бота клиенту.

Если пользователям или администраторам не приходят или перестали приходить сообщения от бота - загляните в раздел "**Telegram**" -> "**Лог сообщений**", где можно просмотреть все логи, относящиеся к работе бота. При необходимости вы можете воспользоваться фильтром, который показывает какие сообщения относятся к самому боту, а какие к пользователям бота.

<figure><img src="https://2574066779-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm9kqZXsNykrN6VyxxXBO%2Fuploads%2Fgit-blob-b56adad4699a01db18fee4683a6f6d6be7208c5e%2Fimage.png?alt=media" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Лог сообщений</strong>"</p></figcaption></figure>

При неполадках с отправкой сообщений с помощью бота, вы можете удалить и зарегистрировать заново вебхук (см. п. 4) - это может помочь восстановить работу бота.

Если вы используете Cloudflare или подобный сервис для своего сайта - добавьте [IP-адреса Telegram](https://core.telegram.org/resources/cidr.txt) в whitelist в вашем сервисе:

```
91.108.56.0/22
91.108.4.0/22
91.108.8.0/22
91.108.16.0/22
91.108.12.0/22
149.154.160.0/20
91.105.192.0/23
91.108.20.0/22
185.76.151.0/24
2001:b28:f23d::/48
2001:b28:f23f::/48
2001:67c:4e8::/48
2001:b28:f23c::/48
2a0a:f280::/32
```

Альтернативный вариант: добавление пула IP-адресов по ASN (autonomous system number) — ASN Telegram и их добавление в whitelist в ЛК Cloudflare указаны в [инструкции](https://premium.gitbook.io/main/osnovnye-nastroiki/faq/dobavlenie-ip-adresov-v-whitelist-v-cloudflare).