配置 Aspsms SMS 短信渠道

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

使用要求

Yeastar PBX 需满足以下要求：
  • 固件版本：37.21.0.117 或更高版本
  • 订阅服务：隧道服务
  • 域名：确保 PBX 可通过域名远程访问。
    注：
    • 由于第三方平台限制，域名中不能包含下划线，否则消息渠道会出现验证失败或无法接收消息的问题。
    • 如果你使用自己定义和管理的域名，则需确保已为域名安装有效的域名证书，否则消息渠道会出现验证失败或无法接收消息的问题。
    有关域名配置的具体说明，请参见以下文章：

使用限制

Aspsms 短信渠道仅支持文字消息。

前提条件

你持有 Aspsms 账号，且已从 Aspsms 购买用于收发 SMS 短信的电话号码。
重要： 根据美国法规，用于“应用程序到个人 (Application-to-Person, A2P)” 消息传送的 10 位 (10DLC) 电话号码必须进行注册，否则通过未注册的 10DLC 号码发送到美国号码的 SMS 消息将被拦截。如果企业需要与美国客户联系，请与 SMS 服务运营商确认号码注册相关事项，以保证消息传送正常。

操作步骤

步骤一、在 PBX 上获取 Wehbook URL

首先，从 PBX 管理网页上获取 Webhook URL，后续在 Aspsms 上配置用于 SMS 的号码时需要用到此信息。
  1. 登录 PBX 管理网页，进入 讯息管理 > 消息渠道。
  2. 点击 添加，选择 SMS。
  3. 在 运营商 下拉列表中，选择 Aspsms，然后选择并复制 Webhook URL。
    重要： 若离开当前页面，URL 将发生变化，请确保使用最新的 Webhook URL 在运营商的用户门户上进行配置。

步骤二、在 Aspsms 上配置用于 SMS 号码

在 Aspsms 平台中配置你购买的用于短信收发的号码，并获取渠道集成所需的凭证。
  1. 登录 Aspsms 平台。
  2. 在左侧导航栏，进入 Two-Way SMS > My Mobile Numbers，然后点击号码旁的 Edit。

  3. 下拉至 Forward SMS as HTTP raw data 栏，然后根据 PBX 的 webhook URL 完成回调配置，以便 PBX 接收发送至此号码的 SMS 消息。

    1. 在 protocol://HOST 字段，填写从 PBX webhook URL 中提取的协议和域名。如 https://yeastardocs.ras.yeastar.com 。
    2. 在 HEADER 字段，输入以下 HTTP 请求模板，并将变量替换为 PBX 具体的 Webhook 信息。
      POST {{Webhook Path}} HTTP/1.1      
Content-type: application/json
Host: {{PBX domain}}                
Connection: keep-alive
Content-Length: <ContentLength>
Accept: application/json
Content-Type: application/json
Accept: text/*
      • {{Webhook Path}}：填写 PBX webhook URL 中的路径。

        例如，PBX webhook URL 为 https://yeastardocs.ras.yeastar.com/api/v1.0/webhook/aspsms/091e568fec824f52bb9e83abe68f7693 ，则 {{Webhook Path}} 为 /api/v1.0/webhook/aspsms/091e568fec824f52bb9e83abe68f7693。

      • {{PBX domain}}：填写从 PBX webhook URL 中提取的域名 (不带 https:// 前缀)。
    3. 在 BODY 字段，粘贴以下代码。
      {
   "MessageDataHex":"<MessageDataHex>",
   "Recipient":"<Recipient>",
   "Originator":"<Originator>",
   "DateReceived":"<DateReceived>"
}
    4. 点击 Save 以保存设置。
  4. 获取用于消息渠道集成的 API 凭证。
    1. 进入 Registered Users > API Credentials。
    2. 记录下 Userkey 和 API Password，后续在 PBX 上配置渠道时需要使用此信息。

步骤三、在 PBX 上创建和配置 SMS 短信渠道

在 PBX 上创建 SMS 短信渠道，并使用从 Aspsms 获取的凭证和号码完成配置。

  1. 登录 PBX 管理网页，进入 讯息管理 > 消息渠道。
  2. 点击 添加，选择 SMS。
  3. 在 鉴权信息 栏，填写 Aspsms 的鉴权信息。

  4. 在 消息设置 页签，配置该渠道。
    1. 在 消息发送速率 栏，指定 PBX 每秒可发送多少条消息。
      注：
      • 如果消息发送的速率超过此处设置的值，PBX 会将消息排队，并按照设置的速率发送。
      • 如果设置的消息发送速率超过 SMS 运营商设置的速率，可能会导致消息发送失败。因此，请联系 SMS 运营商确认你的账户的发送速率限制，并根据需要提高限制。
    2. 可选： 如果你想要系统自动关闭在指定时间内无任何互动的会话，勾选 自动关闭会话，并在 会话超时时间 (天) 栏中设置超时时间。

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

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

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

        所选队列中的所有坐席都会收到队列中新会话的消息，但只有接管了会话的用户可以接收并回复后续送入的消息。
        第三方分析平台（消息通过二次开发接口传递） 若选择此项，通过此号码送入的消息会通过 API 转发到第三方消息分析平台进行进一步分析或处理。
        注： 要实现入站消息自动转发至第三方消息分析平台，需确保 PBX 系统已经通过 API与第三方消息分析平台对接。选择此选项后，PBX 系统就会自动将收到的消息发送到指定平台。你可以通过监控 API 事件 (30031) 新消息通知获取相关事件通知。此外，PBX 提供了完整的讯息管理 API 接口，可用于与对接的第三方消息分析平台进行进一步的消息交互。
      • 允许创建会话的分机：选择一个或多个分机，选择的分机可以向外部用户发送消息。
    4. 点击 保存。
  5. 点击 保存。

执行结果

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

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

后续步骤

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