返回

gt-cli@2.9.0

Ernest McCarter avatarErnest McCarter
gt-cliv2.9.0twiliocontent-templatesi18nwhatsappsms

概述

gt CLI 现已支持 Twilio Content JSON 文件格式。如果你使用 Twilio 的 Content Template Builder 通过 WhatsApp、SMS 或 RCS 发送结构化消息，现在就可以使用与应用中相同的 gt translate 工作流来翻译这些内容模板。

为什么这很重要

Twilio Content Templates 是用于定义结构化消息的 JSON 文件——包括带变量的文本、快速回复按钮，以及包含媒体和操作的卡片。这些模板中包含面向用户的字符串：按钮标签、正文文本、卡片标题。如果你要发送多语言消息，这些字符串就需要翻译。

目前的做法是通过 Twilio Console 或 API，手动为每种语言分别创建一个内容模板。每个模板都有自己的 SID、自己的审核周期，以及各自的维护成本。这样一来，对于一条消息在不同语言中具体表达了什么，就没有一个统一的真相来源。

通过这次 CLI 更新，你只需用默认语言编写一次模板，其余的交给 gt translate 处理。

操作演示

假设你正在使用 Twilio 通过 WhatsApp 搭建一个客户支持流程。你有一个快速回复内容模板，用来向用户打招呼，并提供三个选项：

{
  "friendly_name": "support_greeting",
  "language": "en",
  "variables": { "1": "客户" },
  "types": {
    "twilio/quick-reply": {
      "body": "您好，{{1}}。感谢您联系支持。请问我们可以如何帮助您？",
      "actions": [
        { "title": "查询订单状态", "id": "order_status" },
        { "title": "退货", "id": "return_item" },
        { "title": "联系人工客服", "id": "speak_agent" }
      ]
    },
    "twilio/text": {
      "body": "您好，{{1}}。感谢您联系支持。请问我们可以如何帮助您？"
    }
  }
}

actions 中的 body 字段和 title 值都是可翻译的字符串。{{1}} 变量占位符、id 字段以及结构键则不是。

第 1 步：配置

将 twilioContentJson 添加到 gt.config.json 文件的设置中：

{
  "defaultLocale": "en",
  "locales": ["en", "es", "fr", "ja"],
  "files": {
    "twilioContentJson": {
      "include": ["twilio/[locale]/**/*.json"]
    }
  }
}

include 路径中的 [locale] 占位符用于告诉 CLI 到哪里查找源文件，以及将翻译结果保存到哪里。源文件从 twilio/en/ 读取，翻译后的文件会保存到 twilio/es/、twilio/fr/ 等目录中。

第 2 步：translate

npx gt@latest translate

系统会为每个已配置的区域设置生成对应的翻译。输出会保留 Twilio JSON 的结构——变化的只有字符串值。

西班牙语输出可能如下：

{
  "friendly_name": "support_greeting",
  "language": "es",
  "variables": { "1": "Customer" },
  "types": {
    "twilio/quick-reply": {
      "body": "Hola, {{1}}. Gracias por contactar con soporte. ¿En qué podemos ayudarte?",
      "actions": [
        { "title": "Ver estado del pedido", "id": "order_status" },
        { "title": "Devolver un artículo", "id": "return_item" },
        { "title": "Hablar con un agente", "id": "speak_agent" }
      ]
    },
    "twilio/text": {
      "body": "Hola, {{1}}. Gracias por contactar con soporte. ¿En qué podemos ayudarte?"
    }
  }
}

每个翻译后的文件都是有效的 Twilio Content JSON 内容模板，可直接上传到 Twilio Content API，作为新的特定于区域设置的 内容模板。

链接