Настройка календарей: Google и Microsoft

Когда календарь включён, каждый подключает свой Google Календарь или календарь Outlook/Hotmail, и Dromix присылает напоминания о событиях в чат. Dromix только читает календари. Изменять эти настройки могут только Владелец и Администратор компании.

Откройте Администратор компании → Продажи и интеграции → Интеграции → Календарь. В руководстве справа есть вкладки Google и Microsoft со всеми шагами.

#Google Календарь

По умолчанию Google Календарь подключается через Dromix. Сотрудники нажимают Подключить Google Календарь и входят на странице Google. Проект Google Cloud не нужен, вставлять ничего не требуется. Серверу нужна лицензия Dromix и доступ к dromix.net.

Конфиденциальность: при подключении и примерно раз в час, пока календарь подключён, служба Dromix на dromix.net кратковременно обрабатывает код входа Google и продлевает доступ, потому что секрет приложения Google от Dromix хранится только там. Dromix не хранит ничьи токены Google и никогда не читает данные календаря. Токены хранит Ваш сервер в зашифрованном виде, и он же читает события напрямую из Google.

#Собственное приложение Google (необязательно)

Если вход в Google должен идти только между Вашим сервером и Google, откройте Дополнительно: собственное приложение Google и используйте собственное приложение Google:

1. На console.cloud.google.com, войдя с рабочим аккаунтом, создайте проект и включите Google Calendar API.
2. Настройте экран согласия с областями email и calendar.readonly. Выберите Internal, если все пользуются Google Workspace Вашей компании, иначе External.
3. Для External нажмите Publish app, чтобы статус стал In production. Тестовые пользователи не нужны. Проверка необязательна: без неё сотрудники видят предупреждение «Google hasn't verified this app», а Google допускает не более 100 пользователей. Не оставляйте приложение в режиме Testing: тогда доступ прекращается через 7 дней и подключаться нужно заново.
4. Создайте OAuth-клиент типа Web application и добавьте redirect URI Google, показанный в Dromix, без изменений.
5. Вставьте в Dromix Google client ID (заканчивается на …apps.googleusercontent.com) и Google client secret и нажмите Сохранить календарь.

Это касается только новых подключений. Подключения через Dromix продолжают работать. Если позже нажать Удалить собственное приложение Google, подключившимся через Ваше приложение нужно будет подключиться заново.

#Microsoft (Outlook и Hotmail)

1. На portal.azure.com откройте Microsoft Entra ID → App registrations → New registration. Разрешите рабочие и личные учётные записи Microsoft, чтобы работали и Hotmail, и Outlook.com.
2. Добавьте redirect URI Microsoft, показанный в Dromix, как платформу Web.
3. Создайте секрет клиента и скопируйте его Value (не Secret ID).
4. Добавьте разрешения Microsoft Graph: User.Read, Calendars.Read и offline_access.
5. Вставьте в Dromix Microsoft client ID и Microsoft client secret.

#Включите календарь

Отметьте Активен и нажмите Сохранить календарь. После этого каждый подключает свой аккаунт в блоке Ваш календарь в разделе Интеграции. См. Подключение календаря и почты.

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