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

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

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

Платформа	Шаги
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», приложение не смогло загрузить профиль, потому что потеряло связь с сервером.

Если профиль этого контакта уже загружался на вашем устройстве, при временном сбое сервера приложение оставляет прежние имя и аватар. Так работают приложение для iOS с версии 3.73, приложение для Android, веб- и десктоп-приложение с версии 3.75.

Что делать?

Дождитесь, когда восстановится связь с сервером: имя появится само. Приложение повторно запрашивает такой профиль, когда контакт снова показывается на экране, но не чаще раза в 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 или другой поддерживаемой СУБД.

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

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

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

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

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

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