Messages modèles WhatsApp Everbridge : Guide étape par étape

Pour envoyer des messages WhatsApp prédéfinis depuis les modèles d'incidents Everbridge, un simple aperçu ne suffit pas. L'intégration ChatArchitect utilise une variable d'incident dédiée, appelée « Code WhatsApp », pour identifier le modèle WhatsApp approuvé, puis construit ses paramètres à partir des valeurs saisies dans le formulaire de l'opérateur. Les noms des champs, les numéros de séquence et l'ordre des paramètres déterminent la structure du message.

Ce guide explique comment configurer ce flux de travail à l'aide d'une alerte d'incident pratique à trois paramètres. Il aborde également les erreurs susceptibles de modifier le message final : valeurs manquantes, variables d'incident supplémentaires, champ ID mal placé et confusion entre l'ID du modèle Everbridge et celui du modèle WhatsApp.

Comment Everbridge envoie un modèle WhatsApp via ChatArchitect

Le modèle WhatsApp approuvé fournit le texte fixe. Everbridge fournit les informations spécifiques à l'incident, telles que le lieu, la description de l'événement et l'heure. ChatArchitect associe l'identifiant du modèle WhatsApp à ces informations pour préparer l'envoi.

Par exemple, le modèle approuvé pourrait indiquer : « Incident survenu à {{1}} : {{2}}. Signalé à {{3}}. » Un opérateur saisit le site, l’événement et l’heure dans des variables d’incident distinctes. Avec une configuration correcte, ces valeurs remplissent automatiquement les trois champs correspondants.

Cet article décrit le comportement de création de messages introduit entre le 31 mai et le 3 juin 2025 pour une intégration Everbridge et ChatArchitect existante. Il s'agit d'un guide de configuration et non d'un substitut à la configuration initiale de l'intégration. Pour une présentation plus complète, consultez notre aperçu de l'intégration de l'API WhatsApp Business avec Everbridge.

Ce dont vous avez besoin avant de configurer le modèle d'incident

Préparez les éléments suivants avant de modifier le formulaire :

• Une intégration Everbridge existante connectée à ChatArchitect.
• Accès à l'organisation concernée dans le portail Everbridge Manager et autorisation de modifier ses variables et modèles d'incident.
• Un modèle de message WhatsApp approuvé est disponible dans ChatArchitect.
• L'identifiant exact du modèle WhatsApp, copié avec ses accolades.
• Liste des espaces réservés du modèle et de la valeur que chacun doit recevoir.
• Le profil d'abonnement aux réponses configuré pour votre intégration.
• Destinataires désignés pour le premier envoi contrôlé.

Notez l'ordre des variables avant de travailler dans Everbridge. Si {{1}} représente le site et {{2}} l'événement, le formulaire doit transmettre la valeur du site avant celle de l'événement. Des noms de variables clairs facilitent le travail de l'opérateur, mais ne suffisent pas à établir la correspondance des paramètres.

Étape 1 : Copiez l’identifiant du modèle WhatsApp correct

Ouvrez l'application ChatArchitect, sélectionnez le modèle WhatsApp approuvé requis et copiez son ID. Conservez la valeur copiée intacte, y compris les accolades. Vous collerez cette valeur dans la variable d'incident nommée « Code WhatsApp ».

Ne remplacez pas l' identifiant du modèle affiché dans l'en-tête du modèle d'incident Everbridge. Cet identifiant permet de reconnaître le modèle Everbridge. WhatsApp Code a besoin de l'identifiant du modèle de message WhatsApp sélectionné dans ChatArchitect.

Il est important de bien distinguer les rôles des deux éléments : l’identifiant sélectionne le modèle WhatsApp approuvé ; les variables d’incident fournissent les valeurs de ses paramètres. Modifier le texte du message sortant d’Everbridge ne revient pas à sélectionner un autre modèle WhatsApp.

Étape 2 : Créer les variables d’incident

Dans le portail Everbridge Manager, sélectionnez l'organisation concernée et ouvrez Communications → Incidents → Variables. Cliquez sur Nouvelle variable, sélectionnez Zone de texteet nommez la variable d'identification « Code WhatsApp ». Choisissez une limite de caractères adaptée à l'identifiant copié, puis cliquez sur OK.

Créez ou réutilisez une variable pour chaque paramètre de modèle WhatsApp. Dans l'exemple de ce guide, utilisez Site, Eventet Time. Chaque variable doit contenir une valeur en texte brut. Par exemple, saisissez le nom d'un bâtiment sous la forme « Bâtiment A », plutôt que d'ajouter manuellement des crochets autour.

L'intégration lit la première valeur de chaque variable d'incident. Une variable à sélection multiple ne génère pas automatiquement un paramètre WhatsApp pour chaque option sélectionnée. Les champs à valeur unique facilitent la vérification du mappage et évitent toute ambiguïté.

Étape 3 : Ajouter et organiser les champs dans le formulaire de l’opérateur

