使用推送模板

推送模板概述

推送模板主要用于服务器提供的默认离线推送配置不满足你的需求时，设置全局范围的推送标题和推送内容。例如，服务器提供的默认设置为中文和英文的推送标题和内容，你若需要使用韩语或日语的推送标题和内容，则可以设置对应语言的推送模板。

推送模板类型

你可以使用推送模板设置推送标题和内容。推送模板包括默认推送模板 default、detail 和自定义推送模板。

除了调用 REST API 配置默认推送模板，你也可以在 环信控制台设置推送模板，详见 推送模板配置文档。

推送模板特点

1. 推送模板的优先级高于 调用 API 设置通知栏的推送内容。
2. 实现自定义修改环信服务端默认推送内容。
3. 对于群组消息，你可以使用定向模板向某些用户推送与其他用户不同的离线通知。
4. 接收方可以决定使用哪个模板。
5. 按优先级选择模板使用方式：
   • 使用自定义推送模板的优先级高于默认推送模板。
   • 若发送方发消息时设置了推送模板，接收方即使设置了推送模板，收到推送通知后也按照发送方设置的推送模板显示。

推送模板与其他方式的使用优先级

通知栏中显示的推送标题和内容可通过以下方式设置，优先级为由低到高：

1. 发送消息时使用默认的推送标题和内容：设置推送通知的展示方式 notification_display_style。推送标题为“您有一条新消息”，推送内容为“请点击查看”。
2. 发送消息时使用默认模板：若有默认模板 default 和 detail，发消息时无需指定。
3. 发送消息时使用扩展字段自定义要显示的推送标题和推送内容，即 em_push_title 和 em_push_content。
4. 接收方设置了推送模板。
5. 发送消息时通过消息扩展字段指定模板名称。