配置 Bandwidth SMS 短信渠道
本文介绍如何在 Yeastar P 系列 IPPBX 上配置 Bandwidth SMS 短信渠道,以便企业坐席可以在 Linkus UC 客户端上接收并回复客户的 SMS 消息。
使用要求
Yeastar PBX 需满足以下要求:
- 固件版本:37.12.0.23 或更高版本
- 订阅服务:隧道服务 或 视频会议,保证 FQDN 功能可用。
- FQDN:确保 PBX 可通过 FQDN 访问。注: 由于第三方平台限制,FQDN 域名中不能包含下划线,否则消息渠道会出现验证失败或无法接收消息的问题。
有关 FQDN 配置的具体信息,请参见 通过 Yeastar FQDN 远程访问 PBX。
支持的消息类型和限制
- 支持的消息类型
- Bandwidth SMS 短信渠道支持发送文字消息和多媒体消息 (MMS),其中支持的 MMS 文件类型取决于
Bandwidth。更多信息,请参见 Bandwidth 支持的消息类型。重要: 发送多媒体消息 (例如图片) 时,SMS 运营商会通过 PBX 提供的链接下载文件。因此,如果你设置了 国家地区 IP 访问防御 安全规则,需确保 PBX 允许 SMS 运营商所在国家的 IP 访问,否则文件传输会失败。
- 限制
-
- 文件大小:最大 100 MB
- 文件保留时间:24 小时
前提条件
操作步骤
步骤一、在 PBX 上获取 Webhook URL
首先,从 PBX 管理网页上获取 Webhook URL,后续在 Bandwidth 上配置用于 SMS 的号码时需要用到此信息。
- 登录 PBX 管理网页,进入 。
- 点击 添加,选择 SMS。
- 在 运营商 下拉列表中,选择
Bandwidth。
PBX 对应生成一个 Webhook URL,并显示在 Webhook URL 字段中。
重要: 若离开当前页面,URL 将发生变化,请确保使用最新的 Webhook URL 在运营商的用户门户上进行配置。 - 记录 Webhook URL。
步骤二、在 Bandwidth 上配置用于 SMS 的号码
重要: 根据美国法规,用于“应用程序到个人 (Application-to-Person,
A2P)” 消息传送的 10 位 (10DLC) 电话号码必须进行注册,否则通过未注册的 10DLC 号码发送到美国号码的 SMS
消息将被拦截。
如果企业需要与美国客户联系,请与 SMS 服务运营商确认注册要求,并完成号码注册,以保证消息传送正常。
登录 Bandwidth,并完成以下配置:
- 使用子账号创建一个应用 (application),并使用 PBX 的 Webhook URL 设置回调地址 (Callback URL)。
- 在新建应用的详情页中,将应用与你的区域绑定。
- 为区域和绑定的应用启用 HTTP SMS 和 MMS 消息设置。
- 搜索要使用 SMS 的号码,并与你的子账号绑定。
- 记录下应用 ID (Application ID) 和账号 ID (Account ID),用于与 PBX 对接。
步骤三、在 PBX 上创建并配置 SMS 短信渠道
在 PBX 上创建一个 SMS 短信渠道,并使用从 Bandwidth 获取的认证信息和号码配置该渠道。- 登录 PBX 管理网页,进入 。
- 点击 添加,选择 SMS。
- 在 鉴权信息 栏,填写 Bandwidth 的鉴权信息。
- 名称:为渠道设置一个便于识别的名称。
- 运营商:选择 Bandwidth。
- Application ID:粘贴从 Bandwidth 获取的应用 ID。
- Account ID:粘贴从 Bandwidth 获取的账号 ID。
- 用户名:填写你的 Bandwidth 账号用户名。
- 密码:填写你的 Bandwidth 账号用户密码。
- 在 消息设置 页签,配置该渠道。
- 在 消息发送速率 栏,指定 PBX 每秒可发送多少条消息。注:
- 如果消息发送的速率超过此处设置的值,PBX 会将消息排队,并按照设置的速率发送。
- 如果设置的消息发送速率超过 SMS 运营商设置的速率,可能会导致消息发送失败。因此,请联系 SMS 运营商确认你的账户的发送速率限制,并根据需要提高限制。
- 可选: 如果你想要系统自动关闭在指定时间内无任何互动的会话,勾选 自动关闭会话,并在 会话超时时间 (天) 栏中设置超时时间。
- 在 号码 栏,点击
添加,添加消息路由规则。
- 号码:以 E.164 格式填写购买的号码
(
[+][国家区号][电话号码]
)。例如+14102161183
。 - 消息目的地:设置通过此号码送入的消息会被送往哪个目的地。
选项 说明 分机 若选择此项,需在 分机 下拉列表中选择接收消息的分机。 只有此分机用户可以接收到通过此号码送入的消息。
消息队列 若选择此项,需在 消息队列 下拉列表中选择接收消息的队列。 所选队列中的所有坐席都会收到队列中新会话的消息,但只有接管了会话的用户可以接收并回复后续送入的消息。
- 允许创建会话的分机:选择一个或多个分机,选择的分机可以向外部用户发送消息。
- 号码:以 E.164 格式填写购买的号码
(
- 点击 保存。
- 在 消息发送速率 栏,指定 PBX 每秒可发送多少条消息。
- 点击 保存。
执行结果
- 你已成功创建了消息渠道,可在列表中查看到此渠道的 状态 显示为 。
- 系统自动追踪并记录该渠道上发送和接收的消息数量,其中 总发送量
包含了发送成功和发送失败的所有消息数量。注:
- 对于发送消息,PBX 仅追踪坐席在其 Linkus UC 客户端上发送的消息数据。因此,如果你要计算准确的消息发送费用,需要和 SMS 运营商确认精准的消息发送数量,因为在发送的信息超过 160 个字符的情况下,运营商可能将消息拆分发送,并在到达客户手机时将消息整合,这会额外增加发送消息的数量。
- 可通过时间筛选查看指定时间段内的消息数据。
后续步骤
发送测试消息,确认指定的坐席是否可以在 Linkus UC 客户端上成功接收和发送消息。