Les modèles de contenu Twilio vous permettent d'envoyer des modèles de messages WhatsApp préapprouvés via vos canaux WhatsApp Business Twilio dans Chatwoot. Ces modèles vous permettent d'initier des conversations et d'envoyer des messages structurés conformes aux politiques de messagerie de WhatsApp.

## **Types de modèles pris en charge**

**Modèles Texte**

* Messages texte simples avec variables optionnelles

* Prise en charge jusqu'à 100 variables par modèle au format `{{1}}`, `{{2}}`

* Prise en charge multilingue

**Modèles Média**

* **Modèles Image** : Texte avec entête image (JPEG/PNG, max 5 Mo)

* **Modèles Vidéo** : Texte avec entête vidéo (MP4/3GPP, max 16 Mo)

* **Modèles Document** : Texte avec pièces jointes (PDF/formats Office, max 100 Mo)

* Prise en charge des URL médias dynamiques avec variables

**Modèles Réponse rapide**

* Boutons interactifs gérés par WhatsApp

* Actions par bouton simples pour réponses courantes

* Prise en charge de plusieurs variantes linguistiques

**Modèles Appel à l'action**

* **Modèles Boutons URL** : Envoyez des messages avec des boutons d'action cliquables

* **Prise en charge des variables** : Le texte du message et les boutons peuvent inclure des variables

* **Types d'action** : Boutons URL pour paiements, réservations, sites web, etc.

## **Prérequis**

Avant d’utiliser les modèles de contenu Twilio :

1. **Compte Twilio** : Compte Twilio actif avec accès à l’API WhatsApp Business

2. **Modèles approuvés** : Modèles créés et approuvés dans la console Twilio

3. **Intégration Chatwoot** : Canal WhatsApp Twilio configuré dans Chatwoot

4. **Compte WhatsApp Business** : Profil WhatsApp Business vérifié

## **Configuration des modèles**

