> For the complete documentation index, see [llms.txt](https://docs.bony.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bony.chat/contactos-y-mensajes/variables-dinamicas.md).

# Variables Dinámicas

Las variables dinámicas se pueden usar para personalizar los mensajes salientes. Dirigirse a los contactos personalmente en las Conversaciones puede ser un componente clave de la construcción de relaciones al hacerlos sentir vistos e incluidos.

El contenido personalizado contribuye a construir una buena relación con los contactos donde sienten su relevancia para usted.

Hay tres tipos de variables dinámicas en la plataforma:

Las **variables de contacto estándar** representan campos de contacto estándar, como el nombre, el apellido y el correo electrónico.

Las **variables de campo de contacto personalizadas** representan campos personalizados añadidos al espacio.

Las **variables de flujo de trabajo** son variables temporales que solo existen durante una sesión de flujo de trabajo. Una vez que el contacto salga del flujo de trabajo, se borrará el valor de la variable.&#x20;

Hay 3 tipos de Variables de flujo de trabajo: Variables de activación, Variables de salida y variables creadas a través del paso Hacer una pregunta.

## ¿Cuáles son las variables dinámicas? <a href="#what-are-the-dynamic-variables" id="what-are-the-dynamic-variables"></a>

Las variables dinámicas se pueden incluir añadiendo el prefijo " $ " al campo de contacto. La siguiente es su sintaxis. Los siguientes son el ejemplo y el uso:`$contact`, `$assignee` or `$system`

### Variables de contacto estándar <a href="#contact-variables" id="contact-variables"></a>

| Variable                              | Descripción                                                                                                                           |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| <p><code>$contact.name</code><br></p> | Se reemplaza por el nombre completo del contacto (Nombre + Apellido).                                                                 |
| `$contact.firstname`                  | Se reemplaza por el nombre del contacto.                                                                                              |
| `$contact.lastname`                   | Se reemplaza por el apellido del contacto.                                                                                            |
| `@contact.email`                      | Se reemplaza por el correo del contacto.                                                                                              |
| `@contact.country`                    | Se reemplaza por el país del contacto. Si el contacto no tiene ningún país almacenado, no se reemplazará y se enviará la cadena real. |
| `@contact.id`                         | Se reemplaza por el ID del contacto.                                                                                                  |

### Variables de campo personalizadas <a href="#custom-field-variables" id="custom-field-variables"></a>

| Variable            | Descripción                                                                                                                                                                                               |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@contact.phone`    | Se reemplaza por el número de teléfono del contacto`.`                                                                                                                                                    |
| `@field.field_name` | Se reemplaza por el valor del campo personalizado. Por ejemplo, si el campo personalizado "Ciudad" existe y un contacto tiene el valor "Nueva York", el envío `@contact.city`se reemplazará por New York. |

### Variables del sistema <a href="#variables-del-sistema" id="variables-del-sistema"></a>

| Variable                                              | Descripción                                                                                                                                                    |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><code>$system.current\_datetime</code><br><br></p> | <p>Se reemplaza por la fecha y hora actuales según la zona horaria del espacio de trabajo. <br>Formato: AAAA-MM-DD hh:mm:ss <br>(p,e. 2021-01-10 09:15:27)</p> |
| <p><code>$system.current\_date</code><br><br></p>     | <p>Se reemplaza por la fecha actual según la zona horaria del espacio de trabajo.<br>Formato: AAAA-MM-DD (p.e. 2021-01-10)</p>                                 |
| <p><code>$system.current\_time</code><br><br></p>     | <p>Se reemplaza hora actual según la zona horaria del espacio de trabajo.<br>Formato: hh:mm:ss (p.e. 09:15:27)</p>                                             |

### Variables de cesionario  <a href="#variables-de-cesionario" id="variables-de-cesionario"></a>

| Variable              | Descripción                                                                                          |
| --------------------- | ---------------------------------------------------------------------------------------------------- |
| `$assignee.id`        | Se reemplaza por el ID del usuario del cesionario de un contacto.                                    |
| `$assignee.name`      | Se reemplaza por el nombre completo del usuario del cesionario de un contacto. (Nombre + Apellidos). |
| `$assignee.email`     | Se reemplaza por el correo del usuario del cesionario de un contacto.                                |
| `$assignee.firstname` | Se reemplaza por el nombre del usuario del cesionario de un contacto.                                |
| `$assignee.lastname`  | Se reemplaza por el apellido del usuario del cesionario de un contacto.                              |
| `$assignee.team`      | Se reemplaza por el nombre del equipo del cesionario de un contacto.                                 |

### Flujos de trabajo: Variables de activación

Las variables de activación son variables que están vinculadas a un disparador de flujo de trabajo. Solo están disponibles cuando se utiliza el desencadenador específico para el flujo de trabajo.

#### Variables de activación para el disparador de conversación cerrada

| Variable                                                                     | Descripción                                                                                                                                                                       |
| ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><code>$conversation.opened\_time</code><br></p>                           | <p>Se reemplaza por el momento en que se abrió la conversación.<br>Formato: AAAA-MM-DD hh:mm:ss </p><p>(p.e. 2021-01-10 09:15:27)</p>                                             |
| `$conversation.opened_by_source`                                             | Se reemplaza por la fuente de cómo se abrió la conversación.                                                                                                                      |
| <p><code>$conversation.closed\_time</code><br></p>                           | <p>Se reemplaza por el momento en que se cerró la conversación.<br>Formato: AAAA-MM-DD hh:mm:ss </p><p>(p.e. 2021-01-10 09:15:27)</p>                                             |
| `$conversation.closed_by`                                                    | <p>Se sustituye por el ID del usuario que cierra la conversación. </p><p><em>\*Si el bot, el flujo de trabajo o la API cierran la conversación, este campo estará vacío.</em></p> |
| <p><code>$conversation.closed\_by\_source</code><br><br></p>                 | Se reemplaza por la fuente de cómo se cerró la conversación.                                                                                                                      |
| <p><code>$conversation.resolution\_time</code> <br><br><br></p>              | <p>Se sustituye por el tiempo de primera respuesta proporcionado por el cesionario al contacto.</p><p>Formato: hh: mm:ss (p.e, 08:18: 58)</p>                                     |
| <p><code>$conversation.incoming\_messages\_</code><br><code>count</code></p> | Es reemplazado por el número de mensajes entrantes que se recibieron de la conversación.                                                                                          |
| <p><code>$conversation.outgoing\_messages\_count</code><br><br></p>          | Se sustituye por el número de mensajes salientes que se enviaron a la conversación.                                                                                               |
| <p><code>$conversation.category</code><br><br></p>                           | Se sustituye por la categoría de la nota de cierre de la conversación.                                                                                                            |
| <p><code>$conversation.summary</code><br><br></p>                            | Se sustituye por el resumen de la nota de cierre de la conversación.                                                                                                              |
| <p><code>$conversation.assignee</code><br><br></p>                           | Se reemplaza por el ID de usuario del asignado para esa conversación.                                                                                                             |
| <p><code>$conversation.assignee\_team</code><br><br></p>                     | Se sustituye por el nombre del equipo del cesionario.                                                                                                                             |

{% hint style="warning" %}
En el caso de que un campo de contacto estándar comparta el mismo nombre que un campo de contacto personalizado, se dará prioridad para la recuperación de datos a la variable de contacto estándar. Para la recuperación de datos correcta, asegúrese de que todos los nombres de variables sean únicos.
{% endhint %}

## ¿Cómo utilizar una variable dinámica? <a href="#how-to-use-a-dynamic-variable" id="how-to-use-a-dynamic-variable"></a>

Puede incluir una variable dinámica en su mensaje mientras responde a un contacto.

**1.Escribiendo el signo de dólar "$"**

![](https://4203548637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lkf9GnQKi9ZHOOeQZec%2Fuploads%2FL9n6Osup2SCoSmuQn6oe%2Fv1.gif?alt=media\&token=77010bb6-0580-42e8-af07-9194545cb045)

**2. Haciendo clic en el icono de la variable en la parte inferior del módulo de mensajes**<br>

![](/files/pptIX01JorioYYhGP6Hi)

Además de los campos de contacto, también puede incluir un campo personalizado escribiendo el nombre de este.

### Atajos <a href="#snippets" id="snippets"></a>

![](/files/UNGLxzPdzyqtXKFyf7O1)

Mientras redacta un fragmento de contenido, puede incluir una variable dinámica para personalizar sus respuestas rápidas.

{% hint style="info" %}
**Sugerencias:** Puede tener múltiples variables dinámicas en un solo contenido. Úselos al redactar sus mensajes
{% endhint %}

{% hint style="warning" %}
**Importante**: Si el campo que está intentando enviar está vacío o el campo no existe, la cadena no se reemplazará.
{% endhint %}

### Flujos de trabajo <a href="#workflows" id="workflows"></a>

Es posible guardar las respuestas del Contacto como variables en el paso de Hacer una Pregunta.

![](https://1810233666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L8qsmIDw5_reabURkaE%2Fuploads%2F1s8UcM5ebEIqIIHOpIqk%2Fsave%20variable.gif?alt=media\&token=298e001b-84a5-402f-82ea-c540d8033227)

Luego, utilice las variables dinámicas guardadas en los pasos del Flujo de Trabajo.

![](https://4203548637-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lkf9GnQKi9ZHOOeQZec%2Fuploads%2FVqxXJXSMVbd0TaL8qZmV%2Fuse%20variable2.gif?alt=media\&token=535845cf-7739-4864-bcee-cd6d400bc490)

**Pasos del flujo de trabajo que soportan la variable dinámica**

| Pasos                                      | Formato                        |
| ------------------------------------------ | ------------------------------ |
| Enviar mensaje                             | Texto                          |
| Enviar mensaje                             | Plantillas de WhatsApp         |
| Enviar mensaje                             | Mensaje etiquetado de Facebook |
| Hacer una pregunta                         | Campo de texto de pregunta     |
| Rama                                       | Condición decampo de contacto  |
| Actualizar campo de contacto               | Condición variable             |
| Agregar comentario                         | **-**                          |
| Conversación privada                       | -                              |
| Solicitud HTTP                             | Resumen                        |
| Agregar fila de Hojas de cálculo de Google | -                              |

### Dialogflow <a href="#dialogflow" id="dialogflow"></a>

También puede incluir variables dinámicas en Dialogflow para las [respuestas](broken://pages/-MEqH9ojo5lNB4DjtdGp) y [los valores de los parámetros](broken://pages/-MEqJv85gEzSK454mZac). Para utilizar una variable dinámica en Dialogflow, escriba $dynamic.variable.

![](https://1810233666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L8qsmIDw5_reabURkaE%2Fuploads%2FstmKnWVFaLcuAHLz9ruL%2FScreen%20Shot%202021-12-22%20at%205.28.29%20PM.png?alt=media\&token=30c6a67b-1c5b-4381-8b0c-686f5f573472)

Ejemplo de uso de variables dinámicas en el valor del parámetro

![](https://1810233666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L8qsmIDw5_reabURkaE%2Fuploads%2FOCKIVhHGbawmHIqNdYK0%2FScreen%20Shot%202021-12-22%20at%205.28.59%20PM.png?alt=media\&token=f6569762-7169-4379-97c2-dfbd6b6bebb6)
