Решение проблем с контактами

Принудительное обновление синхронизации контактов

Этот метод поможет, если контакты отображаются как «неизвестный контакт», некоторые контакты серые (незарегистрированные) или зарегистрировавшийся контакт не отображается. Выполняйте действия в мобильном приложении, так как контакты синхронизируются через него.

Платформа	Шаги
iOS/iPadOS	Отключите доступ к контактам в настройках iOS для мобильного приложения. Перезапустите приложение. В разделе Контакты появится уведомление о запрете доступа. Включите доступ к контактам в настройках iOS, перезапустите приложение и дождитесь завершения синхронизации.
Android	Проверьте, что приложению разрешён доступ к контактам: Настройки > Приложения > выберите приложение > Разрешения > Контакты. Перезапустите приложение и дождитесь завершения синхронизации. Контакты не обновились — соберите диагностику и обратитесь в поддержку.

Функция «Использовать имена из телефонной книги» не работает

Попробуйте отключить и снова включить эту настройку. Также можно выполнить принудительное обновление синхронизации контактов (см. выше). Если проблема касается одного контакта, отредактируйте его в телефонной книге устройства и перезагрузите раздел Контакты в приложении.

Не удаётся найти контакт

Ввели мало символов?

Для поиска контакта введите минимум три символа в поле поиска.

Большая телефонная книга?

Если ваша телефонная книга содержит несколько сотен контактов, дождитесь завершения синхронизации контактов.

Пользователь не регистрировался в приложении?

Искомый контакт может быть незарегистрированным. Уточните это у этого пользователя, поддержки вашей организации или поддержки eXpress.

Отображается «неизвестный контакт»?

Возможен сбой синхронизации. Контакты могут отображаться как «неизвестный/незарегистрированный контакт». Выполните принудительное обновление синхронизации (см. выше). Если проблема не решена, найдите контакт в веб- или десктоп-версии приложения, соберите логи и обратитесь в поддержку eXpress.

Пытаетесь найти контакт с другого сервера?

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

Если отключён трастовый или корпоративный поиск в настройках сервера, вы не сможете найти контакт даже с трастового сервера. Уточните это в поддержке вашей организации.

Администратору: проверка настроек поиска

CTS

eCTS

Проверьте настройки на корпоративном сервере через панель администратора:

• Убедитесь, что трастовый поиск разрешён в свойствах трастового сервера и включена настройка Trust Search в разделе Сервер > Server Features.
• Проверьте, включён ли корпоративный поиск в разделе Сервер > Server Features.

Ищете контакт не по имени, а по другому полю?

• Поиск может не выполняться по некоторым полям или их отображение не настроено на сервере. Доступные для поиска поля: логин Active Directory, домен, организация, должность, офис, отдел, рабочий телефон, email. Поиск по серверу или полю «описание» невозможен.
• Убедитесь, что поиск по точному совпадению отключён.

Не удаётся найти контакт в приложении на ПК, хотя в мобильном приложении он есть

Контакт отображается на мобильном устройстве, но отсутствует в веб-/десктоп-приложении (или имя отображается неверно).

Что делать?

• На устройстве с нужной телефонной книгой откройте Настройки (аватар над списком чатов) > Открытые сессии > Завершить все или Закрыть все сессии, кроме текущей и войдите в приложение на компьютере по QR-коду или иным способом. Если не помогло, принудительно синхронизируйте контакты и повторите эти шаги снова.
• Обходное решение: напишите контакту с устройства, где он отображается, чтобы на ПК появился чат с ним.
• Обратитесь в поддержку вашей организации, чтобы администратор очистил ваши контакты на сервере для повторной синхронизации, или напрямую в поддержку eXpress.

Администратору: помощь пользователю с поиском контактов

CTS

eCTS

• 1. Попросите пользователя завершить все сессии и закрыть приложение на мобильном устройстве.
• 2. В панели администратора найдите пользователя в разделе Пользователи > Активации > нажмите Очистить контакты для мобильной активации.
• 3. Проверьте контакты на мобильном устройстве.
• 4. Попросите пользователя отключить доступ к контактам в настройках устройства, перезапустить приложение, включить доступ и снова перезапустить.
• 5. Убедитесь, что контакт отображается, и войдите на других устройствах по QR-коду или иным способом.

В приложении для iOS задублированы все контакты

Отключите и снова включите доступ к контактам в настройках iOS для приложения, затем перезапустите приложение.

Ничего не помогло?

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

Администратору: очистка контактов в сессии пользователя

CTS

eCTS

Найдите профиль пользователя в панели администратора, в разделе Активации найдите сессию iOS, нажмите Очистить контакты и попросите пользователя завершить сессию и войти заново.

В приложении для iOS все контакты отображаются как серые незарегистрированные

Отключите VPN и перезапустите приложение. Если контакты остались серыми, соберите диагностику и обратитесь в поддержку.

Вместо имени у контакта отображается номер телефона

Проверьте, не записан ли контакт в телефонной книге с номером вместо ФИО.

Отредактируйте контакт в телефонной книге и перезапустите приложение или отключите настройку Использовать имена из телефонной книги.

