Настройка интеграции с мессенджером Telegram#
В системе реализована возможность получения уведомлений о необходимости обработки документов через мессенджер Telegram.
Для того, чтобы подключить данный функционал, необходимо:
-
Выделить телефонный номер с подключением с аккаунтом в Telegram, от имени которого будет идти рассылка уведомлений. Рекомендуется не использовать личные аккаунты. При необходимости можно использовать отдельные номера телефонов для каждой организации.
-
Зарегистрировать данный номер телефона на сайте мессенджера и получить идентификаторы API.
-
Привязать в Лексеме номер телефона к организации/организациям. Ниже подробно описаны действия, которые необходимо выполнить на каждом шаге.
Шаг 1
Выделить номер телефона и зарегистрировать его в Telegram. Данный шаг является организационным.
Шаг 2
Для того, чтобы получить идентификатор API , необходимо перейти на сайт и ввести номер телефона, с которого будут отправляться уведомления пользователям. На этот номер будет направлен код подтверждения, который необходимо ввести в соответствующее поле. После этого необходимо нажать "Войти"
- Перейдите в «Инструменты разработки API»
- Заполните форму
- Вы получите базовые адреса, а также параметры api_id и api_hash , необходимые для авторизации пользователя. Рекомендуется их сохранить в текстовый файл.
Note
На данный момент к каждому номеру может быть подключен только один api_id.
Warning
Сервис Telegram будет направлять важные уведомления разработчиков на номер телефона, который вы используете в этом процессе, поэтому, пожалуйста, используйте актуальный номер, связанный с вашей активной учетной записью Telegram.
После подтверждения в системе появится уведомления, что пользователь авторизован. В мессенджере Telegram поступит сообщение , что был осуществлен вход с нового устройства.
Шаг 3
Теперь остается привязать зарегистрированный номер телефона к каждой организации. Для настройки необходимо открыть Меню - Администрирование - Система - Настройки телеграм организаций
Для настройки необходимо открыть Меню - Администрирование - Система - Настройки телеграм организаций
В списке организаций выберите ту, к которой хотите привязать данный номер телефона
В поле Телеграм Телефон введите номер телефона, в полях Телеграм API_ID и Телеграм API_HASH введите данные, полученные на предыдущем шаге.
Нажмите «Авторизоваться с кодом подтверждения». В Telegram придет код подтверждения, который необходимо ввести в всплывающем окне на сайте.
Note
В случае если в холдинге у всех организаций номер телеграма один и тот же - то авторизоваться достаточно один раз в на основном филиале. На каждом филиале необходимо прописывать api_id и api_hash
Если авторизация прошла успешно – выйдет соответствующее сообщение:
В Telegram отобразится информация о подключении:
В поле "Статус сервиса" отображается успешное/не успешное подключение к сервису:
Note
Примечание: если статус сервиса сообщает о неуспешной авторизации – обратитесь в техническую поддержку Lexema-ECM
Для получения уведомления у пользователя должна быть подключена опция получения уведомления через Telegram в Управлении пользователями.
При поступлении документа на обработку пользователю придет соответствующее уведомление в мессенджере.
Чтобы настроить невозможность отправки сообщений на номер телефона Telegram пользователю , необходимо перейти Настройки - Конфиденциальность - Номер телефона - в настройке "Кто видит мой номер телефона" выбрать Никто и нажать "Сохранить". При таких настройках посторонние люди, которые знают номер телефона, не смогут писать сообщения на указанный номер.
