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

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

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

* В настройках доп. поля "**Telegram**" обязательно выбран пункт "**Telegram**" для поля "**Автозаполнение**"\
  ![](/files/sK0tvz0QeMj4DzmWfqE9)
* У пользователя должен быть добавлен юзернейм из Телеграм в ЛК в вашем обменнике\
  ![](/files/DIYxndLrdWlnknHC18cK)
* Пользователь должен активировать вашего бота для уведомлений командой `/start` и получить от него ответ\
  ![](/files/rOFmg3fsvfxD3xTnjMGw)
  {% endhint %}

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

<img src="/files/5xFssQria8kJ9kx80FMu" alt="" data-size="original"><img src="/files/a2J4sqNR74mZLG3zRdQ1" alt="" data-size="original">
{% endhint %}

## Настройки

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

<figure><img src="/files/W0mwqrLr70lEniD4yMPg" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Настройки</strong>"</p></figcaption></figure>

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

<img src="/files/83dJejJG6BqveP2qA5rh" alt="" data-size="original">
{% endhint %}

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

<figure><img src="/files/eLHSijEDKKJ1Xv8nNaZU" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Лог сообщений</strong>"</p></figcaption></figure>

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

<figure><img src="/files/gytaR6muE2rjpiwGAaN4" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Настройки</strong>"</p></figcaption></figure>

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

<figure><img src="/files/KXzfkYzo7gq02MlmVcZF" alt=""><figcaption><p>Раздел "<strong>Telegram</strong>" -> "<strong>Настройки</strong>"</p></figcaption></figure>

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

<figure><img src="/files/LVVHAH7IQErFnJ8NIgkp" alt=""><figcaption><p>Раздел "<strong>Настройки</strong>" в Telegram</p></figcaption></figure>

<figure><img src="/files/l6r51Wauy0KMm80L3awg" alt=""><figcaption><p>Раздел "<strong>Пользователи</strong>" -> "<strong>Редактировать</strong>"</p></figcaption></figure>

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

<figure><img src="/files/bp0pQytKg55Cue0O6YIH" alt=""><figcaption><p>Раздел "<strong>Сообщения" → "Тelegram шаблоны"</strong></p></figcaption></figure>

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

<img src="/files/Ea63uo4VdRhdrrGfcO7e" alt="" data-size="original"><img src="/files/AhgT3MLDPU2TycGYPZYn" alt="" data-size="original">
{% endhint %}

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

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

<img src="/files/n1cmXrHHsQilZakoJaXM" alt="" data-size="original">
{% endhint %}

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

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

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

<figure><img src="/files/W2iDT4Sjt1xdESQO5wNL" alt=""><figcaption><p>Раздел "<strong>Направления обменов</strong>" -> "<strong>Доп. поля</strong>"</p></figcaption></figure>

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

<figure><img src="/files/mDUnXIvYuRl6M13UVuxZ" alt=""><figcaption><p>Страница обмена</p></figcaption></figure>

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

<figure><img src="/files/N94NrQgzM6tLJl6CbYR6" alt=""><figcaption><p>Личный кабинет пользователя в обменнике</p></figcaption></figure>

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

<img src="/files/uTo7k4foHOTjB1nXpZ0q" alt="" data-size="original">
{% endhint %}

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

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

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

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

<figure><img src="/files/ZaLOLlEr0JiNI5Kv5B4z" 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).


---

# 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://premium.gitbook.io/main/osnovnye-nastroiki/uvedomleniya-administratoram-i-klientam/uvedomleniya-v-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.