JSONPath
Puede analizar correos electrónicos entrantes o webhooks en Planfix con JSON. Los correos electrónicos enviados a Planfix pueden analizarse usando JSON. JavaScript Object Notation es un formato para almacenar e intercambiar información disponible como texto legible por humanos. Hay dos elementos principales en un objeto JSON: la clave (key) y el valor (value).
Ejemplo:
{"city":"New York", "country":"United States"}
- claves — city y country;
- valores — New York y United States
Planfix puede analizar correos electrónicos en este formato y agregar los datos necesarios en bloques de información (info blocks) usando la JsonPath library. Nota: Si usa una función al analizar, asegúrese de insertar paréntesis al final; de lo contrario la función no funcionará.
Ejemplo №1
Envío de un correo electrónico con formato JSON a Planfix
- Como ejemplo, usaremos el siguiente JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
]
}
- Supongamos que necesitamos los siguientes datos del JSON:
{
"firstName": "Denis",
"lastName": "Evans",
"address": {
"streetAddress": "1109 SW 12th St",
"city": "Newport",
"postalCode": 97365
},
"phoneNumbers": [
"1-211-906-4147"
}
- Configuraríamos la siguiente regla para el procesamiento de correos:
- A continuación, creamos un nuevo cliente usando la plantilla, indicamos qué bloques de información (infoblocks) establecer desde qué campos y añadimos el contacto a la tarea creada a partir del correo:
- Como resultado, los datos necesarios del correo en formato JSON se transfirieron a Planfix:
Ejemplo №2
Añadir parámetros JSON a las etiquetas de datos de Planfix
Para este ejemplo, usaremos el JSON de un pedido de producto en una tienda online. Los datos necesarios para añadir analíticas están resaltados en rojo:
{
"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
}
]
}
- Configurar una regla separada para las tareas por correo. Analizar JSON:
- Crear una nueva tarea y notificar al empleado requerido sobre su creación:
- Añadir etiquetas de datos (Data tags) a la tarea creada. Nota: Es importante especificar el parámetro Add as many lines as there are values in the infoblock para asegurar que todos los valores se añadan a las etiquetas de datos.
- Como resultado, la tarea muestra la notificación y las etiquetas de datos:
