更新时间：2024-03-27 15:08:15收藏我的文档设置返回文档公告：因平台业务调整，开放平台生活号相关文档后续将不再更新，生活号相关内容可查看 生活号 。该功能解决服务提供者向用户精准推送各类信息服务的需求。生活号可以向目标用户推送业务待办、业务通知、营销活动、公告等消息。 生活号提供的发送消息相关接口如下：接口英文名接口中文名api文档alipay.open.public.message.content.create创建图文消息内容接口alipay.open.public.message.content.modify更新图文消息内容接口alipay.open.public.message.custom.send异步单发消息（客服接口）alipay.open.public.message.total.send群发消息接口alipay.open.public.message.single.send单发模板消息接口alipay.open.public.message.query生活号查询已发送消息接口alipay.open.public.life.msg.recall生活号消息撤回接口发送消息接口流程：异步单发消息（客服接口）接口名称：alipay.open.public.message.custom.send 使用场景举例：开发者可以使用该接口实现对用户消息的回复功能，也可以使用该接口实现客服等扩展功能。注：用户主动与生活号交互的48小时之内，生活号可以使用该接口向该用户进行消息推送。 该接口可以发送以下2种类型的消息：1文本消息2图文消息－－图片宽高比为2:1，建议尺寸540*270，不符合比例的图片显示时将会被部分切割请求参数如下：文本消息参数名是否必须参数说明to_user_id是消息接收用户的useridmsg_type是消息类型，textcontent是文本消息内容 图文消息单条图文消息示例：多条图文消息示例：参数名是否必须参数说明to_user_id是消息接收用户的useridmsg_type是消息类型，image-textarticles是图文消息子消息项集合，单条消息最多6个子项，否则会发送失败其中articles中的子项参数参数名是否必须参数说明title否图文消息标题，title、desc、image_url不可同时为空desc否图文消息内容，title、desc、image_url不可同时为空image_url否图片链接，对于多条图文消息的第一条消息，该字段不能为空，title、desc、image_url不可同时为空url否点击图文消息跳转的链接action_name否链接文字群发消息接口接口名称：alipay.open.public.message.total.send 使用场景举例：开发者可以通过本接口向所有关注该生活号的用户发送消息。 该接口可以发送以下2种类型的消息：1文本消息2图文消息－－图片宽高比为2:1，建议尺寸540*270，不符合比例的图片显示时将会被部分切割请求参数如下：文本消息参数名是否必须参数说明msg_type是消息类型，textcontent是文本消息内容图文消息单条图文消息示例：多条图文消息示例：参数名是否必须参数说明msg_type是消息类型，image-textarticles是图文消息子消息项集合，单条消息最多6个子项，否则会发送失败其中articles中的子项参数参数名是否必须参数说明title否图文消息标题，title、desc、image_url不可同时为空desc否图文消息内容，title、desc、image_url不可同时为空image_url否图片链接，对于多条图文消息的第一条消息，该字段不能为空，title、desc、image_url不可同时为空url否点击图文消息跳转的链接action_name否链接文字单发模板消息接口接口名称：alipay.open.public.message.single.send 使用场景举例：模板消息是指如银行动账提醒、航空公司值机提醒等对消费者非常有价值的消息类型，模板消息符合特定的格式，无需用户发生交互就可以主动向用户推送。申请消息模板要发送模板消息，首先需要申请对应的消息模板，目前支持2种申请方式：1通过接口申请2生活号后台()上自助申请接口申请请参照：消息模板 前台自助申请，步骤如下： 第一步：进入生活号平台，点击左侧导航消息–模板消息，首次领取模板需要选择行业； 第二步：点击“从模板库中添加”进入模板库，搜索找到需要的行业模板，点击“详情”，如图 第三步：点击“添加”按钮即可领取该模板，获取模板id，如图 第四步：如果在模板库中找不到想要的模板，点击模板库右上角“帮助我们完善模板库”可以创建自定义模板，贡献新模板需要等待7天的审核期，请耐心等待。 请求参数说明：参数名是否必须参数说明to_user_id是消息接收用户的useridtemplate是消息模板相关参数，其中包括template_id模板id和context模板上下文其中template中的各项参数分别为：参数名是否必须参数说明template_id是消息模板idcontext是消息模板上下文，即模板中定义的参数及参数值其中context中的各项参数分别为：参数名是否必须参数说明head_color是顶部色条的色值url是点击消息后承接页的地址action_name是底部链接描述文字，如“查看详情”keyword1是模板中占位符的值及文字颜色，value和color都为必填项，color为当前文字颜色keyword2是模板中占位符的值及文字颜色，value和color都为必填项，color为当前文字颜色模板消息示例图： 上图的模板消息商户占位符格式如下：商户调用时入参json如下
