在 Odoo 中使用 OnSIP 的 VoIP 服务

:::: important ::: title 重要 :::

OnSIP 的 VoIP（基于互联网的语音协议） 服务仅在 美国（US）提供。
OnSIP 的 VoIP（基于互联网的语音协议） 服务在美国本土48州（即本土连续地区）广泛可用。若在阿拉斯加或夏威夷使用，费用可能更高。

此外，使用该服务必须提供 美国（US）账单地址和 美国（US）信用卡。

在使用 OnSIP 开设账户之前，企业需要确保其业务电话号码可以迁移到 OnSIP。

OnSIP 会尽力与所有电话服务提供商合作，但某些当地或区域性规定可能导致当前提供商无法释放号码。 ::::

Odoo VoIP 可以与 OnSIP（Odoo 官方页面） 配合使用。OnSIP 是一家 VoIP 提供商，使用此服务需先在 OnSIP 开设账户。

在创建 OnSIP 账户之前，请确认公司所在地区以及将要拨打的地区均在 OnSIP 服务覆盖范围内。

开通 OnSIP 账户后，按照下面的配置步骤在 Odoo 数据库中进行设置。

要在 Odoo 数据库中连接 OnSIP 服务，首先在主仪表盘进入 Apps（应用）。随后移除搜索栏中的默认 [Apps] 过滤器，搜索 [OnSIP]。

接着，激活 VOIP OnSIP 模块。

{.align-center}

安装 VOIP OnSIP 模块后，进入 Settings（设置） 应用，向下滚动至 Integrations（集成） 部分，找到 VoIP 相关字段，并填写以下信息：

  • OnSIP 域名：在 OnSIP 创建账户时分配的域名。
  • WebSocket：wss://edge.sip.onsip.com
  • VoIP 环境：Production

{.align-center}

:::: tip ::: title 提示 :::

要获取 OnSIP 域名，请访问 OnSIP 并登录。随后点击页面右上角的 Administrators 链接。

在左侧菜单中选择 Users，再点击任意用户。默认会打开该用户的 User Info（用户信息） 选项卡。

切换到 Phone Settings（电话设置） 选项卡，即可看到 OnSIP 配置凭证（第一列）。

{.align-center} ::::

接下来，需要在 Odoo 中为对应的用户完成设置。每位关联 OnSIP 账户的 Odoo 用户 必须 在其个人设置/偏好中配置相应信息。

操作路径：Settings（设置） --> Manage Users（管理用户） --> 选择对应用户。

在用户表单中点击 Edit（编辑），配置该用户的 OnSIP 账户信息。随后切换到 Preferences（偏好） 选项卡，滚动至 VoIP Configuration（VoIP 配置） 区域。

在此区域填写以下字段：

  • VoIP 用户名 = OnSIP Username
  • OnSIP Auth 用户名 = OnSIP Auth Username
  • VoIP 密钥 = OnSIP SIP Password

:::: tip ::: title 提示 :::

OnSIP 分机号可在用户信息横幅行（位于选项卡上方）中找到。 ::::

完成上述步骤后，离开用户表单即可自动保存配置。

保存后，Odoo 用户可通过点击右上角的 ☎️（电话） 图标进行拨号。

::: seealso 更多设置与故障排除步骤请参考 OnSIP 知识库。 :::

Odoo 数据库同样会接收来电，并在界面弹出窗口。当来电弹窗出现时，点击绿色的 📞（电话） 图标接听。

若想拒绝来电，点击红色的 📞（电话） 图标。

{.align-center}

::: seealso voip_widget :::

如果在 Odoo 小部件中出现 Missing Parameters（缺少参数） 提示，请刷新浏览器窗口（或标签页）后重试。

{.align-center}

如果出现 Incorrect Number（号码错误） 提示，请确保使用 国际格式 输入号码，即在号码前加上国家代码。

国家代码是用于接入目标国家电话系统的前置码。每个国家都有唯一的代码，例如美国的国际前缀是 1，完整号码示例为 16505555555。

{.align-center}

::: seealso 完整的国家代码列表请访问：https://countrycode.org。 :::

当用户不在电脑前时，可使用手机上的软电话应用与 Odoo VoIP 同步，做到随时接听或拨打电话。

这对外出办公、确保来电不漏听非常实用。任何支持 SIP 的软电话均可使用。

::: seealso