云服务器内容精选

  • 创建模板 模板不能留有空帧。 短链前后都需加一个空格符号。 模板需包含文字,且不能为纯文字、纯图片、纯音频或纯视频。 根据运营商要求,模板需在0KB-1.9MB之间。 除签名外,内容中不能包含“【】”或“[]”符号。 免流、退订、取关、回退、关闭通知等贴尾信息由系统自动添加, 模板内不能含有贴尾字样。 主题中请勿输入【】或双引号,尽量避免使用特殊符号。 在“我的模板”页签,单击“新建模板”,进入到“创建模板”页面。可以单击“新建空白模板”,或选择其他9个不同的模板类型进行编辑。以下以“新建空白模板”为例。 插入“文本”、“图片”、“音频”或“视频”。 最多可插入“文本”、“图片”、“音频”或“视频”的总数为8个。 单击页面左侧的“文本”按钮,单击“插入文本”,可以对模板进行文本插入。 在模板的“去输入主题”框内,输入模板主题。 在页面右侧,单击“插入参数”按钮,可以在文本框内插入参数。 最多可插入12个参数。 需要几个参数,在此处插入几个参数,参数内容在发送信息时的手机号码Excel中进行设置。具体设置请参考:发送智能信息基础版中的说明内容。 单击文本框,左侧会出现操作栏: 单击文本框左侧,对文本内容进行位置调整; 单击文本框左侧,对文本框进行删除。 单击页面左侧的“图片”按钮,可以对模板进行图片插入。 在“公共”和“我的”列表中可以选择想要的图片。若没合适的图片,可在“我的”列,单击“网页提取”或“上传本地”,获取合适的图片。还可单击“批量操作”,对图片进行批量操作。 图片要求为: 最大文件大小2M 支持的格式:jpg/jpeg/png/gif 水平图像建议:1920*1080 垂直图像建议:962*1300 图片高度不应超过3000px 若为“网页提取”图片,则URL最大长度:1024个字符。 单击图片,在页面右侧会出现“编辑图片”,单击“从本地上传”可以从本地上传图片,单击“裁剪图片”,可对图片进行裁剪。 单击图片,左侧会出现操作栏: 单击图片左侧,对图片增加描述;再次单击图片左侧,对图片描述进行删除; 单击图片左侧,对增加的描述位置进行上下调整; 单击图片左侧,对图片位置进行调整; 单击图片左侧,对图片进行删除。 单击页面左侧的“音频”按钮,可以对模板进行音频插入。 在“公共”和“我的”列表中可以选择想要的音频。若没合适的音频,可在“我的”列,单击“从本地”,获取合适的音频。还可单击“批量操作”,对音频进行批量操作。 音频要求为: 最大文件大小2M 支持的格式:mp3/wav 文件名不能超过100个字符(包括扩展名) 单击音频,在页面右侧会出现“编辑视频”,单击“”可以从本地上传视频,单击“”,可以对视频进行裁剪。 单击音频,左侧会出现操作栏: 单击音频左侧,对音频增加描述;再次单击音频左侧,对音频描述进行删除; 单击音频左侧,对增加的描述位置进行上下调整; 单击音频左侧,对音频位置进行调整; 单击音频左侧,对音频进行删除。 单击页面左侧的“视频”按钮,可以对模板进行视频插入。 在“公共”和“我的”列表中可以选择想要的视频。若没合适的视频,可在“我的”列,单击“从本地上传视频”,获取合适的视频。还可单击“批量操作”,对视频进行批量操作。 视频要求为: 最大文件大小2M 支持的格式:mp4/3gp 视频长度建议不超过33秒 文件名不能超过100个字符(包括扩展名) 单击视频,在页面右侧会出现“编辑视频”,单击“上传本地视频”可以从本地上传视频;单击“裁切封面”,可以设置视频封面;单击“上传封面”,可以上传本地封面。 单击视频,左侧会出现操作栏: 单击视频左侧,对视频增加描述;再次单击视频左侧,对视频描述进行删除; 单击视频左侧,对增加的描述位置进行上下调整; 单击视频左侧,对视频位置进行调整; 单击视频左侧,对视频进行删除。 单击页面右上角的“预览”按钮,弹出“预览”框,在“预览”框处可查看“苹果”、“华为”、“小米”、“OPPO”或“vivo”的展示效果。 若创建模板出现问题,则会弹出“VMS自动检测”框,根据提示,单击“返回修改”,对创建的模板进行修改。 苹果机型不可显示详情页。 确认无误后,在“预览”框上单击“确定”。 单击页面右上角的“保存”按钮,可以对创建的个人模板进行保存。 单击页面右上角的“提交审核”按钮,输入“模版名称”、“ 有效期 (日)”并选择“签名”和“通道配置”,单击“确定”进行模板审核提交,完成模板创建。
  • 查询模板 公共模板 方法一: 在页面右上角的选择框内,选择“模板名称”或“模板id”后,输入对应的内容进行筛选。 方法二: 根据“模板类型”进行筛选。 模板类型为:“全部”、“静态(不带参数)”和“动态(带参数)”。 鼠标移动到审核通过的模板上,会出现“发送信息”和“预览”这两个菜单,根据自己的需要进行选择。 选择“发送信息”,则可直接跳转到“发送信息”页面,然后根据3进行参数填写后,单击“发送”。 选择“预览”,弹出“预览模板”对话框,单击“发送信息”后跳转到“发送信息”页面,然后根据3进行参数填写后,单击“发送”。 我的模板 方法一: 在页面右上角的选择框内,选择“模板名称”或“模板id”后,输入对应的内容进行筛选。 方法二: 根据“模板类型”和“审核状态”进行筛选。 模板类型为:“全部”、“静态(不带参数)”和“动态(带参数)”。 审核状态为:“全部”、“审核中”、“已禁用”、“通过”、“审核不通过”、“已过期”和“草稿”。 仅显示过期6个月内模板,可进行复制、修改操作,重新进入审核流程。 鼠标移动到审核通过的模板上,会出现“发送信息”、“预览”、“复制”、和“删除”等菜单,根据自己的需要进行选择。 选择“发送信息”,则可直接跳转到“发送信息”页面,然后根据3进行参数填写后,单击“发送”。 选择“预览”,弹出“预览模板”对话框,单击“发送信息”后跳转到“发送信息”页面,然后根据3进行参数填写后,单击“发送”。 在“预览模板”对话框中可以查看“审核状态”,也可单击按钮,删除模板。 在“预览模板”对话框中可以查看“模板状态”,可以查看模板是否启用或禁用。 选择“复制”,可直接跳转到“创建模板”页面,复制此模板。 选择“删除”,弹出“删除模板确认提示”对话框,单击“确认”进行模板删除。 审核状态为“审核中”的模板,不能进行模板删除。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 status String 请求状态,固定200。 message String 状态描述。 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。 状态码: 500 表5 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:0 最大长度:2000 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json。 表2 请求Body参数 参数 是否必选 参数类型 描述 url_type 是 Integer 回调类型。 0:发送状态回执 1:上行消息回执 callback_url 是 String 回调地址,必须是http或https开头的字符串,不能为空。 说明: 建议使用https。 最小长度:1 最大长度:1000 remark 否 String 备注。 最小长度:0 最大长度:1000
  • 请求示例 智能信息基础版模板状态回执。模板ID为"800000001",模板截止有效日期为"20200131",模板审核状态正常可用;运营商审核正常可用为"cucc",模板已过期为"cmcc",审核不通过为"ctcc"。 https:// koomessage.myhuaweicloud.cn/v1/aim-basic/template-status { "tpl_id" : "800000001", "tpl_size" : 102311, "valid_time" : 20200131, "audit_state" : 0, "restags" : "三网一般", "audit_desc" : "正常可用", "status_detail" : [ { "carrier" : "cmcc", "status" : 5, "desc" : "正常可用" }, { "carrier" : "cucc", "status" : 0, "desc" : "正常可用" }, { "carrier" : "ctcc", "status" : 2, "desc" : "审核不通过,携带敏感词汇" } ], "preview_url" : "http://example.com/000001", "tpl_name" : "模板名称", "title" : "模板主题", "tpl_sign" : "华为 云消息 ", "create_time" : "2022-01-01T00:00:00Z", "var_info" : [ { "name" : "#p_1#", "type" : "txt" }, { "name" : "#p_2#", "type" : "txt" } ] }
  • 请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 tpl_id 否 String 智能信息基础版模板ID。 tpl_size 否 String 智能信息基础版模板的大小。 说明: 单位:字节,audit_status非0时tpl_size为0。 valid_time 否 String 模板截止有效日期,格式:yyyy-MM-ddTHH:mm:ssZ,0:表示永久有效。样例:2020-01-31T23:59:59Z。 audit_state 否 String 智能信息基础版模板审核状态。 0:正常可用 1:审核中 2:审核不通过 3:模板已禁用 4:模板不存在 5:模板已过期 audit_desc 否 String 智能信息基础版模板状态的描述,若状态是审核不通过或被禁用,描述表示的是不通过或禁用的原因。 说明: 长度不超过 1024 字。 status_detail 否 Array of StatusDetail objects 运营商的模板状态详情。 preview_url 否 String 智能信息基础版模板预览地址。 tpl_name 否 String 智能信息基础版模板名称。 title 否 String 智能信息基础版模板主题。 tpl_sign 否 String 智能信息基础版模板签名。 create_time 否 String 智能信息基础版模板创建时间,格式:yyyy-MM-ddTHH:mm:ssZ。 var_info 否 Array of VarInfo objects 智能信息基础版模板动参信息,静态模板没有动参,该字段填空。 restags 否 String 资源分配标签,取值如下: 三网一般 三网抗诉 单网一般 单网抗诉 表2 StatusDetail 参数 是否必选 参数类型 描述 carrier 否 String 运营商类型。 cmcc:中国移动 cucc:中国联通 ctcc:中国电信 oversea:港澳台及国外 unknown:未知 status 否 String 模板状态。 0:正常可用 1:审核中 2:审核不通过 3:模板已禁用 4:模板不存在 5:模板已过期 desc 否 String 对模板状态的描述。 说明: 若状态是审核不通过或被禁用,描述表示的是不通过或禁用的原因。 表3 VarInfo 参数 是否必选 参数类型 描述 name 否 String 动参变量占位符名称。 说明: 格式:#p_N#(N表示第几个参数,与模板文件占位名称保持一致),如:#p_1#。 type 否 String 动参变量类型。类型为文字:txt。
  • 请求示例 上行消息回执 https://koomessage.myhuaweicloud.cnvms/reply-callback{ "seq_id" : "0a96a1ac07a34e80b0e70569595e2c03", "result" : [ { "task_id" : "0cad5a1c-f018-45a1-96ae-782804417e74", "mobile" : "131****0000", "rtime" : "2022-11-06 20:38:33", "content" : "Hello+everyone" }, { "task_id" : "0cad5a1c-f018-45a1-96ae-782804417e74", "mobile" : "131****0001", "rtime" : "2022-11-06 20:38:33", "content" : "It%2Cs+late" } ]}
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json。 表2 请求Body参数 参数 是否必选 参数类型 描述 seq_id 否 String 本次推送请求唯一标识。 result 否 Array of MsgReply objects 上行消息回执列表。 表3 MsgReply 参数 是否必选 参数类型 描述 task_id 否 String 智能信息基础版发送任务ID。 mobile 否 String 手机号,11位纯数字手机号码。样例:131****0000。 content 否 String 回复内容。 rtime 否 String 上行消息返回时间。格式:YYYY-MM-DD HH:MM:SS。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 tplid String 智能信息基础版模板ID。 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 结果状态码。 error_msg String 结果详情。
  • 请求示例 新建模板 https://koomessage.myhuaweicloud.cn/v1/aim-basic/templates{ "tpl_name" : "测试-路由器推广", "title" : "测试主题", "reslist" : [ { "type" : "txt", "name" : "广告文本", "source" : "txt", "content" : "【华为云】测试-尊敬的#p_1#你好,最新路由器出来啦" }, { "type" : "jpg", "name" : "one.jpg", "source" : "file", "content" : "iVBORw0KGgoAAAANSUhEUgAAAKoAAABOCAYAAACwo40WAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2Fy..." }, { "type" : "jpg", "name" : "two.jpg", "source" : "file", "content" : "iVBORw0KGgoAAAANSUhEUgAAAKoAAABOCAYAAACwo40WAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AACAASURB..." }, { "type" : "png", "name" : "three.png", "source" : "url", "content" : "https://dss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/topnav/tupian@2x-482fc011fc.png" } ], "remarks" : "请将此模板类型设置为绑定通道类型是三网合一通道", "expiration_time" : 1}
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json。 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表2 请求Body参数 参数 是否必选 参数类型 描述 expiration_time 是 String 智能信息基础版模板有效期。单位:天,必须取整,最长9999天。 tpl_name 是 String 智能信息基础版模板名称。模板的别名,用来帮助记忆。最大不超过100个字,若使用中文需经过UTF-8编码。 title 是 String 智能信息基础版模板主题,最大不超过20个字,若使用中文需经过UTF-8 编码,主题不能包含“【】”,否则审核会不通过。 reslist 是 Array of ResourceInfo objects 模板资源列表,由按顺序排列的资源组成,资源类型支持文本、图片、音频、视频。 说明: 资源在JSON数组中的顺序将决定其在手机上的显示顺序,数组大小不能超过10。 remarks 否 String 智能信息基础版模板备注信息,用于填写对模板审核的期望或要求,最大不超过200个字。例如:希望这个模板绑定的通道类型是三网合一通道,默认优先绑定三网合一通道。 callbackurl 否 String 客户系统回调URL,可用于通知对端模板审核状态信息。 说明: 接口规格需参照定义智能信息基础版模板状态回执完成实现。 表3 ResourceInfo 参数 是否必选 参数类型 描述 index 否 String 智能信息基础版序号。 从1开始,例如: 1-1,表示第1帧第1个元素;1-2:表示第1帧第2个元素;2-1:表示第2帧第1个元素。 说明: 每帧支持最多2个元素,2个元素中必须包含有文本 如果未填该字段,则每个元素独占一帧并按数组顺序排序 最多支持8帧 最多2帧同时包含2个元素 index必须全部指定,或者全为空,不能重复 type 是 String 智能信息基础版资源类型。 类型为文字填:txt 类型为图片填:jpg/jpeg/png/gif 类型为音频填:mp3/wav 类型为视频填:mp4/3gp name 是 String 智能信息基础版资源名称。 source 是 String 智能信息基础版资源来源。 txt:表示资源内容是纯文字 file:表示资源内容来源于文件流 url:表示资源内容来源于URL外链 说明: 资源来自于文字/文件流/URL外链。 content 是 String 智能信息基础版资源信息内容。 当source=txt时,填写经过UTF-8编码的文字 当source=file时,填写经过Base64编码的文件流,不须带文件格式前缀,样例:"iVBORw0KGgoAAAANSUhEUgA...",样例过长,未显示全部 当source=url时,填写资源URL地址,URL长度不能超过1024个字节 说明: 文字中可以使用#p_n#参数变量占位,n为1~100内的数字,相同类型的资源同一参数占位符可复用。如:#p_1#已表示是文本参数占位符时,其它位置的文本类型资源可以包含该文本参数占位符。不能包含除模板签名外的“【】” 第一个文本帧,内容必须以:【签名】开始,“签名” 标识客户信息