适用于 3CX 电话系统的 Google Workspace 集成
介绍
3CX 可以与 Google 集成以提供以下功能：
- 同步 Google Workspace 中的用户帐号。
- 将用户的个人联系人与 3CX 个人电话簿同步（单向）。
- 3CX 个人资料状态根据 Google 日历事件发生更改。即，如果您正在开会，您的状态将设置为忙碌。
- 创建并使用 Google Buckets 进行 3CX 电话系统远程存储。
- 使用 Google Speech 转录录音和语音邮件。
- 使用 Google Workspace 帐号发送电子邮件。
- 启用 Google SSO 用于允许用户使用其 Google 凭据登录网页客户端（需要在创建的 Google 项目上单独配置）。
- 启用 Google ReCaptcha 以防止自动攻击和滥用。
配置 Google 集成
步骤 1：Workspace 中的超级管理员角色
为了使集成正常工作，登录用户必须在工作区中具有超级管理员角色。请按照以下步骤向您将用于向 PBX 验证 Google 集成的用户授予超级管理员角色。
- 登录 https://admin.google.com/
- 导航到目录 > 用户。
- 编辑您想要提升为超级管理员的用户并打开部分 管理员角色和权限。
- 为您将用于验证 Google 集成的用户启用超级管理员角色，然后单击“保存”。
步骤 2：在 Google 控制台中设置组织级别角色
如果计划启用以下功能，则需要在 Google 控制台中为您的用户分配账单账户管理员IAM角色：
- 使用Google Cloud作为3CX电话系统的远程存储。
- 使用语音识别对录音和语音邮件进行转录。
为此，请按照下列步骤操作：
- 登录 https://console.cloud.google.com
- 确保您在组织级别进行操作。您可以通过单击页面顶部的下拉菜单来选择组织。
- 在左侧导航菜单中，转至 IAM 和管理 > IAM。
- 单击授予访问权限。
- 在打开的右侧面板 > 新主体字段中，添加通过 Google 集成进行身份验证的用户的电子邮件地址。
- 在“分配角色”下，添加“计费帐户管理员”角色，如屏幕截图所示。
- 保存。
步骤 3：禁用强制执行服务帐户密钥创建 - 如果适用
根据Google账户的创建时间，默认可能启用 disableServiceAccountKeyCreation 组织策略，禁止创建服务账户密钥。
若集成时遇到密钥创建错误，需按以下步骤禁用此策略：
注意：需使用拥有 组织策略管理员 角色的用户登录Google控制台。
- 在 谷歌控制台，导航到 IAM 和管理 > 组织策略。
- 搜索 iam.disableServiceAccountKeyCreation（旧版约束）或 iam.managed.disableServiceAccountKeyCreation（新版约束）。
- 打开 禁用服务帐户密钥创建 并点击 管理政策。
- 在策略来源下选择 覆盖父级策略。
- 在“规则”下添加一条“强制执行”=“关闭”的规则。
- 单击设置策略。
步骤 4：将 PBX 与 Google 集成
- 在 PBX 管理控制台中，导航至集成 > Google，然后单击配置。
- 您将被导航到以下集成页面。选择您计划使用的所有所需功能，然后单击“连接”。
- 当系统提示登录您的 Google 帐户时，请使用您在之前步骤中授予所有相关角色和权限的用户进行身份验证。
- 如果出现提示，请选择全部以允许 3CX 访问所需的资源，然后单击继续。
- 在身份验证过程中（仅当首次使用新用户登录时），如果您收到有关接受服务条款的消息，请按照以下步骤操作。如果您没有收到此消息，可以跳至下面的步骤 9。
- 导航至 https://console.developers.google.com/terms/appsadmin。
- 您应该已收到接受服务条款的请求。
- 单击接受并重复上面 4.2 步骤中的身份验证过程。
- 身份验证完成后，您将看到以下页面。
- 复制生成的客户端 ID，然后单击链接以在管理面板中打开域范围委派。
- 单击 API 客户端中的“添加新项”，提供您在上面复制的客户端 ID，并填写上一屏幕上列出的所有 OAuth 范围值（直接从页面复制它们）。
- 完成后点击授权。
- 点击上一屏幕上的“后退”按钮，您将被重定向到 PBX 管理控制台，其中 Google Workspace 集成将显示为已配置，并为您提供上述过程生成的项目 ID。
启用同步
完成 Google 与 PBX 的集成后，您可以继续将用户从 Google 同步到 3CX：
- 在 3CX 管理控制台中，转到“用户”并单击“Google”。
- 使能够 同步 Google 用户 将用户从 Google 同步到 3CX。同步是单向的（Google 到 3CX），并且在您保存配置时立即发生，然后每天晚上发生一次。
- 您可以设置分配给导入的 Google 用户的起始分机号码。否则它将使用第一个可用的分机。
- 您不必同步所有用户。您可以排除某些用户或仅指定要同步的特定用户集。单击 添加 按钮进行配置。
选择同步选项
启用用户同步后，您可以选择为导入的 Google 用户同步哪些内容
- 启用 SSO 以允许用户使用其 Google 凭据登录网页客户端（需要单独配置。了解如何点击 这里）。
- 通过启用，将 Google 用户照片作为用户头像同步到 3CX 同步用户照片。
- 您可以启用“同步个人联系人”选项，这会将 Google 用户的联系人同步到 3CX 个人电话簿。这是一种单向同步。联系人需要通过 Google 进行管理和更新。
- 启用 使用日历事件作为状态，根据Google会议自动更新3CX用户状态。因此，如果您正在参加预定的会议，您的电话将不会响铃。在 Google 日历条目结束时，3CX 将配置文件切换回之前的状态。如果是3CX 商务旅行/午餐 选择配置文件后，日历信息的更改将被忽略。
Google 日历会议类型到 3CX 配置文件的映射如下：
- 活动 > 请勿打扰
- 专注时间 > 请勿打扰
- 不在办公室 > 离开
附加功能
用于远程存储的 Google Cloud
在 3CX 上配置 Google 集成，如果在配置过程中获得适当的权限，3CX 将自动为您的 Google Cloud 项目创建一个 Google 存储桶，并相应地配置您的 3CX 存储设置。
然后，您只需导航到管理控制台 > 系统 > 存储，然后选择要在此远程 Google 位置存储的数据。您可以根据需要选择远程存储聊天文件、传真、录音、语音邮件和备份。
Google 语音转录
如果选择了相关权限，您可以使用集成过程自动创建的 Google 配置来启用 Google 语音转录。
一旦您完成了 Google 集成并在 3CX 上配置了存储，只需导航至管理控制台 > 集成 > 转录，然后使用您首选语言的 Google 语音启用转录。
使用 Google Workspace 发送电子邮件
如果在集成过程中获得适当的权限，3CX 将自动配置您的系统电子邮件设置，以使用集成的 Google Workspace 帐号发送系统电子邮件。
谷歌验证码
在配置过程中使用相关权限配置 Google 集成后，您可以从管理控制台 > 集成 > Google 启用 Google ReCaptcha，使其在后台运行，保护 3CX 免受自动攻击和滥用。
技术信息和常见问题解答
实时同步与每日同步
以下数据与 Google 上的更改实时同步：
- 用户的名字
- 用户的姓氏
- 用户照片
- 用户的工作电话
- 在工作区中创建的新用户
- 暂停/删除工作区中的用户 > 禁用 3CX 分机
- 在工作区中取消挂起用户 > 启用 3CX 分机
- 日历事件
其余数据我们不监听实时变化，PBX 每天会同步一次。每日同步由参数 GW_SYNC_TIME 控制。它以 24 小时格式存储一天中的时间：HH:MM:SS，其中 PBX 将重新同步来自 Google 的所有数据。
日历同步状态
在 Google 日历中创建条目将同步用户的状态，如下所示：
- 活动 > 请勿打扰
- 不在办公室 > 离开
- 专注时间 > 请勿打扰
用户和联系人数据同步
对于已同步的用户，我们会从 Google 同步以下信息：
- 名
- 姓
- 电子邮件
- 电话（工作）到 3CX 中用户的手机
- 照片
对于同步的联系人，我们会从 Google 同步以下信息：
- 名
- 姓
- 照片
- 公司
- 标题
- 移动的
- 手机2
- 家
- 商业
- 商业2
- 电子邮件
要正确同步此联系信息，您需要在 Google 通讯录中标记它们，如下面的屏幕截图所示。
现有的 Google 存储配置
如果您已经启用了 Google 存储，在集成过程中，向导会通知您，并且不会为您重新配置。
限制和已知问题
- 公司联系人不存在
- Gmail 每封邮件的最大附件大小为 25Mb
- 无法监听个人联系人的变化
- 未来版本将支持从网页客户端到 Google 创建联系人
另请参阅
最后更新
本文档最后更新于 2025 年 2 月 19 日
https://www.3cx.cn/docs/manual/google-workspace/
版权所有 三思客软件（深圳）有限公司