Интеграция Google Workspace с 3CX Phone System

Введение

3CX может интегрироваться с Google для реализации следующих возможностей:

• Синхронизация учетных записей пользователей из Google Workspace.
• Синхронизация личных контактов пользователя с личной телефонной книгой 3CX (односторонняя).
• Статус пользователя 3CX изменяется в зависимости от событий календаря Google, т.е., если у пользователя проводится встреча, статус будет установлен в «Занят».
• Создание и использование Google Buckets в качестве хранилища данных системы 3CX.
• Использование Google Speech для транскрибирования записей разговоров и голосовой почты.
• Использование учетных записей Google Workspace для отправки электронных писем.
• Единый вход Google SSO, который позволяет пользователю входить в веб-клиент, используя свои учетные данные Google (необходимо отдельно настроить в созданном проекте Google).
• Включение Google ReCaptcha для защиты от атак и злоупотреблений.

Настройка интеграции Google

Шаг 1. Роль Super Admin (суперадминистратор) в Workspace

Чтобы настроить интеграцию, пользователь должен иметь роль суперадминистратора в Workspace. Чтобы предоставить роль Super Admin пользователю, который используется для аутентификации вашей АТС в Google:

1. Войдите в https://admin.google.com/
2. Перейдите в Directory > Users.
   
3. Измените пользователя, которому следует назначить роль суперадминистратора - откройте раздел Admin roles and privileges.
4. Включите роль Super Admin для пользователя, который используется для аутентификации АТС в Google, и нажмите Save.

Шаг 2. Роли уровня организации в консоли Google

Кроме того, если планируется использовать нижеуказанные функции, необходимо предоставить пользователю роль Billing Account Administrator IAM (администратора платежного аккаунта IAM) в консоли Google:

• Использование Google Cloud как хранилища данных системы 3CX.
• Использование транскрибирования записей и голосовой почты.

Для этого выполните следующие действия:

1. Войдите в https://console.cloud.google.com/
2. Убедитесь, что вы работаете на уровне Organization level (организации). Можно выбрать организацию, щелкнув раскрывающееся меню в верхней части страницы.
3. В левом навигационном меню перейдите в IAM & Admin > IAM.
4. Нажмите Grant Access.
5. На открывшейся правой панели в поле New Principals добавьте адрес электронной почты пользователя, используемого для аутентификации с Google.
6. В разделе Assign Roles добавьте роль администратора платежного аккаунта, как показано на скриншоте.
7. Сохраните изменения.

Шаг 3. Отключение Enforcement of Service Account Key Creation (если применимо)

В зависимости от даты создания учетной записи Google, политика организации disableServiceAccountKeyCreation может по умолчанию запрещать создание Key Creation (ключа аккаунта).

В этом случае при настройке интеграции вы можете получить сообщение об ошибке: создание ключа запрещено.

Чтобы решить проблему, вам может потребоваться прекратить применение этой политики. Примечание. Чтобы управлять политиками организации в учетной записи Google, необходимо войти в консоль с пользователем, имеющим роль Organization Policy Administrator (администратора политики организации).

1. В консоли Google перейдите в IAM & Admin > Organization Policies.
2. Найдите iam.disableServiceAccountKeyCreation (устаревшая версия) или iam.managed.disableServiceAccountKeyCreation (новая версия).
3. Откройте Disable service account key creation и нажмите Manage Policy.
4. В разделе Policy Source выберите Override parent’s policy.
5. В разделе Rules добавьте правило Enforcement = Off.
6. Нажмите Set Policy.

Шаг 4. Настройка интеграции с Google на стороне АТС

1. В консоли администрирования АТС перейдите в раздел Integrations > Google и нажмите Configure.
   
2. Вы перейдете на следующую страницу интеграции. Выберите все необходимые функции и нажмите Connect.
   
3. Когда появится запрос на вход в Google, войдите с учетной записью, для которой вы установили соответствующие роли и разрешения на предыдущих шагах.
4. Если появится запрос, выберите All, чтобы разрешить 3CX доступ к необходимым ресурсам, и нажмите Continue.
   
5. Во время аутентификации (при первом входе в систему с новым пользователем), если появилось сообщение о принятии условий обслуживания, выполните нижеуказанные действия. Если сообщения нет, перейдите сразу к шагу 9.
   
6. Перейдите по адресу https://console.developers.google.com/terms/appsadmin.
7. Здесь может появиться запрос на принятие условий обслуживания.
   
8. Нажмите Accept и повторите аутентификацию (вернитесь на шаг 2 выше).
9. После завершения аутентификации вы увидите следующую страницу.
   
10. Скопируйте сгенерированный Client ID и щелкните ссылку, чтобы открыть Domain-wide Delegation (делегирование на уровне домена) в панели администратора.
11. Нажмите Add New в API Clients, укажите Client ID, скопированный выше, и заполните все поля OAuth, перечисленные на скриншоте выше (скопируйте их со страницы).
12. Затем нажмите Authorize.
    
13. Нажмите кнопку Back на предыдущем экране. Вы будете перенаправлены в консоль администрирования АТС, где появится настроенная интеграция Google Workspace с созданным идентификатором проекта.
    

Включение синхронизации

После настройки интеграции 3CX с Google, можно приступить к синхронизации пользователей:

