Twilio-Inhaltsvorlagen ermöglichen es Ihnen, vorab genehmigte WhatsApp-Nachrichtenvorlagen über Ihre Twilio WhatsApp Business-Kanäle in Chatwoot zu versenden. Diese Vorlagen ermöglichen es Ihnen, Konversationen zu starten und strukturierte Nachrichten zu senden, die den Messaging-Richtlinien von WhatsApp entsprechen.

## **Unterstützte Vorlage-Typen**

**Textvorlagen**

* Einfache Textnachrichten mit optionalen Variablen

* Unterstützung von bis zu 100 Variablen pro Vorlage im Format `{{1}}`, `{{2}}`

* Mehrsprachige Unterstützung

**Medienvorlagen**

* **Bildvorlagen**: Text mit Bild-Headern (JPEG/PNG, max. 5MB)

* **Videovorlagen**: Text mit Video-Headern (MP4/3GPP, max. 16MB)

* **Dokumentvorlagen**: Text mit Dokument-Anhängen (PDF/Office-Formate, max. 100MB)

* Unterstützung dynamischer Medien-URLs mit Variablen

**Quick Reply-Vorlagen**

* Interaktive Button-Antworten, die von WhatsApp verarbeitet werden

* Einfache Button-Aktionen für gängige Antworten

* Unterstützung mehrerer Sprachvarianten

**Call-to-Action-Vorlagen**

* **URL-Button-Vorlagen**: Senden von Nachrichten mit anklickbaren Aktionsbuttons

* **Variablen-Unterstützung**: Sowohl Nachrichtentext als auch Button-Parameter können Variablen enthalten

* **Aktionsarten**: URL-Buttons für Zahlungen, Buchungen, Webseiten usw.

## **Voraussetzungen**

Bevor Sie Twilio-Inhaltsvorlagen verwenden:

1. **Twilio-Konto**: Aktives Twilio-Konto mit Zugang zur WhatsApp Business API

2. **Genehmigte Vorlagen**: Im Twilio Console erstellte und genehmigte Vorlagen

3. **Chatwoot-Integration**: Twilio WhatsApp-Kanal in Chatwoot konfiguriert

4. **WhatsApp Business-Konto**: Verifiziertes WhatsApp Business-Profil

## **Einrichtung von Vorlagen**

1. Melden Sie sich im [Twilio Console](https://console.twilio.com/) an

2. Navigieren Sie zu **Messaging** → **Content Template Builder**

3. Klicken Sie auf **Create new template**

4. Wählen Sie Ihren Vorlagentyp: **Text**: Für einfache Textnachrichten, **Media**: Für Bilder, Videos oder Dokumente, **Quick Reply**: Für interaktive Buttons

5. Konfigurieren Sie die Vorlage gemäß dem Verwendungszweck.

6. Vorlage zur WhatsApp-Genehmigung einreichen

7. Auf die Genehmigung warten (5 Minuten bis 24 Stunden)

8. Genehmigte Vorlagen erhalten eine ContentSid

9. Vorlagen sind nun bereit für die Nutzung in Chatwoot

## **Synchronisieren von Vorlagen mit Chatwoot**

**Automatische Synchronisation über API**

Vorlagen werden automatisch synchronisiert, wenn Sie:

1. Das Inhaltsvorlagen-Modul in einer Konversation öffnen

2. Eine neue Konversation mit einem Twilio WhatsApp-Kanal erstellen

**Manuelle Synchronisation**

Für Posteingangs-Administratoren:

1. Gehen Sie zu **Einstellungen** → **Posteingänge**

2. Wählen Sie Ihren Twilio WhatsApp-Posteingang

3. Klicken Sie auf die Schaltfläche **Vorlagen synchronisieren**

4. Warten Sie auf die Benachrichtigung über Abschluss der Synchronisierung

## **Verwendung von Vorlagen in Konversationen**

#### **Schritt 1: Vorlagenoptionen aufrufen**

Öffnen Sie eine Konversation mit einem WhatsApp-Kontakt, klicken Sie auf das **Vorlagen-Symbol** im Nachrichteneditor, wählen Sie **"WhatsApp Templates"** aus dem Dropdown-Menü aus

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTnAxRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--859d1249d1c6a48c60b489dbcd8e64c9cb051213/CleanShot%202025-08-26%20at%2013.49.16@2x.png)

#### **Schritt 2: Vorlage auswählen**

Durchsuchen Sie Ihre genehmigten Vorlagen, verwenden Sie die Suchleiste für schnelles Finden spezifischer Vorlagen

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTzExRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c4a753fd824fadbe3a6f3bb225fbdd38c7452d56/CleanShot%202025-08-26%20at%2013.51.19@2x.png)

#### **Schritt 3: Nachricht anpassen**

Abhängig vom Vorlagentyp müssen Sie ggf. Folgendes ausfüllen:

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFIxRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--75e325a080c3749165473b87370618b8246c0a4e/CleanShot%202025-08-26%20at%2013.51.56@2x.png)

## **Best Practices**

**Vorlagendesign**

