配置 VoIP.ms SMS 短信渠道

本文介绍如何在 Yeastar P 系列 IPPBX 上配置 VoIP.ms SMS 短信渠道，以便企业坐席可以在 Linkus UC 客户端上接收并回复客户的 SMS 消息。

使用要求

Yeastar PBX 需满足以下要求：
  • 固件版本：37.14.0.24 或更高版本
  • 订阅服务：隧道服务 或 视频会议，保证 FQDN 功能可用
  • FQDN：确保 PBX 可通过 FQDN 访问。
    注： 由于第三方平台限制，FQDN 域名中不能包含下划线，否则消息渠道会出现验证失败或无法接收消息的问题。

    有关 FQDN 配置的具体信息，请参见 通过 Yeastar FQDN 远程访问 PBX。

支持的消息类型和限制

支持的消息类型

SMS 短信渠道中支持发送的消息类型取决于 VoIP.ms。

重要： 发送多媒体消息 (例如图片) 时，SMS 运营商会通过 PBX 提供的链接下载文件。因此，如果你设置了 国家地区 IP 访问防御 安全规则，需确保 PBX 允许 SMS 运营商所在国家的 IP 访问，否则文件传输会失败。
限制
  • 文件大小：最大 100 MB
  • 文件保留时间：24 小时

前提条件

向 VoIP.ms 获取以下信息：
  • 用于验证鉴权信息的 API 接口地址
  • 用于发送消息的 API 接口地址
  • 信息发送速率限制
  • 用于消息渠道对接的 API key (API 密钥) 和 Secret (密钥)
  • 用于发送和接收信息的电话号码
    注： 如果企业需要与美国客户联系，须确保此电话号码已经完成 10DLC 注册，以防止发送到美国号码的 SMS 消息被拦截。

操作步骤

  1. 登录 PBX 管理网页，进入 讯息管理 > 消息渠道。
  2. 点击 添加，选择 SMS。
  3. 在 鉴权信息 栏，完成以下设置。

    • 名称：为渠道设置一个便于识别的名称。
    • 运营商：选择 VoIP.ms。
    • API Key：填写 VoIP.ms 提供的 API 密钥。
    • Secret：填写 VoIP.ms 提供的 Secret 密钥。
    • 发送消息的API接口地址：填写 VoIP.ms 提供的 API 接口地址。在本例中，填写 https://voip.ms/sendmessage。
    • 验证鉴权信息的API接口地址：填写 VoIP.ms 提供的 API 接口地址。在本例中，填写 https://voip.ms/verify。
    • Webhook URL：复制此 Webhook URL，并粘贴到 VoIP.ms 的用户界面中。
      注： 关于在 VoIP.ms 用户界面中的 Webhook 具体设置，请联系运营商。
  4. 在 消息设置 页签，配置该渠道。
    1. 在 消息发送速率 栏，指定 PBX 每秒可发送多少条消息。
      注：
      • 如果消息发送的速率超过此处设置的值，PBX 会将消息排队，并按照设置的速率发送。
      • 如果设置的消息发送速率超过 SMS 运营商设置的速率，可能会导致消息发送失败。因此，请联系 SMS 运营商确认你的账户的发送速率限制，并根据需要提高限制。
    2. 可选： 如果你想要系统自动关闭在指定时间内无任何互动的会话，勾选 自动关闭会话，并在 会话超时时间 (天) 栏中设置超时时间。

    3. 在 号码 栏，点击 添加，添加消息路由规则。

      • 号码：以 E.164 格式填写购买的号码 ([+][国家区号][电话号码])。例如 +14102161183。
      • 消息目的地：设置通过此号码送入的消息会被送往哪个目的地。
        选项 说明
        分机 若选择此项，需在 分机 下拉列表中选择接收消息的分机。

        只有此分机用户可以接收到通过此号码送入的消息。
        消息队列 若选择此项，需在 消息队列 下拉列表中选择接收消息的队列。

        所选队列中的所有坐席都会收到队列中新会话的消息，但只有接管了会话的用户可以接收并回复后续送入的消息。
      • 允许创建会话的分机：选择一个或多个分机，选择的分机可以向外部用户发送消息。
    4. 点击 保存。
  5. 点击 保存。

执行结果

  • 你已成功创建了消息渠道，可在列表中查看到此渠道的 状态 显示为 。

  • 系统自动追踪并记录该渠道上发送和接收的消息数量，其中 总发送量 包含了发送成功和发送失败的所有消息数量。
    注：
    • 对于发送消息，PBX 仅追踪坐席在其 Linkus UC 客户端上发送的消息数据。因此，如果你要计算准确的消息发送费用，需要和 SMS 运营商确认精准的消息发送数量，因为在发送的信息超过 160 个字符的情况下，运营商可能将消息拆分发送，并在到达客户手机时将消息整合，这会额外增加发送消息的数量。
    • 可通过时间筛选查看指定时间段内的消息数据。

后续步骤

发送测试消息，确认指定的坐席是否可以在 Linkus UC 客户端上成功接收和发送消息。