Ouvrez Communications → Incidents → Modèles et modifiez le modèle d'incident souhaité. Dans Formulaire et message, incluez le code WhatsApp et toutes les variables nécessaires au modèle WhatsApp sélectionné. Indiquez les champs obligatoires lorsqu'une valeur vide empêcherait l'affichage correct du message.

Ensuite, ouvrez APERÇU ET MODIFICATION → Formulaire de l'opérateur. Vérifiez les nombres affichés à côté des variables et disposez les champs en les faisant glisser à l'endroit souhaité.

Le code WhatsApp et chaque paramètre WhatsApp doivent avoir un numéro de séquence supérieur ou égal à 3. Les champs dont le numéro est inférieur à ce seuil sont ignorés pour ce modèle. Placez le champ ID en troisième position ou plus tard, puis disposez les autres champs de paramètres dans l'ordre attendu par le modèle approuvé.

L'ordre affiché du formulaire est un guide utile, mais cette configuration suppose qu'il correspond aux numéros de séquence envoyés par votre déploiement. Si un champ apparaît correctement placé mais est absent du résultat WhatsApp, veuillez demander à l'administrateur de l'intégration de vérifier les numéros de séquence réels.

Le comportement modifié concerne également les champs de paramètres éligibles placés avant le code WhatsApp. Le fait de placer l'identifiant avant les paramètres facilite l'inspection du formulaire, mais son déplacement ne supprime pas les autres champs éligibles de la liste des paramètres.

Exemple complet d'alerte d'incident à trois paramètres

Supposons que le modèle de message WhatsApp approuvé contienne le texte suivant :

Incident à {{1}} : {{2}}. Signalé à {{3}}.

Configurez la partie WhatsApp du formulaire opérateur dans cet ordre :

1. Position 3 — Code WhatsApp : {{your-template-id}}
2. Position 4 — Site : Bâtiment A
3. Position 5 — Événement : Panne de courant
4. Position 6 — Heure : 14:30

La valeur {{your-template-id}} est un exemple, et non un identifiant à copier. Remplacez-la par l'identifiant exact copié depuis votre modèle approuvé dans ChatArchitect.

L'intégration génère la chaîne d'envoi suivante :

{{your-template-id}} {{Bâtiment A}} {{Panne de courant}} {{14:30}}

Le message attendu sur WhatsApp est :

Incident au bâtiment A : Panne de courant. Signalée à 14h30.

L'opérateur saisit « Bâtiment A », « Panne de courant »et « 14:30 » en texte brut. L'intégration ajoute les crochets de paramètres lors de l'assemblage du message. Conservez les crochets dans l'ID du modèle copié, mais ne les ajoutez pas manuellement aux valeurs des paramètres ordinaires.

Étape 4 : Vérifiez les paramètres des messages sortants et de leur distribution

Dans Message sortant → Tous les modes de distribution , conservez le contenu du modèle copié depuis ChatArchitect, en suivant les instructions de configuration de l'intégration. Ensuite, vérifiez les paramètres du modèle d'incident , sélectionnez WhatsApp comme mode de distribution et choisissez le profil d'abonnement aux réponses approprié . Enregistrez le modèle.

Lorsqu'un champ Code WhatsApp valide est renseigné, le modèle WhatsApp d'envoi utilise cet identifiant et les valeurs du formulaire. Modifier uniquement le texte du message sortant ne modifie pas le modèle WhatsApp sélectionné ni ses paramètres. Pour les modifier, mettez à jour le code WhatsApp ou les variables d'incident correspondantes.

Veillez à bien préciser cette distinction dans vos instructions aux opérateurs. Sans cela, une personne pourrait modifier l'aperçu du message sortant et supposer que le destinataire WhatsApp recevra le texte modifié, même si le modèle approuvé et les paramètres fournis restent inchangés.

Étape 5 : Lancez un test contrôlé et inspectez WhatsApp

Ouvrez Communications → Incidents → Créer un incident, sélectionnez le modèle configuré et remplissez le formulaire de l'opérateur. Vérifiez l'ID du modèle, chaque paramètre et les destinataires avant de continuer.

Passez à l'étape suivante, consultez les détails de l'incident et les options d'envoi, puis utilisez « Vérifier et envoyer ». Le bouton « Vérifier » dépend des paramètres de vérification de l'organisation ; le processus de vérification exact peut donc varier.

Lors du premier envoi après une modification de modèle, sélectionnez les destinataires de test désignés. Comparez le message WhatsApp reçu avec le résultat attendu : vérifiez la formulation corrigée, l’ordre des paramètres, l’orthographe et l’intégralité du message.

L'aperçu d'Everbridge affiche le message sortant configuré dans Everbridge. Il ne remplace pas la vérification du modèle de message WhatsApp reçu. Effectuez un test de bout en bout concluant comme une étape de vérification distincte avant d'utiliser le formulaire modifié pour les notifications opérationnelles.

Quatre règles pour éviter un mappage de paramètres incorrect

1. L'ordre des champs détermine les valeurs d'espace réservé

L'intégration transmet les valeurs éligibles dans leur ordre d'origine. Renommer une variable ne déplace pas sa valeur vers un autre emplacement réservé. Si le message reçu inverse le site et l'événement, vérifiez d'abord la séquence du formulaire.

