Comment adapter le format de mes données à ce qu'attend mon API ?

Un nœud « Transformer les données » remplace des valeurs, assemble des champs, complète avec des zéros ou reformate un téléphone, avant l'envoi vers votre webhook, OGGO Data ou Nova.

Ce que fait ce nœud

Votre outil n'attend pas forcément nos valeurs telles quelles. Une réponse de qualification vaut man ou woman chez nous, c'est-à-dire homme ou femme, votre API attend peut-être H ou F. Un régime de sécurité sociale vaut SS ou TNS chez nous, un autre code chez vous. Une date de naissance arrive en trois réponses séparées, jour, mois, année, votre outil attend 03/07/1958. Un numéro de téléphone est stocké au format international, +33612345678, votre outil attend 0612345678.

Le nœud Transformer les données couvre ces quatre cas, avec de simples listes déroulantes, sans écrire de code.

Ce qu'il faut avoir sous la main

Un flux déjà créé, avec au moins une destination webhook, OGGO Data ou Nova en dessous du nœud.
Le droit de gérer les intégrations sur votre compte, voir Que peut faire chaque rôle ?.

Les quatre opérations

Remplacer des valeurs : une table « valeur reçue → valeur envoyée ». C'est l'opération pour man → H, ou pour un régime interne vers le code que votre outil attend.
Assembler des champs : plusieurs champs mis bout à bout avec un séparateur. C'est l'opération qui construit une date jj/mm/aaaa depuis trois réponses distinctes.
Compléter avec des zéros : porte un nombre à une longueur fixe. Un jour de naissance valant 3 devient 03, nécessaire pour qu'un jour à un seul chiffre ne casse pas le format jj/mm/aaaa de l'étape suivante.
Reformater un téléphone : convertit un numéro stocké au format international vers le format national, national espacé, international en 00, ou chiffres seuls.

L'ordre des règles compte

Les règles s'exécutent de haut en bas, et une règle peut lire ce qu'une règle précédente a produit. Pour obtenir 03/07/1958 depuis un jour, un mois et une année séparés :

Compléter avec des zéros le jour (3 devient 03).
Compléter avec des zéros le mois, si nécessaire.
Assembler des champs : jour, mois, année, séparés par /.

Dans l'ordre inverse, vous obtiendriez 3/7/1958.

Où ça s'applique, et où ça ne s'applique pas

Les règles s'appliquent au webhook, à OGGO Data et à Nova placés en dessous du nœud ; une étape posée au-dessus ne change pas.

Les feuilles Google et Excel gardent les valeurs d'origine, avec leur propre mise en forme. Les filtres aussi comparent toujours les réponses d'origine : renommer man en H ne casse donc pas un filtre « sexe est man ».

Le chemin, depuis le tableau de bord

1. Ouvrez l'écran Intégration

Dans le menu de gauche, cliquez sur Intégrations, puis ouvrez le flux à régler.

2. Ajoutez l'étape « Transformer les données »

Cliquez sur le + de la toile. Sous Logique, à côté de Filtre, choisissez Transformer les données.

3. Ajoutez une règle

Cliquez sur Ajouter une règle, choisissez l'opération, le champ à lire, et le nom exact que votre outil doit recevoir sous Nom envoyé. Ce nom devient une clé du document envoyé : il doit correspondre lettre pour lettre à ce que votre outil attend.

Une exception : phoneNumber est réservé à l'opération Reformater un téléphone. Une autre opération réglée sur ce nom est refusée, pour protéger le numéro utilisé pour joindre le prospect.

4. Choisissez les champs proposés

La liste des champs disponibles suit le périmètre du déclencheur de ce flux : ouvert à toutes vos campagnes, vous voyez tous vos champs de qualification ; restreint à certaines verticales ou campagnes, vous ne voyez que ceux qu'elles portent réellement. Une réponse absente de la liste n'existe dans aucune campagne de ce périmètre.

5. Ordonnez vos règles si nécessaire

Les flèches Monter et Descendre changent l'ordre d'exécution. Le champ produit par une règle réapparaît dans la liste des règles suivantes, sous le groupe « Produits par une règle au-dessus ».

6. Testez, règle par règle

Depuis l'onglet Test du flux, lancez l'essai. Les valeurs produites par le nœud s'affichent, sous chaque règle.

« Rien produit sur cet essai pour : » signale une règle dont le champ lu est vide sur cette mise en relation précise. Ce n'est pas un défaut de réglage : une autre mise en relation, qui a répondu à cette question, la remplira normalement.
« Valeur hors de la table, rien envoyé : » signale une règle Remplacer des valeurs réglée sur « Ne rien envoyer », quand la réponse reçue n'a pas de ligne dans la table. La réponse existe, elle manque seulement à votre table de correspondance.

Aucun des deux n'empêche l'envoi des autres champs : le reste part normalement, seul le champ concerné manque.

Ce qui bloque l'activation

Une règle à moitié réglée peut être enregistrée, jamais activée. Le message est : « Une règle de transformation n'est pas terminée : il lui manque un champ, un nom envoyé ou une valeur. » Complétez la règle, ou supprimez-la, puis réessayez.

Ce qui est hors de portée de ce nœud

Les calculs de date n'en font pas partie : une date d'effet au premier jour du mois suivant, par exemple, dépend du jour de l'envoi, pas seulement des réponses de la mise en relation. Ce nœud réécrit des valeurs déjà présentes, il n'en calcule pas de nouvelles. Pour un champ calculé, ou qui ne doit partir que dans certains cas, utilisez une étape Code.