ecm-administrator-manuals/docs/Admin manuals/telegram/Настройка мессенджера телеграм.md

94 lines
7.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Настройка интеграции с мессенджером Telegram
В системе реализована возможность получения уведомлений о необходимости обработки документов через мессенджер Telegram.
Для того, чтобы подключить данный функционал, необходимо:
1. Выделить телефонный номер с подключением с аккаунтом в Telegram, от имени которого будет идти рассылка уведомлений. Рекомендуется не использовать личные аккаунты. При необходимости можно использовать отдельные номера телефонов для каждой организации.
2. Зарегистрировать данный номер телефона на сайте [мессенджера](https://my.telegram.org/auth) и получить идентификаторы API.
3. Привязать в Лексеме номер телефона к организации/организациям. Ниже подробно описаны действия, которые необходимо выполнить на каждом шаге.
**Шаг 1**
Выделить номер телефона и зарегистрировать его в Telegram. Данный шаг является организационным.
**Шаг 2**
Для того, чтобы получить идентификатор API , необходимо перейти на сайт и ввести номер телефона, с которого будут отправляться уведомления пользователям. На этот номер будет направлен код подтверждения, который необходимо ввести в соответствующее поле. После этого необходимо нажать "Войти"
![Номер](media/number.png)
![Код](media/code.png)
* Перейдите в «Инструменты разработки API»
![Инструменты](media/tools.png)
* Заполните форму
![Форма](media/form.png)
* Вы получите базовые адреса, а также параметры api_id и api_hash , необходимые для авторизации пользователя. Рекомендуется их сохранить в текстовый файл.
![Конфиг](media/config.png)
!!! note
На данный момент к каждому номеру может быть подключен только один **api_id**.
!!! warning
Сервис Telegram будет направлять важные уведомления разработчиков на номер телефона, который вы используете в этом процессе, поэтому, пожалуйста, используйте актуальный номер, связанный с вашей активной учетной записью Telegram.
После подтверждения в системе появится уведомления, что пользователь авторизован. В мессенджере Telegram поступит сообщение , что был осуществлен вход с нового устройства.
**Шаг 3**
Теперь остается привязать зарегистрированный номер телефона к каждой организации.
Для настройки необходимо открыть Меню - Администрирование - Система - Настройки телеграм организаций
Для настройки необходимо открыть Меню - Администрирование - Система - Настройки телеграм организаций
![Меню](media/menu.png)
В списке организаций выберите ту, к которой хотите привязать данный номер телефона
![Компании](media/companies.png)
В поле **Телеграм Телефон** введите номер телефона, в полях **Телеграм API_ID** и **Телеграм API_HASH** введите данные, полученные на предыдущем шаге.
![Авторизация](media/api.png)
Нажмите «Авторизоваться с кодом подтверждения». В Telegram придет код подтверждения, который необходимо ввести в всплывающем окне на сайте.
![Код подтверждения](media/codeTelega.png)
![Подтверждение](media/codePodtver.png)
!!! warning
В случае если в холдинге у всех организаций номер телеграма один и тот же - то авторизоваться достаточно один раз в на основном филиале. На каждом филиале необходимо прописывать **api_id** и **api_hash**
Если авторизация прошла успешно выйдет соответствующее сообщение:
![Система](media/pushSys.png)
В Telegram отобразится информация о подключении:
![Телеграм](media/messageTel.png)
В поле "Статус сервиса" отображается успешное/не успешное подключение к сервису:
![Сервис](media/status.png)
!!! note
Примечание: если статус сервиса сообщает о неуспешной авторизации обратитесь в техническую поддержку Lexema-ECM
Для получения уведомления у пользователя должна быть подключена опция получения уведомления через Telegram в [Управлении пользователями](../Управление пользователями/Управление пользователями.md#создание_пользователя).
При поступлении документа на обработку пользователю придет соответствующее уведомление в мессенджере.
![Телега](media/telega.png)
Чтобы настроить невозможность отправки сообщений на номер телефона Telegram пользователю , необходимо перейти Настройки - Конфиденциальность - Номер телефона - в настройке "Кто видит мой номер телефона" выбрать **Никто** и нажать "Сохранить". При таких настройках посторонние люди, которые знают номер телефона, не смогут писать сообщения на указанный номер.
![](media/conf.png)