配置 Apidaze SMS 短信渠道

使用要求

Yeastar PBX 需满足以下要求：

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

支持的消息类型

Apidaze SMS 短信渠道支持发送文字消息和多媒体消息 (MMS)，其中支持的 MMS 文件类型取决于 Apidaze。

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

限制

向 Apidaze SMS 运营商获取以下信息：

登录 PBX 管理网页，进入讯息管理 > 消息渠道。
点击添加，选择 SMS。
在鉴权信息栏，填写 Apidaze 的鉴权信息。
- 名称：为渠道设置一个便于识别的名称。
- 运营商：选择 Apidaze。
- API Key：输入从 Apidaze 获取的 API key。
- Secret：输入从 Apidaze 获取的 Secret。

在消息设置栏，配置该渠道。

在消息发送速率栏，指定 PBX 每秒可发送多少条消息。
注：
- 如果消息发送的速率超过此处设置的值，PBX 会将消息排队，并按照设置的速率发送。
- 如果设置的消息发送速率超过 SMS 运营商设置的速率，可能会导致消息发送失败。因此，请联系 SMS 运营商确认你的账户的发送速率限制，并根据需要提高限制。
可选： 如果你想要系统自动关闭在指定时间内无任何互动的会话，勾选自动关闭会话，并在会话超时时间 (天) 栏中设置超时时间。
在聊天文件的附带文本字段，指定发送聊天文件时附带的默认文本内容。
消息接收方将会看到该文本与聊天文件一起显示。

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

号码：填写购买的号码，或指定字母数字发件人 ID。
注：若填写号码，则需以 E.164 格式填写 ([+][国家区号][电话号码])。例如 +14102161183。

消息目的地：设置通过此号码送入的消息会被送往哪个目的地。


选项	说明
分机	若选择此项，需在分机下拉列表中选择接收消息的分机。只有此分机用户可以接收到通过此号码送入的消息。
消息队列	若选择此项，需在消息队列下拉列表中选择接收消息的队列。所选队列中的所有坐席都会收到队列中新会话的消息，但只有接管了会话的用户可以接收并回复后续送入的消息。

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

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