检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修改短信签名 功能介绍 该接口用于用户修改短信签名信息,目前仅支持审核不通过的短信签名重新修改。 URI PUT /v1/sms/signatures/{signature_id} 表1 路径参数 参数 是否必选 参数类型 描述 signature_id 是 String 签名ID
更新服务号信息 功能介绍 支持用户更新服务号信息。 URI POST /v1/aim-sa/pubs/{pub_id} 表1 路径参数 参数 是否必选 参数类型 描述 pub_id 是 String 服务号ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述
删除短信模板 功能介绍 该接口用于用户删除已创建的短信模板。 URI DELETE /v1/sms/templates/{template_id} 表1 路径参数 参数 是否必选 参数类型 描述 template_id 是 String 短信模板ID。 请求参数 表2 请求Header
获取短信应用详情 功能介绍 该接口用于用户获取已创建的短信应用详情。 URI GET /v1/sms/apps/{app_id} 表1 路径参数 参数 是否必选 参数类型 描述 app_id 是 String 应用ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型
定义模板状态回执 功能介绍 用户按接口定义实现模板状态回执接口。 响应参数仅供参考,客户可以返回任意响应消息给平台,平台不会对响应消息处理。 URI POST /v1/aim/template-status 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type
常用操作与系统策略的关系 智能信息、智能信息基础版、智能信息服务号列出了KooMessage常用操作与系统策略的授权关系,您可以参照该表选择合适的系统策略。 “√”表示支持,“x”表示暂不支持。 智能信息 表1 KooMessage智能信息操作与系统策略关系 操作 KooMessage
新建智能信息基础版模板 功能介绍 支持用户通过此接口创建智能信息基础版模板。 URI POST /v1/aim-basic/templates 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为
定义智能信息基础版模板状态回执 功能介绍 用户按接口定义实现智能信息基础版模板状态回执接口。 响应参数仅供参考,客户可以返回任意响应消息给平台,平台不会对响应消息处理。 URI POST /v1/aim-basic/template-status 请求参数 表1 请求Body参数
权限和授权项 如果您需要对您所拥有的云消息服务进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)。如果华为云账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用云消息服务的其它功能
发送智能信息基础版任务 功能介绍 支持用户通过此接口进行智能信息基础版任务发送。 URI POST /v1/aim-basic/send-tasks 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 KM.00001075 短信签名为空 短信签名为空 请检查并在更改错误参数后重试 400 KM.00001076 短信签名的长度范围在1
KooMessage自定义策略 如果系统预置的KooMessage权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参考《KooMessage API参考》中“ 权限策略和授权项”章节。目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略
创建用户并授权使用KooMessage 如果您需要对您所拥有的KooMessage进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),通过IAM,您可以: 根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建
发送分批短信 功能介绍 该接口用于向不同用户发送不同内容的短信。 前提条件 已创建短信应用。 已申请短信签名,获取签名通道号。 已申请短信模板,获取模板ID。 注意事项 单条短信最多允许携带500个号码,每个号码最大长度为21位。 URI POST /v1/aim/sms/diff-messages
发送短信 功能介绍 向单个或多个用户发送相同内容的短信。 前提条件 已创建短信应用。 已申请短信签名,获取签名通道号。 已申请短信模板,获取模板ID。 注意事项 最多允许携带500个号码,每个号码最大长度为21位。 URI POST /v1/aim/sms/messages 请求参数
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证调用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。 Token认证 Token的有效期为24小时,需要使用一个
定义智能信息发送回执 功能介绍 用户按接口定义实现智能信息发送回执接口。 用户每次发送智能信息时,将接收到最新的状态上报。发送智能信息无论成功或失败都会上报callback_type为sms的回执;只有解析成功才会上报callback_type为shortchain的回执。 响应参数仅供参考
总体开发思路 渲染模板预览视图所需的数据保存在pages字段中。调用智能信息模板查询API接口获取pages字段,经多个前端组件开发后,即可渲染出适配于自用平台的预览视图。总体开发流程如图1所示。 图1 将模板数据渲染成预览视图的开发流程 关键阶段介绍 调用查询模板API,获取pages
查看支持智能信息解析的终端机型 使用KooMessage服务时,只有表1中的终端机型,才可以接收到解析消息。 如果发现有不在机型表格且支持AIM能力的机型,或者发现机型表格里有不支持AIM能力的机型,请联系售前或运营人员。 VIVO高端机系列暂不支持红包版式。 表1 KooMessage
开始使用 智能信息认证企业信息 在KooMessage控制台的左侧导航栏中,单击“企业管理 > 企业备案”,进入“企业备案管理”界面。 在“智能信息”区域,单击“填写发送任务备案信息”或“填写生成短链备案信息”。 图1 智能信息企业备案 根据需要,上传企业证件信息。具体参数填写请参考表