Variables

Les variables permettent d'insérer dynamiquement des informations relatives au contact, à l'organisation ou à l'événement déclencheur dans le texte d'un message. La syntaxe est {{espace.nom}}.

Variables de contact

Ces variables sont disponibles dans tous les messages envoyés à un contact. Si l'information n'est pas connue, la variable est remplacée par une chaîne vide.

Variable	Description
`{{contact.prenom}}`	Prénom du contact
`{{contact.nom}}`	Nom de famille du contact
`{{contact.telephone}}`	Numéro de téléphone du contact au format E.164
`{{contact.email}}`	Adresse email du contact
`{{contact.entreprise}}`	Nom de l'entreprise du contact
`{{contact.ville}}`	Ville du contact
`{{contact.langue}}`	Langue préférée du contact (`fr`, `en`, etc.)

Variables d'organisation

Ces variables sont liées à l'organisation qui envoie la relance. Elles sont identiques pour tous les messages de l'organisation.

Variable	Description
`{{compte.nom}}`	Nom de l'organisation
`{{compte.email}}`	Adresse email de l'organisation
`{{compte.telephone}}`	Numéro de téléphone principal de l'organisation
`{{compte.site_web}}`	URL du site web de l'organisation
`{{compte.adresse}}`	Adresse postale de l'organisation
`{{compte.horaires}}`	Horaires d'ouverture, formatés

Variables d'événement

Ces variables sont spécifiques à l'événement qui a déclenché la relance.

Appel manqué

Variable	Description
`{{evenement.appel.numero}}`	Numéro appelé par le client
`{{evenement.appel.horodatage}}`	Date et heure de l'appel
`{{evenement.appel.duree}}`	Durée de l'appel en secondes
`{{evenement.appel.statut}}`	Statut de l'appel (`no-answer`, `busy`, `failed`)

Panier abandonné

Variable	Description
`{{evenement.panier.reference}}`	Référence du panier
`{{evenement.panier.montant}}`	Montant total du panier
`{{evenement.panier.lien}}`	URL de reprise du panier
`{{evenement.panier.produits}}`	Liste des produits du panier

Import CSV

Variable	Description
`{{evenement.import.nom_fichier}}`	Nom du fichier CSV importé
`{{evenement.import.segment}}`	Étiquette du segment
`{{evenement.import.nombre_contacts}}`	Nombre de contacts importés

Utilisation dans un message

Les variables s'insèrent dans le body_source d'un message, dans le template ou dans un texte statique.

{
  "id": "send-whatsapp-recall",
  "type": "message",
  "data": {
    "label": "Envoyer un WhatsApp de rappel",
    "channel": "whatsapp",
    "parameters": {
      "template": "appel_manque_rappel",
      "body_source": "statique",
      "body": "Bonjour {{contact.prenom}}, vous avez essayé de joindre {{compte.nom}} à {{evenement.appel.horodatage}}. Souhaitez-vous que nous vous rappelions ?"
    }
  }
}

Comportement par défaut

Si une variable n'a pas de valeur disponible au moment de l'envoi, elle est remplacée par une chaîne vide. Pour éviter un texte maladroit, utilisez les variables dans des phrases complètes :

Correct : « Bonjour {{contact.prenom}}, ... » (l'utilisateur avec ou sans prénom aura un message lisible)
À éviter : « M. {{contact.nom}} » (si le nom est vide, on aura « M. » tout court)

Pour insérer une accolade littérale dans un message, doublez-la : `{{ }}` reste {{ et }} après interprétation. Le contenu d'un champ parameters est traité en texte brut, sauf les appels à {{variable}} qui sont substitués au moment de l'envoi.