1. В консоли администрирования 3CX перейдите в раздел Users и нажмите Google.
2. Включите Sync Google Users, чтобы синхронизировать пользователей между Google и 3CX. Синхронизация является односторонней (из Google в 3CX) и происходит, когда сохраняется конфигурация. После этого она происходит один раз в день, ночью.
3. Вы можете установить начальный добавочный номер, с которого начнется назначение номеров импортированным пользователям Google. В противном случае будет использоваться первый доступный добавочный номер.
4. Необязательно синхронизировать всех пользователей. Можно исключить или включить определенных пользователей для синхронизации. Для указания нажмите кнопку Add.

Выбор параметров синхронизации

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

1. Включите SSO, чтобы разрешить пользователям входить в веб-клиент со своими учетными данными Google (необходимо настроить отдельно).
2. Синхронизируйте фотографии пользователей Google как аватары 3CX, включив опцию Sync user photo.
3. Можно включить синхронизацию личных контактов Sync Personal Contacts. Будут синхронизироваться контакты пользователя Google с личной телефонной книгой 3CX. Это односторонняя синхронизация - контактами необходимо управлять из Google.
4. Включите Use calendar events as presence, чтобы автоматически обновлять статус пользователей 3CX на основе запланированных встреч в календарях Google. Т.е., если у вас запланирована встреча, в это время ваш телефон не будет звонить. По окончании встречи в календаре Google, 3CX возвращает ваш исходный статус. Если выбран статус 3CX Business Trip/Lunch (Командировка/Обед), информация из календаря Google игнорируется.

Сопоставление типов встреч календаря Google со статусами 3CX:

• Event > Do Not Disturb (Событие > Не беспокоить)
• Focus Time > Do Not Disturb (Время фокусировки > Не беспокоить)
• Out of Office > Away (Вне офиса > Нет на месте)

Дополнительные возможности

Использование Google Cloud для удаленного хранилища

Если при настройке интеграции были предоставлены соответствующие разрешения, 3CX автоматически создаст Google bucket в вашем проекте Google Cloud и настроит параметры хранилища 3CX.

Затем в консоли администрирования > System > Storage выберите, какие данные хранить в удаленном хранилище Google. При необходимости можно выбрать хранение истории чата, факсов, записей разговоров, голосовой почты и резервных копий.

Использование Google Speech для транскрибирования

Если при интеграции предоставлены соответствующие разрешения, можно включить транскрипцию Google Speech. Для этого используется конфигурация Google, автоматически созданная в процессе интеграции.

После завершения интеграции и настройки хранилища в 3CX, перейдите в консоль администрирования > Integrations > Transcription и включите транскрипцию с помощью Google Speech для предпочитаемого языка.

Использование Google Workspace для отправки электронных писем

Если при интеграции предоставлены соответствующие разрешения, 3CX автоматически настроит отправку системной электронной почты 3CX через учетную запись Google Workspace, которая использовалась для интеграции.

Использование Google ReCaptcha

Если при интеграции предоставлены соответствующие разрешения, вы можете включить Google ReCaptcha в консоли администрирования > Integrations > Google. Она будет работать в фоновом режиме, защищая 3CX от автоматического подбора пароля и других злоупотреблений.

Техническая информация и часто задаваемые вопросы

Синхронизация в реальном времени и ежедневная синхронизация

При изменениях в Google, следующие данные синхронизируются в реальном времени:

• Имя пользователя
• Фамилия пользователя
• Фотография пользователя
• Рабочий телефон пользователя
• Новый пользователь, созданный в Workspace
• Приостановка/удаление пользователя в Workspace > Отключение добавочного номера 3CX
• Восстановление пользователя в Workspace > Включение добавочного номера 3CX
• События календаря

Для остальных данных изменения не отслеживаются в реальном времени, и АТС будет выполнять синхронизацию один раз в день. Ежедневная синхронизация управляется параметром GW_SYNC_TIME. Укажите, когда АТС будет синхронизировать все данные из Google. Время указывается в 24-часовом формате: ЧЧ:ММ:СС.

Синхронизация статусов календаря

Запись в календаре Google синхронизирует статус пользователя 3CX следующим образом:

• Событие > DND (Не беспокоить)
• Вне офиса > Away (Нет на месте)
• Время фокусировки > DND (Не беспокоить)

Синхронизация данных пользователей и контактов

Для синхронизированных пользователей из Google передается следующая информация:

• Имя
• Фамилия
• Электронная почта
• Телефон (рабочий) с мобильным телефоном пользователя в 3CX
• Фотография

Для синхронизированных контактов из Google передается следующая информация:

• Имя
• Фамилия
• Фото
• Компания
• Должность
• Мобильный
• Мобильный2
• Домашний
• Рабочий
• Рабочий2
• Электронная почта

Чтобы правильно синхронизировать контактную информацию, ее необходимо пометить тегами (например, Department) в контактах Google (см. скриншот ниже).

Существующее удаленное хранилище Google

Если у вас уже настроено хранилище Google, мастер интеграции сообщит об этом и не будет изменять настройки хранилища.

Ограничения и известные проблемы

• Контакты компании не существуют.
• Gmail имеет максимальный размер вложения 25 МБ в одном сообщении.
• Невозможно отслеживать изменения в личных контактах.
• Создание/синхронизация контактов из веб-клиента 3CX в Google Workspace появится в следующем релизе.

Дополнительная информация

• Настройка единого входа Google SSO
• Интеграция 3CX с Microsoft 365

Версия документа
Последнее обновление документа 19 февраля 2025
https://www.3cx.ru/docs/manual/google-workspace/