1. Connectez-vous à votre [Console Twilio](https://console.twilio.com/)

2. Rendez-vous dans **Messaging** → **Content Template Builder**

3. Cliquez sur **Créer un nouveau modèle**

4. Choisissez votre type de modèle : **Texte** : Pour messages simples, **Media** : Pour images, vidéos ou documents,  **Réponse rapide** : Pour boutons interactifs

5. Configurez le modèle selon l'objectif.

6. Soumettez le modèle pour approbation WhatsApp

7. Attendez l'approbation (5 minutes à 24 heures)

8. Les modèles approuvés reçoivent un ContentSid

9. Les modèles sont maintenant prêts à être utilisés dans Chatwoot

## **Synchronisation des modèles sur Chatwoot**

**Synchronisation automatique via API**

Les modèles sont synchronisés automatiquement lorsque vous :

1. Ouvrez la fenêtre des modèles de contenu dans une conversation

2. Créez une nouvelle conversation avec un canal WhatsApp Twilio

**Synchronisation manuelle**

Pour les administrateurs de boîtes de réception :

1. Allez dans **Paramètres** → **Boîtes de réception**

2. Sélectionnez votre boîte WhatsApp Twilio

3. Cliquez sur le bouton **Synchroniser les modèles**

4. Attendez la notification de fin de synchronisation

## **Utilisation des modèles en conversation**

#### **Étape 1 : Accéder aux options de modèles**

Ouvrez une conversation avec un contact WhatsApp, cliquez sur l’**icône de modèle** dans le champ de composition, sélectionnez **"Modèles WhatsApp"** dans le menu déroulant

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

#### **Étape 2 : Choisissez votre modèle**

Parcourez vos modèles approuvés, utilisez la barre de recherche pour trouver rapidement des modèles spécifiques

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

#### **Étape 3 : Personnalisez votre message**

Selon le type de modèle, il peut être nécessaire de remplir :

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

## **Bonnes pratiques**

**Conception des modèles**

* Restez concis et clair dans vos messages

* Utilisez les variables pour personnaliser

* Assurez-vous que les fichiers médias sont optimisés et accessibles

* Testez les modèles avant soumission pour approbation

**Utilisation des variables**

* Utilisez des noms de variables descriptifs dans la console Twilio

* Fournissez des exemples clairs lors de la soumission

* Gardez un nombre raisonnable de variables (moins de 10 pour une meilleure expérience)

**Directives médias**

* Hébergez les fichiers médias sur des serveurs fiables et rapides

* Utilisez des URLs HTTPS pour tous les médias

* Optimisez la taille des fichiers pour une livraison rapide

* Incluez un texte de remplacement dans les modèles média

**Conformité**

* Respectez les règles d’utilisation de WhatsApp Business

* Les modèles doivent répondre à un objectif commercial légitime

* Respectez la vie privée et le consentement des utilisateurs

* Surveillez la performance et le statut d’approbation des modèles

## **Dépannage**

**Problèmes courants**

**Modèle non affiché**

* **Cause** : Modèle non approuvé par WhatsApp

* **Solution** : Vérifiez le statut d’approbation dans la console Twilio

**Échec de la synchronisation du modèle**

* **Cause** : Problèmes de connexion API ou identifiants invalides

* **Solution** : Vérifiez les identifiants Twilio et relancez la synchronisation

**Média non chargé**

* **Cause** : URL du média inaccessible ou au mauvais format

* **Solutions** : Vérifiez que l’URL est accessible publiquement, contrôlez le format et la taille du fichier, assurez-vous du protocole HTTPS

**Variables non fonctionnelles**

* **Cause** : Mauvais format de variable ou valeurs manquantes

* **Solutions** : Utilisez le format `{{1}}`, `{{2}}` dans Twilio, renseignez toutes les variables requises dans Chatwoot, vérifiez que le nombre de variables correspond au modèle

## **Messages d’erreur**

**"Template not found"**

* Modèle non synchronisé dans Chatwoot

* Lancez une synchronisation manuelle ou vérifiez l’approbation

**"Media file too large"**

* Fichier dépassant la limite imposée par WhatsApp

* Compressez le fichier ou utilisez un autre format

**"Invalid template parameters"**

* Valeurs de variable manquantes ou incorrectes

* Revérifiez et complétez tous les champs requis

## **Exemples de modèles**

**Modèle Texte Basique**

```

Nom : welcome_message

Contenu : "Bienvenue chez {{1}} ! Nous sommes ravis de vous aider avec {{2}}."

Variables : Nom de l’entreprise, type de service
```

**Présentation de produit (modèle média)**

```

Nom : product_launch

Média : Image du produit

Contenu : "🎉 Nouveauté ! {{1}} est maintenant disponible pour {{2}}. Offre limitée !"

Variables : Nom du produit, prix
```

**Confirmation de commande (modèle texte)**

```

Nom : order_confirmed

Contenu : "Bonjour {{1}} ! Votre commande {{2}} a été confirmée. Livraison prévue : {{3}}."

Variables : Nom du client, ID commande, date de livraison
```

**Modèle Réponse Rapide**

```

Nom : support_options

Contenu : "Comment pouvons-nous vous aider aujourd’hui ?"

Boutons : "Assistance technique", "Facturation", "Informations générales"
```

## **Limitations**

**Limitations actuelles**

* Modèles non pris en charge dans les campagnes (à venir dans de futures mises à jour)

* Modèles sélectionneur de liste 

* Modèles catalogue

* Modèles carrousel

**Limites des modèles**

* Maximum 100 variables par modèle

* Les fichiers médias doivent être accessibles publiquement

* Les modèles requièrent approbation WhatsApp

* Numérotation séquentielle des paramètres requise

## **Support**

Pour obtenir de l’aide supplémentaire :

* Consultez la [Documentation WhatsApp Twilio](https://www.twilio.com/docs/whatsapp)

* Lisez les [Directives de la plateforme WhatsApp Business](https://developers.facebook.com/documentation/business-messaging/whatsapp/overview)

* Contactez votre administrateur système pour les problèmes techniques

* Consultez la documentation Chatwoot pour les guides généraux de la plateforme