Campo (Variable)

Un campo, también conocido como variable, es un contenedor para almacenar un valor.

| Clasificación | Descripción |

| --- | --- |

| campo del sistema y campo personalizado | el campo del sistema es creado por el sistema con un nombre de variable y tipo predefinidos, mientras que el campo personalizado lo defines tú mismo |

| campo del bot y campo del usuario | el campo del bot se comparte en todo el bot, mientras que cada usuario tiene su propio conjunto de campos de usuario |

| campo de texto, campo numérico, campo booleano, campo de fecha, campo de fecha y hora y campo JSON | consulta el tipo de variable |

Campo de Usuario

El campo de usuario pertenece a los usuarios. Por ejemplo, cada usuario tiene su propio nombre y dirección de correo electrónico. Por lo tanto, "name" y "email" son campos de usuario.

Campo del Bot

El campo del bot pertenece al bot. Por ejemplo, un bot de restaurante almacena la dirección y el número de contacto del restaurante. Por lo tanto, "restaurant_address" y "restaurant_contact" deben crearse como campos del bot. Esto es porque no quieres administrar diferentes direcciones o contactos de tu restaurante para cada usuario.

Campo del Sistema

El campo del sistema es creado por el sistema con un nombre de variable y un tipo de variable predefinidos. Existen campos del sistema del bot y campos del sistema del usuario.

Algunos campos del sistema solo existen en un canal específico. Consulta la siguiente tabla para ver cómo editar un campo del sistema:

| Nombre del Campo | Tipo de Campo | Tipo de Variable | Descripción | Cómo Editarlo |

| --- | --- | --- | --- | --- |

| User Ns | user field | text | identificación del usuario en OneChat | no editable |

| User Id* | user field | text | identificación del usuario desde el canal | no editable |

| First Name | user field | text | información del perfil | en Question Step/Action Step |

| Last Name | user field | text | información del perfil | en Question Step/Action Step |

| User Name | user field | text | información del perfil | en Action Step |

| Gender | user field | text | información del perfil | en Action Step |

| Email | user field | text | información del perfil | en Question Step/Action Step |

| Phone | user field | text | información del perfil | en Question Step/Action Step |

| Profile Image | user field | text | información del perfil | en Question Step |

| Locale | user field | text | información del perfil | no editable |

| Timezone | user field | text | información del perfil | no editable |

| Language | user field | text | información del perfil | en Action Step |

| Subscribed | user field | datetime | hora de suscripción | no editable |

| Last Text Input | user field | text | última entrada del usuario | editado por el sistema |

| Last Interaction | user field | datetime | hora de la última acción | editado por el sistema |

| Last Button Title | user field | text | último botón presionado | editado por el sistema |

| Flow Ns | bot field | text | identificación del flujo (bot) en OneChat | no editable |

| Sub Flow Ns | bot field | text | identificación del subflujo en OneChat | no editable |

| Page Name | bot field | text | nombre de la página de Facebook conectada | no editable |

| Page Id | bot field | text | id de la página de Facebook conectada | no editable |

| Page User Name | bot field | text | nombre de usuario de la página en Facebook | no editable |

| Last FB Comment | user field | text | texto del último comentario del usuario en la página de Facebook | editado por el sistema |

| Last FB Comment Post Id | user field | text | id de la publicación donde el usuario hizo el último comentario | editado por el sistema |

| Last FB Comment total tagged users | user field | number | cantidad de usuarios etiquetados en el último comentario | editado por el sistema |

| Last FB Comment total new tagged users | user field | number | cantidad de usuarios etiquetados pero que aún no se han suscrito (al bot) | editado por el sistema |

| Last FB Comment is existing users | user field | number | antes de este comentario, ¿ya era un usuario existente? sí=1, no=0 | editado por el sistema |

| Live Chat Url | user field | text | (para el agente) visitar para hablar con el usuario en live chat | editado por el sistema |

| NOW | user field | datetime | hora actual en la zona horaria del usuario* | editado por el sistema |

| TODAY | user field | date | fecha actual en la zona horaria del usuario* | editado por el sistema |

| BOT_CURRENT_TIME | bot field | datetime | fecha y hora actual en la zona horaria del espacio de trabajo | editado por el sistema |

| ITEM | user field | array (JSON) | cada elemento dentro de un JSON | en el mensaje "For Each" |

| SELECT | user field | array (JSON) | elemento seleccionado | en el nuevo paso "Select" |

| SHOP | bot field | array (JSON) | información de la tienda | en Ecommerce Integration |

