JSONPath
Vous pouvez analyser les emails entrants ou les webhooks dans Planfix au format JSON. Les emails envoyés à Planfix peuvent être analysés en JSON. JavaScript Object Notation est un format de stockage et d'échange d'informations disponible sous forme de texte lisible. Il y a deux éléments principaux dans un objet JSON : la clé (key) et la valeur (value).
Exemple :
{"city":"New York", "country":"United States"}
- clés — city et country ;
- valeurs — New York et United States
Planfix peut analyser les emails au format JSON et ajouter les données nécessaires dans les blocs d'information à l'aide de la JsonPath library. Remarque : si vous utilisez une fonction lors de l'analyse, assurez-vous d'insérer des parenthèses à la fin, sinon la fonction ne fonctionnera pas.
Exemple n°1
Envoi d'un email au format JSON à Planfix
- À titre d'exemple, nous utiliserons le JSON suivant :
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
]
}
- Supposons que nous ayons besoin des données suivantes dans le JSON :
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
}
- Nous configurerions la règle suivante pour le traitement des emails :
- Ensuite, nous créons un nouveau client à partir du modèle, indiquons quels blocs d'information remplir depuis quels champs, et ajoutons le contact à la tâche créée à partir de l'email :
- En conséquence, les données nécessaires de l'email au format JSON ont été transférées dans Planfix :
Exemple n°2
Ajout de paramètres JSON aux tags de données Planfix
Pour cet exemple, nous utiliserons le JSON d'une commande produit dans une boutique en ligne. Les données requises pour l'ajout d'analytique sont mises en évidence en rouge :
{
"site": "mysite.shop",
"name": "Denis Evans",
"id": "6598634",
"date": "30.11.2024 09:16:05",
"status": "In progress",
"email": "techT7@gmail.com",
"phone": "+1 211 906-4147",
"address": "1109 SW 12th St1",
"price_total": "466.45",
"item_order": [
{
"sku": "598623",
"name": Cobalt drill bit set 29pc",
"barcode": "596325689126",
"price": "29.99",
"quantity": 5
},
{
"sku": "589624",
"name": "High torque driver",
"barcode": "5963256858963",
"price": "230.00",
"quantity": 1
},
{
"sku": "579824",
"name": "Half inch ratchet 120 tooth",
"barcode": "5963256889634",
"price": "43.25",
"quantity": 2
}
]
}
- Configuration d'une règle distincte pour les tâches par email. Analyse JSON :
- Créer une nouvelle tâche et notifier l'Employé requis de sa création :
- Ajout de tags de données à la tâche créée. Remarque : il est important de spécifier le paramètre Add as many lines as there are values in the infoblock afin de garantir que toutes les valeurs soient ajoutées aux tags de données.
- En conséquence, la tâche affiche la notification et les tags de données :