2. Les champs supplémentaires renseignés peuvent devenir des paramètres

D'autres variables d'incident dont le numéro de séquence est supérieur ou égal à 3 sont également prises en compte lorsqu'elles sont renseignées. Veuillez vérifier l'intégralité du formulaire, y compris les champs non liés à WhatsApp. L'ajout d'une valeur avant vos paramètres peut modifier le nombre de paramètres ou décaler leur correspondance.

3. Les valeurs vides sont ignorées

Un champ vide ne réserve pas d'emplacement vide. Les valeurs saisies ultérieurement peuvent se décaler. Dans l'exemple ci-dessus, si le champ « Site » est laissé vide, le champ « Panne de courant » pourrait occuper la première position. Renseignez tous les champs requis par le modèle sélectionné.

4. Le code WhatsApp contrôle le flux de travail du modèle

Si le code WhatsApp est absent, vide ou inférieur à 3, l'intégration utilise le texte du message sortant d'Everbridge et n'ajoute pas les autres variables d'incident. Ceci décrit l'assemblage des messages ; la livraison d'un message de secours via WhatsApp n'est pas garantie. Pour ce modèle de flux de travail, veuillez toujours fournir l'identifiant valide.

Dépannage des messages modèles WhatsApp d'Everbridge

Des informations erronées apparaissent dans un champ réservé. Comparez l'ordre des paramètres avec le modèle approuvé. Vérifiez l'absence de valeurs vides et de champs supplémentaires renseignés avant de modifier le texte du modèle.

Un champ est manquant dans le message. Veuillez vérifier qu'il est renseigné, qu'il figure dans le formulaire de l'opérateur et qu'il possède un numéro de séquence d'au moins 3. S'il s'agit d'une variable à sélection multiple, seule sa première valeur est prise en compte.

L'intégration utilise le texte sortant au lieu de la chaîne de modèle prévue. Vérifiez le nom exact de la variable « Code WhatsApp », son ID copié et son numéro de séquence. N'utilisez pas l'ID d'en-tête du modèle d'incident Everbridge.

L'aperçu d'Everbridge semble correct, mais WhatsApp se comporte différemment. Examinez le code WhatsApp et les valeurs du formulaire. Un identifiant valide et renseigné sélectionne le modèle WhatsApp indépendamment des modifications apportées au texte sortant.

Le message WhatsApp attendu n'est pas arrivé. Veuillez vérifier la méthode de livraison sélectionnée, le profil d'intégration, les destinataires et le modèle approuvé, ainsi que la configuration du formulaire. Un paramétrage correct ne garantit pas à lui seul le bon déroulement de la livraison.

Foire aux questions

Quel est le code WhatsApp à Everbridge ?

Il s'agit de la variable d'incident utilisée par l'intégration ChatArchitect pour transmettre l'identifiant du modèle de message WhatsApp. Son nom doit correspondre exactement à « Code WhatsApp » et son numéro de séquence doit être supérieur ou égal à 3.

Dois-je encadrer les valeurs des incidents par des accolades ?

Non. Saisissez les valeurs des paramètres en texte brut. L'intégration ajoute les crochets. L'identifiant du modèle est différent : conservez ses crochets exactement tels qu'ils ont été copiés depuis ChatArchitect.

Les champs de paramètres peuvent-ils précéder le code WhatsApp ?

Oui. Le comportement modifié inclut les champs de paramètres non vides éligibles, même s'ils précèdent l'identifiant. Leur numéro de séquence doit toujours être supérieur ou égal à 3, et leur ordre doit correspondre aux espaces réservés du modèle.

Le fait de modifier le message sortant sélectionne-t-il un modèle différent ?

Non, lorsqu'un code WhatsApp valide est renseigné. Modifiez cet identifiant pour sélectionner un autre modèle approuvé, puis vérifiez le nombre et l'ordre de ses paramètres.

Que dois-je mettre à jour dans un modèle d'incident plus ancien ?

Ajoutez ou renseignez le code WhatsApp, incluez toutes les variables de paramètres requises et vérifiez leur numéro de séquence et leur ordre. L'intégration mise à jour conserve une solution de repli en texte brut. ChatArchitect a annoncé séparément qu'un identifiant sera requis pour l'envoi de modèles à partir du 1er août 2025 ; veuillez toujours copier l'identifiant correct pour le flux de travail du modèle décrit ici.

Préparez votre flux de travail Everbridge WhatsApp avec ChatArchitect

Une configuration de formulaire fiable repose sur un identifiant de modèle précis et une séquence de paramètres prévisible. Il est essentiel de simplifier la tâche de l'opérateur : sélectionner le modèle souhaité, renseigner les champs obligatoires, vérifier les destinataires et contrôler le message reçu après chaque modification de configuration.

Utilisez le guide d'installation du modèle ChatArchitect Everbridge comme référence. Si vous prévoyez une intégration, consultez les offres de l'API WhatsApp Business de ChatArchitect et préparez un exemple de message d'incident contenant les champs nécessaires à votre équipe.