Überblick

Die gt-CLI (Befehlszeilenschnittstelle) unterstützt jetzt Twilio Content JSON als Dateiformat. Wenn Sie Twilios Content Template Builder verwenden, um strukturierte Nachrichten über WhatsApp, SMS oder RCS zu senden, können Sie diese Vorlagen jetzt mit demselben gt translate-Workflow übersetzen, den Sie bereits für Ihre App verwenden.

Warum das wichtig ist

Twilio Content Templates sind JSON-Dateien, die strukturierte Nachrichten definieren -- Text mit Variablen, Schnellantworten, Karten mit Medien und Aktionen. Diese Vorlagen enthalten für Nutzer sichtbare Texte: Schaltflächenbeschriftungen, Nachrichtentexte, Kartentitel. Wenn Sie Nachrichten in mehreren Sprachen versenden, müssen diese Texte übersetzt werden.

Der aktuelle Ansatz besteht darin, manuell für jede Sprache über die Twilio Console oder API ein separates Content Template zu erstellen. Jede Vorlage erhält ihre eigene SID, ihren eigenen Freigabeprozess und verursacht ihren eigenen Wartungsaufwand. Es gibt keine zentrale verlässliche Quelle dafür, was eine Nachricht sprachübergreifend aussagt.

Mit diesem Update für die Befehlszeilenschnittstelle (CLI) schreiben Sie die Vorlage einmal in Ihrer Standardsprache, und gt translate übernimmt den Rest.

Schritt-für-Schritt-Anleitung

Angenommen, Sie erstellen mit Twilio einen Kundensupport-Ablauf über WhatsApp. Sie haben eine Schnellantwortvorlage, die den Nutzer begrüßt und drei Optionen anbietet:

{
  "friendly_name": "support_greeting",
  "language": "en",
  "variables": { "1": "Customer" },
  "types": {
    "twilio/quick-reply": {
      "body": "Hallo, {{1}}. Vielen Dank, dass Sie den Support kontaktiert haben. Wie können wir Ihnen helfen?",
      "actions": [
        { "title": "Bestellstatus prüfen", "id": "order_status" },
        { "title": "Artikel zurückgeben", "id": "return_item" },
        { "title": "Mit einem Mitarbeiter sprechen", "id": "speak_agent" }
      ]
    },
    "twilio/text": {
      "body": "Hallo, {{1}}. Vielen Dank, dass Sie den Support kontaktiert haben. Wie können wir Ihnen helfen?"
    }
  }
}

Die body-Felder und title-Werte in actions sind allesamt übersetzbare Strings. Der {{1}}-Variablenplatzhalter, die id-Felder und die Strukturschlüssel hingegen nicht.

Schritt 1: Konfigurieren

Fügen Sie twilioContentJson zur Konfiguration Ihrer Datei gt.config.json hinzu:

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

Der Platzhalter [locale] im include-Pfad gibt der Befehlszeilenschnittstelle (CLI) an, wo die Quelldateien zu finden sind und wo die Übersetzungen gespeichert werden sollen. Die Quelldateien werden aus twilio/en/ gelesen, und die übersetzten Dateien werden in twilio/es/, twilio/fr/ usw. gespeichert.

Schritt 2: Übersetzen

npx gt@latest translate

Für jedes konfigurierte Gebietsschema werden Übersetzungen generiert. Die Ausgabe behält die Twilio-JSON-Struktur bei -- nur die String-Werte ändern sich.

Die spanische Ausgabe könnte so aussehen:

{
  "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?"
    }
  }
}

Jede übersetzte Datei ist eine gültige Twilio-Content-JSON-Vorlage, die direkt als neue Vorlage für ein bestimmtes Gebietsschema in die Twilio Content API hochgeladen werden kann.

Links

• Dokumentation zur Konfiguration der Befehlszeilenschnittstelle (CLI)
• Twilio Content Template Builder
• Quelle