配置 Twilio SMS 短信渠道

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

使用要求

Yeastar PBX 需满足以下要求：

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

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

支持的消息类型和限制

支持的消息类型
Twilio SMS 短信渠道支持文字消息和多媒体消息 (MMS)，其中支持的 MMS 文件类型取决于 Twilio。更多信息，请参见 Twilio 支持的 MMS 文件类型。
重要： 发送多媒体消息 (例如图片) 时，SMS 运营商会通过 PBX 提供的链接下载文件。因此，如果你设置了 国家地区 IP 访问防御 安全规则，需确保 PBX 允许 SMS 运营商所在国家的 IP 访问，否则文件传输会失败。
限制
  • 文件大小：最大 100 MB
  • 文件保留时间：24 小时

操作步骤

步骤一、在 PBX 上获取 Webhook URL

首先，从 PBX 管理网页上获取 Webhook URL，后续在 Twilio 上配置用于 SMS 的号码时需要用到此信息。
  1. 登录 PBX 管理网页，进入 讯息管理 > 消息渠道。
  2. 点击 添加，选择 SMS。
  3. 在 运营商 下拉列表中，选择 Twilio。

    PBX 对应生成一个 Webhook URL，并显示在 Webhook URL 字段中。

    重要： 若离开当前页面，URL 将发生变化，请确保使用最新的 Webhook URL 在 Twilio 上进行配置。

  4. 记录 Webhook URL。

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

重要： 根据美国法规，用于“应用程序到个人 (Application-to-Person, A2P)” 消息传送的 10 位 (10DLC) 电话号码必须进行注册，否则通过未注册的 10DLC 号码发送到美国号码的 SMS 消息将被拦截。

如果企业需要与美国客户联系，请与 SMS 服务运营商确认注册要求，并完成号码注册，以保证消息传送正常。

登录 Twilio，并完成以下配置：
  1. 搜索并购买具有短信功能的号码。

  2. 编辑购买的号码，使用 PBX 的 Webhook URL 配置消息 Webhook。

  3. 启用指定区域的地理权限，以保证消息可以成功发送到该区域的号码上。
    注： 此设置需在主账号中进行。

  4. 进入你的账号的仪表盘，记录 Account SID 和 Auth Token，后续在 PBX 上需要使用到这些信息。
    注： 此账号必须为用于购买号码的账号，即，如果使用子账号购买号码，则需要进入子账号的仪表盘获取信息。

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

在 PBX 上创建一个 SMS 短信渠道，并使用从 Twilio 获取的认证信息和号码配置该渠道。
  1. 登录 PBX 管理网页，进入 讯息管理 > 消息渠道。
  2. 点击 添加，选择 SMS。
  3. 在 鉴权信息 栏，填写 Twilio 的鉴权信息。
  4. 在 消息设置 页签，配置该渠道。
    1. 在 消息发送速率 栏，指定 PBX 每秒可发送多少条消息。
      注：
      • 如果消息发送的速率超过此处设置的值，PBX 会将消息排队，并按照设置的速率发送。
      • 如果设置的消息发送速率超过 SMS 运营商设置的速率，可能会导致消息发送失败。因此，请联系 SMS 运营商确认你的账户的发送速率限制，并根据需要提高限制。
    2. 可选： 如果你想要系统自动关闭在指定时间内无任何互动的会话，勾选 自动关闭会话，并在 会话超时时间 (天) 栏中设置超时时间。

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

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

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

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

执行结果

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

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

后续步骤

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