* Halten Sie Nachrichten kurz und klar

* Nutzen Sie Variablen zur Personalisierung

* Stellen Sie sicher, dass Mediendateien optimiert und zugänglich sind

* Testen Sie Vorlagen vor dem Einreichen zur Genehmigung

**Verwendung von Variablen**

* Verwenden Sie beschreibende Variablennamen im Twilio Console

* Geben Sie klare Beispiele für die Genehmigung an

* Halten Sie die Anzahl der Variablen übersichtlich (unter 10 für bestes Nutzererlebnis)

**Medienrichtlinien**

* Hosten Sie Mediendateien auf zuverlässigen, schnellen Servern

* Verwenden Sie HTTPS-URLs für alle Medien

* Optimieren Sie Dateigrößen für schnellere Zustellung

* Fügen Sie Fallback-Text für Medienvorlagen hinzu

**Compliance**

* Befolgen Sie die Richtlinien der WhatsApp Business Policy

* Stellen Sie sicher, dass Vorlagen legitimen Geschäftszwecken dienen

* Respektieren Sie die Privatsphäre und Zustimmung der Nutzer

* Überwachen Sie die Vorlagen-Performance und den Genehmigungsstatus

## **Fehlerbehebung**

**Häufige Probleme**

**Vorlage wird nicht angezeigt**

* **Ursache**: Vorlage nicht von WhatsApp genehmigt

* **Lösung**: Überprüfen Sie den Genehmigungsstatus im Twilio Console

**Vorlagensynchronisation fehlgeschlagen**

* **Ursache**: API-Verbindungsprobleme oder ungültige Zugangsdaten

* **Lösung**: Überprüfen Sie Ihre Twilio-Zugangsdaten und versuchen Sie die Synchronisation erneut

**Medien werden nicht geladen**

* **Ursache**: Medien-URL nicht zugänglich oder falsches Format

* **Lösungen**: Prüfen, ob die URL öffentlich zugänglich ist, Dateiformat und Größenbeschränkung überprüfen, HTTPS-Protokoll sicherstellen

**Variablen funktionieren nicht**

* **Ursache**: Falsches Variablenformat oder fehlende Werte

* **Lösungen**: Korrektes Format `{{1}}`, `{{2}}` im Twilio verwenden, alle erforderlichen Variablen in Chatwoot ausfüllen, Prüfen, ob die Anzahl der Variablen mit der Vorlage übereinstimmt

## **Fehlermeldungen**

**"Template not found"**

* Vorlage wurde nicht nach Chatwoot synchronisiert

* Führen Sie eine manuelle Synchronisation durch oder überprüfen Sie den Genehmigungsstatus der Vorlage

**"Media file too large"**

* Datei überschreitet WhatsApp-Beschränkungen

* Datei komprimieren oder anderes Format wählen

**"Invalid template parameters"**

* Fehlende oder fehlerhafte Variablenwerte

* Überprüfen und füllen Sie alle erforderlichen Felder aus

## **Vorlagenbeispiele**

**Einfache Textvorlage**

```

Name: welcome_message

Content: "Willkommen bei {{1}}! Wir freuen uns, Ihnen bei {{2}} zu helfen."

Variablen: Firmenname, Dienstleistungstyp
```

**Produktpräsentation (Medienvorlage)**

```

Name: product_launch

Medien: Produktbild

Content: "🎉 Neu eingetroffen! {{1}} ist jetzt für {{2}} verfügbar. Angebot für begrenzte Zeit!"

Variablen: Produktname, Preis
```

**Bestellbestätigung (Textvorlage)**

```

Name: order_confirmed

Content: "Hallo {{1}}! Ihre Bestellung {{2}} wurde bestätigt. Voraussichtliche Lieferung: {{3}}."

Variablen: Kundenname, Bestellnummer, Lieferdatum
```

**Quick Reply-Vorlage**

```

Name: support_options

Content: "Wie können wir Ihnen heute helfen?"

Buttons: "Technischer Support", "Abrechnung", "Allgemeine Info"
```

## **Einschränkungen**

**Aktuelle Einschränkungen**

* Vorlagen werden in Kampagnen nicht unterstützt (kommt in zukünftigen Updates)

* Listenauswahl-Vorlagen 

* Katalog-Vorlagen

* Karussell-Vorlagen

**Vorlagenbeschränkungen**

* Maximal 100 Variablen pro Vorlage

* Mediendateien müssen öffentlich zugänglich sein

* Vorlagen müssen von WhatsApp genehmigt werden

* Fortlaufende Parameternummerierung erforderlich

## **Support**

Für zusätzliche Hilfe:

* Siehe [Twilio WhatsApp Dokumentation](https://www.twilio.com/docs/whatsapp)

* Beachten Sie die [WhatsApp Business Platform Guidelines](https://developers.facebook.com/documentation/business-messaging/whatsapp/overview)

* Wenden Sie sich bei technischen Problemen an Ihren Systemadministrator

* Die Chatwoot-Dokumentation enthält allgemeine Anleitungen zur Plattform