《2022版5G消息标准版（视频短信）用户手册.docx》由会员分享，可在线阅读，更多相关《2022版5G消息标准版（视频短信）用户手册.docx（98页珍藏版）》请在课桌文档上搜索。
1、5G消息标准版（视频短信）用户手册文档版本01发布日期2022-09-281快速入门12注册华为账号并完成认证23购买5G消息标准版服务74申请5G消息标准版签名145通过iTA门户申请5G消息标准版模板并发送195.1 申请5G消息标准版模板195.2 体验模板发送管理（可选）225.3 发送视频短信246通过AppCube申请5G消息标准版模板并发送266.1 创建5G消息应用并配置通道信息266.2 制作5G消息标准版296.3 创建群发视频短信任务377通过调用API接口发送5G消息标准版397.1 新手必备397.2 开发准备417.3 API参考417.3.1 概述4173.1.1
2、 接口范围说明4173.1.2 术语与缩略图427.3.2总体规范427.3.2.1 接口简介427.322接口格式说明427.3.2.3访问认证说明4273.2.4通用请求消息头定义427.3.3接口说明431.1 3.1模板创建431.2 .3.2模板查询501.3 .3.3视频短信发送任务551.4 发送任务列表查询611.5 发送任务状态报告查询657.3.3.6模板审核结果通知68733.7 发送任务状态报告回调70733.8 上行消息推送接口74733.9 代码样例767.3.4.1JAVA767.3.5附录847.3.5.1通用结果码847.352模板类型定义857.353发送手
3、机号码规则定义858规则与标准868.1 视频短信封禁规则868.2 视频短信模板内容定义878.3 视频短信内容审核标准888.4 视频短信签名审核标准898.5 发送手机号码规则定义919FAQ929.11 TA视频短信发送能力如何？929.12 交模板审核被驳回，提示“贴尾检测，模板最后文本帧不能包含：退订、免流”是什么意思？929.13 频短信发送成功，有时手机未收到是什么原因？929.14 频短信模板提交后，一般多久可以审核结束？929.15 板审核状态回调，发送任务状态报告回调接口必须按照接口文档开发，保持一致么？939.16 客户侧服务异常，导致华为推送模板审核状态和发送任务状态
4、报告失败后，该如何获取相关数据？.939.17 板创建时，TemPlateReSOUrCe中的SOUrCe和type有什么区别？939.18 哪些常见的状态码？931快速入门1快速入门5G消息标准版（即视频短信）是华为inTouchAggregator提供的种通信服务的能力。本文档用于指导用户如何购买及发送5G消息标准版业务。1 .入驻华为云在购买5G消息标准版服务前需要注册华为账号，完成企业认证，请参考注册华为账号并进行认证。2 .购买5G消息标准版服务云市场如何购买5G消息标准版，请参考贩买5G消息标准版服务。3 .申请5G消息标准版签名5G消息标准版签名是指短信发送方的署名，标识发送方的
5、身份。请参考申请5G消息标准版签名。4 .申请5G消息标准版模板5G消息标准版模板是指发送方发送5G消息标准版时使用的内容模板。请参考视频短信模板内容定义及视频短信内容审核标准。申请5G消息标准版模板，有2种方式可供选择：- 通过iTA门户申请视频短信模板- 通过APPCUbe申请视频短信模板5 .发送5G消息标准版发送5G消息标准版，有3种方式可供选择：- 通过iTA门户提供的发送任务去发送视频短信（只针对直客用户）- 通过APPCUbe提供的投放任务去群发视频短信- 通过调用iTA提供的API接口发送视频短信2注册华为账号并完成认证背景信息华为帐号是用户访问华为各网站的统一“身份标识”，您
6、只需注册一个华为帐号，即可访问所有华为服务，如：华为云、终端云、华为手机等终端、华为开发者联盟等。操作步骤步骤1进入华为云官网。华为云官网地址：步骤2注册华为账号。1 .单击页面右上角的“注册”，进入“华为账号注册”页面。图2-1华为账号注册华为帐号注册华为帐号报受雷要联网.并获取您的帐号、所在区域、浏览器设置僖皂，以及您主动上传的个人基本笑料和身份僖息.点击“注册”，为表示宴司意上述内容及华为帐号用户协议.关于华为帐号与隙私的声明.2 .输入手机号.-请使用中国大陆的手机号码。一个手机号可以注册3个华为帐号，如帐号数量己达到3个，将不支持使用该手机号注册新的华为帐号。3 .获取并输入手机收到
7、的验证码。4 .设置帐号密码。- 至少包含8个字符。- 至少包含字母和数字，不能包含空格。5 .单击“注册”。步骤3开通华为云。1.华为云账号注册完成后，系统进入“开通华为云”页面。图2-2开通华为云开通华为云我已阅读并同意华为云用户协议和第私政策声明，同时我同意华为云从华为帐号服务获取我的下述个人信息：华为帐号名、手机号、邮件地址、注册国家/地区、帐号标识和状态信息。若不同意，可点击取消开通华为云。我同意华为云向我发送优惠、广告和资讯信息.2.勾选服务条款，单击“开通”。系统提示开通成功。开通成功即可通过该华为帐号登录华为云。图2-3华为云开通成功会8认证图2-4实名认证实名UI国开发者联留
8、漫权认证左并 jtBaam,.企业认证imrAmruji. gA2AMUR3 受MAMKXMI Tg 从力宏!开通成功，欢迎加入华为云返回原页面步骤4企业实名认证。1 .单击“实名认证”，进入实名认证页面。个人认证mAftWe2RPAUS*ti*vMUeuUUg司女*8个，标8；&wa*hpjt.口说明登录华为云官网后，通过单击页面右上角的用户名，选择“账号中心”，在认证信息后面单击“认证”，也可进入图4实名认证页面。2 .选择企业认证，根据页面提示完成认证。详细认证操作请参考企业账号如何完成实名认证。步骤5绑定邮箱。1 .选择账号名，单击“基本信息”。图2-5基本信息中文倘体）基本信息安全设
9、置统一身份认证切换角色掾作日志退出2 .在“基本信息”页面，单击“前往管理”，进入账号中心页面。图2-6账号中心华为帐号：A个人倡息6帐号与安全 1私中心央HUAWEl侬中心M帐号与安全帐号登录方式S三JW*.手机号.初杵地址或有定的第三方帐号整豪华为年mQ跖电第三方IK号ss司府掌。公3HSV3 .单击“绑定”，按照页面提示验证身份。4.输入“绑定邮箱”，获取邮箱验证码并输入，完成邮箱的绑定。-结束3购买5G消息标准版服务使用5G消息标准版服务前，您需要先登录华为云云市场购买5G消息标准版服务。因云市场的5G消息标准版为严选自营产品，涉及服务监管，所以需要先购买，然后执行服务监管“购买步骤1
10、登录华为云。1 .进入华为云官网。华为云官网地址：2 .单击页面右上角的“登录”，进入登录页面。图3-1登录页面扫码登录密码登录华为帐号登录注册忘记密码使用其他帐号登录IAM用户企业联邦用户华为官网帐号华为企业合作伙伴华为云帐号我们为您提供华为帐号服务，在登录过程O会使用到您的帐号和网络信旦捏升考录体始.7解申名3 .输入己注册并开通华为云的华为账号、帐号密码，单击“登录”。匚说明若您需要使用其他方式登录华为云，诗参考登录华为云。步骤2购买5G消息标准版服务。1 .在页面顶端搜索栏搜索您需要购买的产品：5G消息云服务。2 .单击产品名称，进入详情页面。图3-25G消息云服务华力公0展UEt O
11、 Q m3 .查看商品详情，然后选择需要购买产品的规格、套餐包规格、套数、购买时长。4 .单击“立即购买”，进入购买页面。图3-3购买5G消息云服务购买50消息云霰务（V）MM 、；wmAaMlMllUbNUtnw 8 ZS3fr服务监管”处提交需求。2 .服务商反馈服务已完成后，用户可以在“我的云市场服务监管”验收服务，确认已完成。3 .服务商实施需求后，若用户对服务结果不满意，可以执行“驳回”操作。说明服务监管过程中，如服务商方流程停留超过5天或驳回次数超过3次，用户可执行“申诉”操作，详情请参见服务监管申诉说明,服务监管操作步骤如下：步骤1提交需求。1 .登录华为云云市场首页，进入买家中
12、心“我的云市场服务监管”页面。2 .设置查询条件，选择目标服务交易记录，单击操作列的“提交需求”。3 .填写需求信息，单击“提交需求”。服务信息商品名称Fl规格名称订单号可点击登着订单详情.核实交付内容.照条会否走户缓交要求匚说明-需求附件可以参考需求模板提交。提交需求成功后，用户可以在服务监管页面查看服务状态及历史记录。4.在系统显示的弹框页面，单击“确认”。X，提交需求提交需求后，寒需等待服务商对需求迸行确认步骤2确认验收。1 .登录华为云云市场首页，进入买家中心“我的云市场服务监管”页面。2 .设置查询条件，选择目标服务交易记录，单击操作列的“确认验收”。3,若服务已完成，单击“确认验收
13、”。服务信息商品名称规格名称订单号可点击查看订单详情，核实交付内容.服务状态用户确认验收口说明服务商反馈服务完成后，确认该服务己完成或者驳回给服务商，驳回次数超过3次，用户可在第4次操作时发起申诉。4 .在系统显示的弹框页面，单击“确认”。X。确认验收请您再次确认此订单是否已技付完成。在您确认脸此后，如此交易涉及第三方的服务，三台将启砺携三方的结算流程，且此交易入再允许任何理白的退订由清。堤矍：为保獐您的权益，清接实际迸度完成验收！匚）说明严选自营商品用户申诉说明：服务监管过程中，在用户方操作流程（用户提交需求/用户确认验收）驳回次数超过3次后，用户可在第4次操作时发起申诉。服务监管过程中当一
14、方发起中诉后，服务监管流程冻结，进入运营经理处理申诉流程，双方都不可再进行操作。当运营经理处理完申诉后，服务监管恢复为可操作状态。服务监管流程关闭前15天内，不允许发起申诉。一结束退订用户购买后，系统支持退订。退订申请提交后，需服务商审核通过后，才能退订成功，故请谨慎操作。步骤1进入买家中心我的云市场页面。步骤2单击“退订管理”，查看您可以退订的商品列表.步骤3选择需要退订的商品，单击右侧操作列的“退订”。图3-5退订MMUlMHW*MW11CWM9OW8步骤4输入“退订金额”，选择退订原因，单击右下角“退订”。图3-6退订详情步骤5在系统弹框中，单击“是”。提交成功后，需要服务商审核，您可以
15、在中关注退订状态。一结束4申请5G消息标准版签名背景信息须知5G消息标准版，又称视频短信，在iTA门户操作中，所提到的视频短信即为5G消息标准版。 申请5G消息标准版（视频短信）签名操作，需要您使用已注册并完成认证的华为账号登录iTA门户完成。 5G消息标准版（视频短信）在发送时，会自动携带企业签名。所以用户需要先申请企业签名备案，待审批通过后，才可用于5G消息标准版（视频短信）的发送。操作步骤步骤1登录iTA门户。1 .使用已注册认证的华为云账号登录iTA网站。iTA网站地址：2 .单击“华为云账号登录”，根据界面提示输入账号名/邮箱和密码。3 .单击“登录”。步骤2选择“控制台消息视频短信
16、”，系统弹出备案视频短信签名页面。图4-1视频短信签名认证提醒I温馨提示您还未备案冽须短信签名，请完备案亩核收颜短信签匚）说明选择视频短信后，系统会校验客户在iTA系统中是否已有成功企业签名备案记录，如果没有，则会提示客户进行备案注册。步骡3单击“确定”，页面跳转到图4-2图4-2视频短信企业签名备案确认I企业签名备案视频回三务只向通过视频应信筌名认证的企业用户提供通信功能三我已阅读并同意国内视瘢信服务使用声明步骤4勾选“我已阅读并同意国内视频短信服务使用声明”，单击“立即开通”，页面跳转至图3。图4-3企业签名备案I企业签名蠡案缶名所属企业名称f消息视频短信模板中心”，进入模板中心页面。图5
17、-1模板中心M24ft1O523杆步骤3选择“模板名称”，输入模板的名称，或单击下拉按钮选择“模板编号”，输入模板的编号，单击搜索按钮，可查询对应模板信息。鼠标移动到模板上，模板的中心会出现4个图标，说明如下： 预览图标：单击后，展示发送终端显示的模板效果。 编辑图标：单击后，可对选中模板进行编辑，编辑提交后，待审核通过后才能使用。 发送图标：单击后，进入新建发送任务页面，系统将自动填充选中的模板信息，待用户补充其他信息后，即可执行发送任务。 删除图标：单击后，可删除选中的模板。步骤4申请视频短信模板。1 .单击“新建模板”，进入新建模板页面。2 .配置模板的基本信息。选择“企业名称”，页面会
18、自动关联显示对应的企业签名。输入“模板名称”，选择“模板类型”和“视频短信类型”。匚!说明若“模板类型”选择“动态参数模板”，则还需要设置是否“携带Chatbot服务号”。3 .配置消息内容。输入“消息标题”，单击“添加内容”，选择添加文本或多媒体内容，然后选择“退订标签选择”。添加的内容会实时显示在右侧的预览效果中。多媒体内容支持上传图片、音频和视频，支持本地上传和素材库上传两种形式。素材库的管理详见素材库管理。图5-2已配置的模板样例PaB4a三金曾的BOmWim(g2021110MVW酥SWttCMIIMMMMaw2inl KAnS.这 理你 T 电了 .Gj1口金,mmi三wttae1
19、14MS内。(9202111031)三RihtX三,MP-W7.XMdhtBpcg*M*K三消息视频短信体验模板发送管理”，进入体验模板发送管理页面。可根据“模板名称”，“模板编号”对模板进行查询。先18体芸总罢依：10 ,已用条数:8 . JR余条时：2每自示io V条记录TEST-SHiPlNVMS.21091300006 友与范匡 隼劭 口通,电信D说明发送范围：移动，联通，电信。步骤3图1中单击“发送”，进入单条测试页面。图5-5单条测试I单条测试图5-4体验模板发送管理I体蛉权板发送笆理模版名降：模版管弓:步骤4输入测试号码（即手机号码），单击“获取验证码”，填写已获取的验证码，单击
20、“发送”，完成体验模板的发送。匚J说明体验模板只能单条发送，只有测试号码和短信验证码填写iE确，才能进行发送。一结束5.3 发送视频短信前提条件并完成服务监管。并审批通过。并审批通过。用户已购买视频短信服务,用户已申请视频短信签名,用户已申请视频短信模板,操作步骤步骤1登录iTA门户。步骤2选择“控制台消息视频短信发送任务管理”，进入发送任务管理页面。可根据任务创建时间范围、任务名称和模板类型查询历史发送任务。图5-6发送任务管理I发送任务管理任务名依IMc 操作列中单击“查看”，可以查看发送任务的详情。 操作列中单击“预览”，可以预览待发送的任务信息。 操作列中单击“查看发送详情”，在弹出页
21、面中，可进行如下操作：- 输入“手机号码”，可查询单个号码的发送详情。单击“导出全部号码”，可导出发送任务中全部用户的下发详情。- 单击“导出失败号码”，可导出发送任务中失败用户的下发详情。 操作列中单击“撤销”，可以撤销待发送的任务。只有“任务状态”为“待发送”，且发送时间距离当前时大于5分钟的任务，才可 以撤销。 操作列中单击“删除”，可以删除已撤销的发送任务。h全然V|任务名悴WWHBM发送号称总发迷失IMRs三avt发送奥任务状扬名称发送W同snRSBSft2021*06*262021-09-26皿凝段且发送“500000将发送_15:472919:4729道修议20210*26202
22、13*26立即及SVKS.tt*S三三fll500000传发送1S:472915:4729送2021082620210a26立歌SWA三MWW500000件妁2/15:472915:4729送KW修改 操作列中单击“修改”，可以修改已撤销的发送任务，支持修改后重新提交。步骤3单击“新建发送任务”按钮，进入“新建发送任务”页面。图5-7新建发送任务I震送任务11银任务名标Si2913fO立8P发送参副任务IfiHXiZMM:2021-08-2709:39X）3Hlw定时发送任知清在发送例5分钟Ji作.SM随值向县定时任务的时间只鸵0B为为三天以内.3tii对象等Jt量导入点suit处下【ittf
23、ll导入】m立图上传步骡4输入“任务名称”，选择相应模板，模板类型会自动关联显示。 当选择“立即发送”后，下载“批量导入”模板，按照模板格式说明上传发送号码。单击“提交”，界面弹出“提交成功！”提示信息。 当选择“定时发送”时，下载“批量导入”模板，按照模板格式说明上传发送号码。可在设置定时发送时间后提交，单击“提交”，界面弹出“由于运营商审核规则实时变化，实际下发结果以定时下发后的状态报告为准”提示信息。口说明任务提交时（不管立即发送还是定时发送），针对基础的号码格式校验，当前单个文件校验限制最多5000个号码，超过限制提交会出错。结束通过AppCube申请5G消息标准版模板并发送6.1创建
24、5G消息应用并配置通道信息在申请5G消息标准版模板前，需要先创建5G消息应用，并配置通道信息。5G消息应用开发平台提供以下3种方式创建应用，一个应用对应一个ChatBOt服务号: 创建空白应用 导入应用 基于模板创建创建5G消息应用步骤1进入5G消息应用开发平台。1 .使用企业帐号登录华为云网站，在顶部导航栏右侧单击“控制台”，进入华为云控制台。2 .在左侧导航栏上方，单击包,选择服务实例所在的区域项目。单击三，在查找框中搜索“应用魔方”。单击查找出的结果，进入APPCUbe管理控制台。3 .在APPCUbe管理控制台，单击“进入运行环境”。4 .单击页面顶部“5G消息”，进入5G消息应用开发
25、平台。管理阻a织下的用户信息.怎可以管理用户角色.权限.认证信息等.图6-15G消息应用开发平台E5GMMfrMttnm：力BJ11B-步骤2创建5G消息应用。5G消息应用开发平台提供以下3种方式创建应用，一个应用对应一个ChatBot服务号： 创建空白应用a.在5G消息应用开发平台右上角单击“新建应用+”。b.设置应用名称，单击“创建空白应用”。即可进入5G消息应用开发界面。 导入应用该方式适用于不同环境中应用的迁移，即将环境A中开发好的5G消息应用迁移导入到环境B中。a.获取要导入的5G消息应用包。参考图6-2,在环境A的5G消息应用开发平台中，在右上角切换到需要导出的应用界面，单击应用列
26、表后的导出按钮导出应用包。图6-2导出应用新建应用I某大学服口ENEQ应用列表九安科技网络海风科技辽宁拓云横板应用阜学朝通道配置”。步骤2选择“视频短信”页签，配置视频短信通道信息。配置值从1中申请通过后收到的邮件中获取O其中“视频短信地址”为iTA的发送视频短信接口地址。华为云市场Q通国已I-结束6.2制作5G消息标准版APPCUbe支持发送5G消息标准版。首先您需要新建5G消息标准版签名和模板，然后通过投放任务发送给终端用户。场景描述例如，某外卖品牌推出了工作团餐，通过APPCUbe制作如图1所示促销5G消息标准版内容，使用群发的方式投放至终端用户。图6-3推广工作团餐15：56Q.l令企
27、业签名”。图6-6选择企业签名G SG消息内容制作投放管理应用配置I企业签快速创住消息2 .单击“新建”，创建企业签名。图6-7创建企业签名创建企业签S-企业信息基名O【X外无】表6-1企业签名参数说明参数说明*企业名称企业的名称。和申请5G消息标准版签名时填入的企业名称保持一致。*企业信息签名视频短信中携带的签名内容，格式【XXXX】O和申请5G消息标准版签名时填入的“信息服务签名”保持一致。*企业ID企业的ID。和申请5G消息标准版签名成功后，发送通知邮件中的企业ID保持一致。描述描述信息。步骤2在5G消息应用开发界面上方选择“内容制作”，在“我的视频短信”页签单击“+新建视频短信”。图6-8新建视频短信I内容制作L投放修理快速创建视频短信步骤3配置视频短信。1 .设置视频短信名称，例如“X外卖”。图6-9设置名称X外卖15：56-./令O90106:2 .设置主题，例如“X外卖，值得信赖”。图6-10设置主题15：56，.Il令O90106：IX外卖，值得信赖类型有以下三种：- 静态模板：短信内容不携带变量。短信内容示例为“我们在全国范围内推出了工作团餐，最低25元起，您可以微信关注X公众号进行预约订餐。
