自动化规则
自动化规则是用来监控SIM卡和流量池的相关信息,并在满足条件时按照设置的周期发送短信或者邮件通知到您。当前提供实体卡到期前天数、SIM卡已用流量和剩余流量、流量池已用流量和剩余流量这几种监控方式。
创建规则
登录全球SIM联接控制台,在左侧选择“自动化规则”进入自动化规则列表页面,单击“创建规则”进入创建自动化规则页面。
参数名称 |
说明 |
---|---|
规则名称 |
自定义规则的名称,便于管理。 |
规则类型 |
规则的类型包括订单管理、用量监控、卡状态变更监控、流量池监控。 |
触发器 |
触发器的类型分为五种情况:
|
触发条件 |
触发条件的类型分为三种情况:
|
执行 |
选择规则触发后的通知方式,包括短信&邮件或API推送。 |
筛选器 |
筛选器类型分为四种情况(默认情况下是监控您平台的所有SIM卡):
|
规则执行记录
登录全球SIM联接控制台,在左侧选择“自动化规则”,选择“规则执行记录”页签进入规则执行记录页面。
规则执行记录页面显示所有规则执行记录,您可以查看有哪些卡触发了规则以及触发条件和接收到通知的邮箱地址或短信。
推送地址管理
登录全球SIM联接控制台,在左侧导航栏选择 ,选择 页签,单击“新增推送地址”,按照下表参数说明填写相关信息后,单击“测试”。
推送地址管理页面显示全部的推送地址信息,您可以查看并管理已有的推送地址。
参数名称 |
参数说明 |
---|---|
推送地址 |
推送地址的url。 |
上传证书 |
上传 url 对应的服务端证书(.pem格式)。 |
API推送报文
推送body参数
参数 |
参数类型 |
描述 |
---|---|---|
cid |
string |
容器ID。 |
ruleType |
int |
规则类型:
|
templateName |
string |
模板名称:
|
templateParams |
list |
模板参数集合,建议按照key值进行解析,后续可能会添加其他key值。 |
SIM卡套餐到期(api_rule_price_plan_expired)
【全球SIM联接】尊敬的{accountName}客户,您好!{cid}购买的套餐{pricePlanName}将在{daysToExpire}天后过期,请及时续费。
{ "cid": "4441380627973120", "ruleType": 1, "templateName": "api_rule_price_plan_expired", "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "poolId", "value": "0" }, { "key": "daysToExpire", "value": "9" } ] }
周期累计数据用量(api_rule_flow_usage_remain)
【全球SIM联接】尊敬的{accountName}客户,您好!您的SIM卡(容器ID:{cid})购买的套餐({pricePlanName})剩余流量已不足{remainFlow}MB,请合理使用,需要避免流量达量断网。
{ "cid": "4441380627973120", "ruleType": 1, "templateName": "api_rule_flow_usage_remain", "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "remainFlow", "value": "100" } ] }
卡状态变更(api_rule_sim_status_modify)
【全球SIM联接】尊敬的{accountName}客户,您好!您的SIM卡(容器ID:{cid})状态于{modifyTime}由{oldStatus}变为{newStatus}。
{ "cid":"2021080621060000T", "ruleType":4, "templateName":"api_rule_sim_status_modify", "templateParams":[ { "key":"cid","value":"2021080621060000T" }, { "key":"modifyTime","value":"2022-05-16 03:24:08" }, { "key":"oldStatus","value":"未激活" }, { "key":"newStatus","value":"可激活" } ] }
流量池周期累计数据用量(api_sim_pool_rule_flow_usage_remain)
【全球SIM联接】尊敬的{accountName}客户,您好!{poolId}流量池名:{poolName},套餐名称:{pricePlanName},已用流量{remainFlow}MB,请合理使用,需要避免达量断网。
{ "cid": "4441380627973120", "ruleType": 1, "templateName": "api_sim_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "remainFlow", "value": "100" } ] }
前向流量池邮件发送模板(sim_pool_rule_flow_usage)
【华为云】尊敬的{Account}客户,您好!您的前向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})已用流量{usageFlow}MB,请合理使用,需要避免流量达量断网。
{ "cid": "null", "ruleType": 3, "templateName": "api_back_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国电信消费级阶梯流量池联接服务" }, { "key": "usageFlow", "value": "100" } ] }
前向流量池邮件发送模板(sim_pool_rule_flow_usage_remain)
【华为云】尊敬的{Account}客户,您好!您的前向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})剩余流量{remainFlow}MB,请合理使用,需要避免流量达量断网。
{ "cid": "4441380627973120", "ruleType": 1, "templateName": "api_sim_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "remainFlow", "value": "100" } ] }
后向流量池邮件发送模板(back_pool_rule_flow_usage)
【华为云】尊敬的{Account}客户,您好!您的后向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})已用流量{usageFlow}MB,请合理使用,避免产生过量的费用。
{ "cid": "null", "ruleType": 3, "templateName": "api_back_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国电信消费级阶梯流量池联接服务" }, { "key": "usageFlow", "value": "100" } ] }
后向流量池周期累计数据用量API推送模板(api_back_pool_rule_flow_usage)
【华为云】尊敬的{Account}客户,您好!您的后向流量池(流量池号:{poolId}, 流量池名称:{poolName},套餐名称: {pricePlanName})已用流量{usageFlow}MB,请合理使用,避免产生过量的费用。
{ "cid": "null", "ruleType": 3, "templateName": "api_back_pool_rule_flow_usage_remain", "templateParams": [ { "key": "poolId", "value": "4441380627973120" }, { "key": "poolName", "value": "xx流量池" }, { "key": "pricePlanName", "value": "中国电信消费级阶梯流量池联接服务" }, { "key": "usageFlow", "value": "100" } ] }
API合并推送报文
推送body参数
参数 |
参数类型 |
描述 |
---|---|---|
ruleType |
int |
规则类型:
|
templateName |
string |
模板名称: api_rule_price_plan_expired:SIM卡套餐到期模板。 api_rule_flow_usage_remain:周期累计数据用量模板。 api_rule_sim_status_modify:卡状态变更模板。 |
templateParamsList |
array |
包含多个卡信息的模板参数集合,最多包含500张卡的信息。 |
templateParamsList.templateParams |
array |
单个卡信息的模板参数集合,建议按照key值进行解析,后续可能会添加其他key值。 |
{ "ruleType": 1, "templateName": "api_rule_price_plan_expired", "templateParamsList": [ { "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "daysToExpire", "value": "9" } ] }, { "templateParams": [...] } ... ] }
周期 累计数据用量(api_rule_flow_usage_remain)报文示例
{ "ruleType": 2, "templateName": "api_rule_flow_usage", "templateParamsList": [ { "templateParams": [ { "key": "cid", "value": "4441380627973120" }, { "key": "pricePlanName", "value": "中国移动每月30M联接服务" }, { "key": "usageFlow", "value": "100" } ] }, { "templateParams": [...] } ... ] }
卡状态变更(api_rule_sim_status_modify)报文示例
{ "ruleType": 4, "templateName": "api_rule_sim_status_modify", "templateParamsList": [ { "templateParams": [ { "key": "cid", "value": "2021080621060000T" }, { "key": "modifyTime", "value": "2022-05-16 03:24:08" }, { "key": "oldStatus", "value": "未激活" }, { "key": "newStatus", "value": "可激活" } ] }, { "templateParams": [...] } ... ] }
API推送失败提醒
用户只有在自动化规则选了API推送,且开启了推送失败提醒,当推送失败,消息中心会收到提醒信息。
自动化规则API推送失败提醒示例:
尊敬的{accountName}客户, 您好!您配置的自动化规则{ruleName},在{pushTime}执行API推送时失败,推送地址: {pushUrl},推送内容请查看附件。 本邮件由华为全球SIM联接系统自动发送,请勿直接回复! 感谢您的配合与支持!
- 用户如果选择了API推送,并且勾选了“合并发送”,推送的报文与没有勾选“合并发送”的报文不同。
- 当前流量池周期累计数据用量不支持合并推送。
- 附件内容为推送失败的报文内容。