Modèles

Un modèle est un texte de message que vous enregistrez une fois et réutilisez. Il peut contenir des variables, des trous entre accolades comme {prenom}, que la passerelle remplit avec les informations du contact destinataire.

À quoi servent les modèles

• Répondre aux mêmes questions dans une conversation sans tout retaper : horaires, adresse, coordonnées de paiement.
• Donner une touche personnelle à une réponse automatique : « Bonjour {prenom}, nous avons bien reçu votre message ».
• Garder le texte d'une campagne au même endroit, validé une fois, au lieu de le recopier depuis une ancienne campagne.

Comment ça marche

Un modèle a quatre champs :

La limite de 4000 caractères est une borne de stockage, pas une recommandation : un SMS de plus de 160 caractères est facturé comme plusieurs SMS. Voir Envoyer des messages pour le calcul de la longueur.

Les variables

Écrivez le nom d'un champ entre accolades. Deux formes existent :

Une variable laissée visible est voulue : un SMS qui affiche « Bonjour {prenom} » est une erreur que vous remarquez en relisant, alors que « Bonjour , » avec un trou vide passerait inaperçu. Quand un champ peut être vide, donnez toujours une valeur de repli après la barre.

Les noms ne tiennent pas compte de la casse ({Prenom} et {prenom} sont identiques), et chaque champ répond à un nom français et à un nom anglais :

Les champs personnalisés se renseignent sur chaque contact : voir Contacts et groupes. Un champ personnalisé ne remplace jamais l'un des noms intégrés ci-dessus.

Où les modèles sont utilisés

Deux conséquences à garder en tête :

• Une campagne n'est pas personnalisée par destinataire. Écrivez les modèles de campagne avec des valeurs de repli ({prenom|Cher client}) ou sans variable, et relisez le récapitulatif de l'assistant avant de lancer : une variable oubliée y est visible.
• Modifier un modèle ne change pas ce qui est déjà parti, ni une campagne déjà créée à partir de lui : la campagne a gardé sa propre copie du texte à sa création.

Créer et modifier des modèles

Dans cette version, les modèles se créent, se modifient et se suppriment par l'API ; le tableau de bord les liste partout où l'on peut en choisir un (assistant de campagne, formulaire de règle, zone de saisie des conversations) mais n'a pas d'écran pour les rédiger. Tout outil capable d'envoyer une requête HTTP convient (curl, Postman, n8n, votre propre code), avec une clé API : voir Utiliser l'API et Clés API.

Exemple :

curl -X POST https://sms.exemple.com/api/v1/templates \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Horaires", "category": "support",
       "body": "Bonjour {prenom|à vous}, nous sommes ouverts du lundi au vendredi, de 9 h à 18 h."}'

Avec une clé API, la lecture demande la portée read et toute modification la portée admin. Voir Clés API.

Vous ne déclarez jamais les variables : la passerelle les lit dans le texte à chaque fois, la liste ne peut donc jamais contredire le texte.

Vérifier avant d'envoyer : l'aperçu

POST /api/v1/templates/{templateId}/preview accepte un contactId (un vrai contact) et/ou des variables (des valeurs que vous saisissez, qui l'emportent sur celles du contact), et renvoie :

L'aperçu est permis à tous les rôles, Lecture seule compris : il ne modifie rien.

Qui peut faire quoi

Voir Utilisateurs et rôles.

Dépannage