跳到主要内容

自定义多语言推送模板

即时通讯服务支持通过推送模板功能实现多语言推送。服务端会根据 App 用户通过客户端上报的推送语言，从指定推送模板中匹配对应语言的推送内容进行远程推送。

提示
  • 客户端 SDK 从 5.0.0 版本开始，支持在发消息时指定使用一个推送模板。
  • App 用户需要通过客户端 SDK 设置接收推送的语言，否则服务端会默认使用 App Key 级别的 Push 语言设置为其匹配推送文案。

创建多语言推送模板​

在使用推送模板功能前，必须在控制台创建多语言推送模板。

  1. 访问控制台 自定义推送文案 页面，创建推送模板，最多可创建 100 个。

    (width=800)

    • 推送模板 ID：推送模板的唯一标识。发送消息时，若使用该推送模板，需填入此模板 ID。
    • 推送模板名称：设置推送模板的名称。
    • 推送内容设置：每个推送模板中支持设置多个语言的推送内容，每种语言对应一条推送标题和一条推送内容。

  2. 添加推送内容。您可以按语言标识逐个设置对应的推送标题与推送内容。例如，模板 asia 中可同时添加 zh_CN、zh_TW、zh_HK、ja_JP、ko_KR 等多种语言的对应文案。

    (width=600)

    • 语言标识：从下拉菜单中选择一个语言标识，如 en_US，以添加与该语言匹配的文案。
    • 推送标题：设置对应语言的通知栏标题。可选参数，默认单聊为用户名，群聊、超级群为群名称。请确保未在消息的推送通知 pushExt 中设置推送标题，否则推送模板中设置的标题不生效。
    • 推送内容：设置对应语言的通知栏显示内容。请在发送消息时 pushContent 传入空值，否则推送模板中设置的内容不生效。

创建模板后 30 分钟生效。

使用自定义推送模板​

IM Server API 支持在发送消息时，为消息启用指定的多语言推送模板。设置后，如该消息触发推送，服务端会根据指定推送模板中的多语言语言内容进行推送。

如果接收方客户端设置了推送语言，服务端将从推送模板中匹配用户上报的推送语言进行远程推送。如果用户未设置，或无法匹配用户推送语言，服务端根据 App 在即时通讯服务端的默认推送语言内容进行推送。

客户端 SDK 在设置接收推送的语言时，语言标识需要控制台的语言标识一致，才能匹配成功。例如，客户端设置推送语言为美式英语 en-US，而推送模板中美式英语的表示法为 en_US，则无法成功匹配。

提示
  • 关于如何指定推送模版 ID（templateId），详见各 API 的参数说明。
  • 关于客户端如何设置接收推送的语言，详见各平台客户端推送开发指南中的用户级推送配置。
  • 您可以修改 App Key 在即时通讯服务的默认推送语言配置。如有需要，请提交工单申请更改 App Key 级别的 Push 语言。
最后于 更新