Variables

Heedify Variables est un stockage clé/valeur JSON par Entité pour le contexte client via l’enregistrement DB Object, intégré aux flux d’appel Microsoft Teams pour personnaliser le routage — jusqu’à 100 clés à la racine plus 100 clés primitives dans customData par enregistrement. Les valeurs sont alimentées par des workflows (webhooks) et consommées par le routage des flux d’appel — par exemple pour router un client VIP vers une file dédiée.

Deux choses différentes sont appelées « variables » dans Heedify — ne les confondez pas :

  • Variables (cette page) — un enregistrement client stocké par Entité (le DB Object). Il est recherché par clé client à chaque appel et lu par les nœuds de routage Vérifier Variable. Il persiste entre les appels.
  • Variables d’exécution de workflow — des jetons $VARIABLE$ utilisés dans l’Action d’un Workflow (URL, en-têtes, corps) ainsi que toutes les valeurs que le Mapping d’un workflow capture depuis une réponse d’API. Elles n’existent que le temps d’un seul appel. Voir Workflows → Mapping.

Périmètre

Chaque enregistrement de variables appartient à une Entité et est identifié par la combinaison de :

  • Entité — l’Entité à laquelle l’enregistrement appartient (sélectionnée à la création)
  • Clé client — un identifiant unique stocké à la racine de l’objet DB (typiquement un numéro de téléphone, un identifiant de compte ou un ID CRM externe)

Lors de la réception d’un appel, le moteur de routage cherche l’enregistrement correspondant à l’Entité courante + l’identifiant de l’appelant. Les enregistrements d’autres Entités ne sont jamais visibles par un flux exécuté dans une autre Entité, donc le même identifiant peut correspondre à des valeurs différentes selon l’Entité sans collision.

Créer un jeu de variables

  1. Ouvrez Variables depuis la barre latérale
  2. Cliquez sur +Ajouter
  3. Renseignez les champs et enregistrez

Champs

Champ Description
Nom d’affichage Nom affiché dans la liste (requis). Le système ajoute automatiquement le préfixe DB_ si vous l’omettez
Entité Entité à laquelle les variables appartiennent (requis)
DB Object Structure JSON avec les clés et valeurs

Règles du DB Object

L’objet DB doit respecter ces contraintes :

  • Maximum 100 clés à la racine de l’objet DB
  • Doit contenir un objet customData
  • Maximum 100 clés dans customData
  • Les valeurs dans customData doivent être des primitives uniquement (string, number, boolean, null) — pas d’objets ni de tableaux imbriqués
  • Pas de clés dupliquées

La limite de 100 clés s’applique par niveau, pas en total. Vous pouvez avoir jusqu’à 100 clés à la racine du DB ET jusqu’à 100 clés dans customData.

Exemple :

{
  "customerId": "+33612345678",
  "customData": {
    "loyalty_tier": "gold",
    "is_vip": true,
    "case_id": null
  }
}

Dans cet exemple, customerId est la clé client que le moteur de routage compare à l’appel entrant. Le bloc customData porte tous les champs primitifs qu’un flux peut souhaiter lire.

Utiliser les variables dans les flux

Dans un Flux d’appel, utilisez des nœuds Vérifier Variable pour brancher :

  • “Si customData.is_vip est true, router vers la file VIP”
  • “Si customData.loyalty_tier est gold, sauter le SVI”

Le flux lit l’enregistrement correspondant à entité + clé client et évalue le chemin que vous spécifiez par rapport aux valeurs qui s’y trouvent.

Alimenter les variables

Utilisez un workflow déclenché sur Agent Connected ou un événement précoce de l’appel. L’Action du workflow appelle votre API et son Mapping capture des champs depuis la réponse ; ces valeurs sont écrites dans l’enregistrement de variables pour l’Entité + la clé client, prêtes pour le routage de l’appel suivant.

FAQ

Q : Que puis-je stocker dans Heedify Variables ? R : Les clés client à la racine du DB Object (typiquement un numéro de téléphone, un identifiant de compte ou un ID CRM externe) et des primitives (string, number, boolean, null) dans l’objet customData requis. Pas d’objets ni de tableaux imbriqués — Heedify impose un seul niveau sous customData.

Q : Comment un flux d’appel Heedify retrouve-t-il le bon enregistrement ? R : Le moteur de routage cherche sur l’Entité courante plus l’identifiant de l’appelant (la clé client à la racine du DB Object). Les enregistrements d’autres Entités ne sont jamais visibles par un flux exécuté dans une autre Entité.

Q : Puis-je stocker des objets imbriqués dans Heedify Variables ? R : Un seul niveau. La racine du DB porte la clé client plus jusqu’à 100 clés, et l’objet customData porte jusqu’à 100 clés primitives. Heedify rejette les objets ou tableaux imbriqués dans customData.

Q : Comment Heedify Variables est-il alimenté ? R : Utilisez un workflow déclenché sur un événement précoce de l’appel (typiquement Agent Connected). Le webhook retourne un payload JSON que Heedify fusionne dans l’enregistrement de variables identifié par Entité + clé client.

Works with : Microsoft Teams, Teams Phone, Workflows, Flux d’appel, CRM via webhook.