| CART | user field | array (JSON) | carrito de compras del usuario | en Action Step |

| ORDER | user field | array (JSON) | último pedido del usuario | editado por el sistema |

| User | user field | array (JSON) | perfil del usuario | editado por el sistema de acuerdo con otros valores del perfil |

| DialogFlow | user field | array (JSON) | respuesta de DialogFlow | editado por el agente de DialogFlow |

Nota: si el canal no admite zona horaria en el perfil del usuario, o si el canal la admite pero el usuario no tiene un valor de zona horaria, se utilizará en su lugar la zona horaria del espacio de trabajo.

User Id en Diferentes Canales:

| Canal | Significado | Valor de Ejemplo |

| --- | --- | --- |

| Facebook | Id único en tu página de Facebook | 6288386817841812 |

| Instagram | Id único en tu bot de Instagram | 6570462892993643 |

| Telegram | Id único en tu bot de Telegram | 1173717756 |

| Slack | Id único en tu espacio de trabajo de Slack | U017MKNENH |

| WeChat | Id único en tu cuenta de WeChat | oNzS3wpEjnA3tXmOcNxpqtAnBwWg |

| WhatsApp | Número de teléfono del usuario sin + | 61412345678 |

| SMS | Número de teléfono del usuario | +61412345678 |

| Voice | Número de teléfono del usuario | +61412345678 |

| Google | Id de conversación de Google | 8095938e-90cf-4347-ab94-9224308672b0 |

| Line | Id único en tu bot de Line | Ub02c77c69c59c5be5597d58ce2701ebe |

| Viber | Id único en tu bot de Viber | mdY9hOWdeQC6J/Sl19Qh8A== |

| Vk | Id único en tu bot de Vk | 705862439 |

Nota: el id único del canal solo es único dentro de tu página de Facebook, bot de Telegram, espacio de trabajo de Slack o cuenta de WeChat, no es un id único en todo Facebook, Slack, etc.

Tipo de Variable

Hay 6 tipos de variables en OneChat:

| Tipo | Almacenamiento | Ejemplo | Operaciones Compatibles |

| --- | --- | --- | --- |

| Text | letras, palabras, oraciones... | Hi, OneChat. | recortar, cambiar mayúsculas/minúsculas, codificar, decodificar... |

| Number | números | 123.45 | + - x /, mod, potencia, log, raíz, redondeo... |

| Boolean | "1" o "0", para verdadero o falso | 1 | asignar |

| Date | fecha | 2021-03-30 | formato, agregar meses/semanas/días |

| DateTime | fecha y hora | 2022-01-01T12:00:00+10:00 | formato, agregar meses/semanas/días/horas/minutos |

| JSON (array) | una serie de variables | {"name":"Jack", "age":"20"} | cargar, obtener, actualizar, eliminar, contar, sumar, promedio, ordenar, mezclar, invertir... |

Valor Booleano

Cuando estos valores se almacenan en el campo, el booleano devuelve falso; de lo contrario, devuelve verdadero:

• empty
• null
• 'false'
• false
• 'no'
• 0

Crear un Campo Personalizado

¡Wow, ahora eres un maestro 👨🎓 de los campos! ¡Probémoslo! 😎😎

Puedes crear variables de 2 maneras:

| Lugar | Tipos Compatibles |

| --- | --- |

| en la sección Contents | user field y bot field |

| en cualquier lugar donde necesites mapear el resultado a una variable, por ejemplo, Question step, Integration, etc. | solo user field |

Crear un Campo Personalizado en la Sección Contents

1. ve a "Contents" desde la barra lateral izquierda

2. selecciona User Fields o Bot Fields

3. usa carpetas para organizar tus campos si es necesario

Haz clic en el botón azul "+ New User/Bot Field" en el lado derecho para crear un campo. "Field Name" es obligatorio. Puedes usar cualquier carácter para separar palabras, como guion bajo o espacio. Te sugerimos mantener el nombre del campo lo más conciso posible para evitar cualquier posible problema de visualización.

Después de eso, elige un tipo de variable. Agrega un valor predeterminado o una descripción si es necesario. (el valor predeterminado es solo para los campos del bot)

Las carpetas pueden usarse para organizar variables. Créeme, las necesitarás cuando tu flujo crezca. 🧐

Crear un Campo Personalizado en Question y Action Step

Para crear campos nuevos, por ejemplo, en el Question step:

Escribe un nuevo nombre de variable en el cuadro "Enter Field Name" y haz clic en él en la lista desplegable. Selecciona el tipo de variable correspondiente y listo.

Otro ejemplo, crear en una integración: