跳到主要内容

自定义多语言推送模板

融云支持通过推送模板功能实现多语言推送。服务端会根据 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，以添加与该语言匹配的文案。
    • 推送标题：设置对应语言的通知栏标题。可选参数，默认单聊为用户名，群聊、超级群为群名称。请注意发消息时指定的推送标题会覆盖模板中的标题，导致推送模板中设置的标题不生效。
    • 推送内容：设置对应语言的通知栏显示内容。请注意发消息时指定的推送内容会覆盖模板中的内容，导致推送模板中设置的内容不生效。

创建模板后 30 分钟生效。

使用自定义推送模板​

客户端 SDK 支持在发送消息时，在消息推送属性（pushOptions）中传入模版 ID（templateId），为消息启用指定的多语言推送模板。设置后，如该消息触发推送，服务端会根据指定推送模板中的多语言内容进行推送。

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

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

注意

  • 关于如何指定推送模版 ID（templateId），详见 配置消息的推送属性。注意，如需使用推送模板功能，请将消息推送属性中推送标题与推送内容留空。
  • 关于客户端如何设置接收推送的语言，详见 用户级推送配置 > 推送语言。
  • 您可以修改 App Key 在融云的默认推送语言配置。如有需要，请提交工单申请更改 App Key 级别的 Push 语言。
最后于 更新