Вместо имени отображается «Неизвестный контакт» у одного контакта

Если вместо имени отображается «Неизвестный контакт» или «Unknown user», произошёл сбой загрузки профиля из-за потери связи с сервером.

Что делать?

Дождитесь, когда восстановится связь с сервером: имя появится само. Приложение повторно запрашивает такой профиль, когда контакт снова показывается на экране, но не чаще раза в 30 минут. Чтобы обновить профиль сразу, откройте карточку контакта. Также можно выполнить принудительную синхронизацию контактов.

Контакт отображается в приложении два раза

Если вы видите другого пользователя (своего коллегу) в приложении два раза, это может быть связано с одной из двух причин:

Причина	Описание
У пользователя действительно два профиля	У пользователя есть публичный аккаунт с номером телефона и корпоративная учётная запись без номера или с другим номером. Такая ситуация возникает, если пользователь, уже имея личный аккаунт на публичном сервере с номером телефона, вошёл на корпоративный сервер без номера телефона или с другим номером, создав таким образом дополнительный профиль. Вы можете отправлять сообщения или звонить как на личный, так и на корпоративный профиль. Оба профиля будут отображаться в поиске по чатам и контактам. Личный профиль будет обозначен зелёным (в чате — сине-зелёным) значком, а корпоративный — синим. Если пользователю потребуется использовать номер телефона из личного аккаунта, передайте ему эту инструкцию.
CTS eCTS Есть учётная запись без номера, доступ к которой потерян	Пользователю выполнили логаут корпоративной учётной записи, не имевшей номер телефона, после чего он вошёл на тот же корпоративный сервер снова. После логаута безномерная корпоративная учётная запись не становится публичной — другие пользователи больше не могут с ней взаимодействовать, и её владелец теряет к ней доступ навсегда без возможности сохранить предыдущую переписку. Вы можете отправлять сообщения или звонить только на новый корпоративный профиль такого пользователя. Старый профиль не будет отображаться в поиске по контактам, но останется доступным старый персональный чат с ним. Оба профиля (старый и новый) будут обозначены синими значками. Подробнее.

Не видно обновлённую информацию у другого пользователя

Если в профиле другого пользователя отображается устаревшая информация (имя, должность, внутренний телефон и т.д.), выполните следующие действия:

Пользователь находится на вашем сервере?

• Откройте карточку пользователя;
• Получите новое сообщение от него.

Эти действия синхронизируют обновлённые данные. Перезапуск приложения профиль не обновляет: приложение показывает профиль из своего кэша.

Пользователь на доверенном сервере (другой сервер в вашей организации)?

• Дождитесь автоматического обновления (от 12 часов до 7 дней);
• Или запросите у администратора сервера принудительное обновление кэша (обратитесь в поддержку своей организации).

Ожидание не помогло. Что делать?

Попросите пользователя войти в приложение заново. Например, это поможет, если профили пользователей синхронизируются из OpenID. Если ничего не помогает, обратитесь в поддержку eXpress за помощью.

Администратору: обновление трастового кэша профилей

CTS

eCTS

Кеш сбрасывается на том сервере, где не видно изменений. Схема доверенного соединения на порядок действий не влияет: он одинаков и для прямого траста между двумя корпоративными серверами, и для связи через корневой сервер.

Трастовый кеш обновляется раз в неделю. Чтобы не ждать:

1. Войдите в консоль phonebook корпоративного сервера, где не отображаются изменения:

docker exec -i cts-phonebook-1 ./bin/ad_phonebook remote

⚠️ До версии 3.43 серверного ПО вместо remote вводите remote_console.

2. Очистите кэш профилей:

CcsCache.AdPhonebook.V1.ProfileCache.delete

Администратору: пользователь сменил аватар, но в панели администратора остался старый аватар

CTS

eCTS

Аватар, загруженный пользователем через клиентское приложение, виден только в приложениях-клиентах и в разделе «Список запросов на изменения» панели администратора. В профиле пользователя в панели администратора отображается старое фото из AD или загруженное ранее через панель администратора.

Администратору: не обновился аватар пользователя (используется KeyCloak)

CTS

eCTS

Для eXpress аватар из Keycloak — это лишь один из атрибутов, хранящийся как набор данных Base64.

Если используется встроенная база данных Keycloak — H2, то в ней нельзя хранить аватары. Для поддержки аватаров база данных Keycloak должна быть построена на PostgreSQL, Oracle или другой поддерживаемой СУБД.

Аватар обновляется при авторизации пользователя. Если при интеграции eXpress с Keycloak было установлено SPI-расширение от разработчиков eXpress, изменения атрибутов пользователей (включая аватары) будут применяться автоматически.

Если расширение Keycloak не установлено, для обновления данных пользователю нужно войти в приложение заново.

Другой пользователь поменял статус, но я вижу его прежний статус

Обновление статусов происходит раз в 30 минут. Чтобы не ждать, откройте карточку (профиль) пользователя.

Статус пользователя «онлайн» отображается в будущем времени

Проверьте настройки времени на устройстве.