配置 VoIP.ms SMS 短信渠道
本文介绍如何在 Yeastar P 系列软件版 上配置 VoIP.ms SMS 短信渠道,以便企业坐席可以在 Linkus UC 客户端上接收并回复客户的 SMS 消息。
使用要求
Yeastar PBX 需满足以下要求:
- 固件版本:83.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 消息被拦截。
操作步骤
- 登录 PBX 管理网页,进入 。
- 点击 添加,选择 SMS。
- 在 鉴权信息 栏,完成以下设置。
- 名称:为渠道设置一个便于识别的名称。
- 运营商:选择 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 具体设置,请联系运营商。
- 在 消息设置 页签,配置该渠道。
- 在 消息发送速率 栏,指定 PBX 每秒可发送多少条消息。注:
- 如果消息发送的速率超过此处设置的值,PBX 会将消息排队,并按照设置的速率发送。
- 如果设置的消息发送速率超过 SMS 运营商设置的速率,可能会导致消息发送失败。因此,请联系 SMS 运营商确认你的账户的发送速率限制,并根据需要提高限制。
- 可选: 如果你想要系统自动关闭在指定时间内无任何互动的会话,勾选 自动关闭会话,并在 会话超时时间 (天) 栏中设置超时时间。
- 在 号码 栏,点击
添加,添加消息路由规则。
- 号码:以 E.164 格式填写购买的号码
(
[+][国家区号][电话号码]
)。例如+14102161183
。 - 消息目的地:设置通过此号码送入的消息会被送往哪个目的地。
选项 说明 分机 若选择此项,需在 分机 下拉列表中选择接收消息的分机。 只有此分机用户可以接收到通过此号码送入的消息。
消息队列 若选择此项,需在 消息队列 下拉列表中选择接收消息的队列。 所选队列中的所有坐席都会收到队列中新会话的消息,但只有接管了会话的用户可以接收并回复后续送入的消息。
- 允许创建会话的分机:选择一个或多个分机,选择的分机可以向外部用户发送消息。
- 号码:以 E.164 格式填写购买的号码
(
- 点击 保存。
- 在 消息发送速率 栏,指定 PBX 每秒可发送多少条消息。
- 点击 保存。
执行结果
- 你已成功创建了消息渠道,可在列表中查看到此渠道的 状态 显示为 。
- 系统自动追踪并记录该渠道上发送和接收的消息数量,其中 总发送量
包含了发送成功和发送失败的所有消息数量。注:
- 对于发送消息,PBX 仅追踪坐席在其 Linkus UC 客户端上发送的消息数据。因此,如果你要计算准确的消息发送费用,需要和 SMS 运营商确认精准的消息发送数量,因为在发送的信息超过 160 个字符的情况下,运营商可能将消息拆分发送,并在到达客户手机时将消息整合,这会额外增加发送消息的数量。
- 可通过时间筛选查看指定时间段内的消息数据。
后续步骤
发送测试消息,确认指定的坐席是否可以在 Linkus UC 客户端上成功接收和发送消息。