Variables Dinámicas

Personalice su mensaje con variables dinámicas

Las variables dinámicas se pueden utilizar 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 hacer que se sientan vistos e incluidos.

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

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

Las variables de campo de contacto personalizado representan campos personalizados agregados al espacio.

Las variables de flujo de trabajo son variables temporales que existen solo durante una sesión de flujo de trabajo. Una vez que el contacto sale del flujo de trabajo, el valor de la variable se borrará. 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.

Variables dinámicas: Ejemplos

Las variables dinámicas se pueden incluir agregando el prefijo "$" al campo de contacto. La siguiente es su sintaxis:

$contact, $assignee or $system

La plataforma admite la interpolación de texto estático + variables dinámicas.

Variables de contacto estándar

Variable	Descripción
$contact.name	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 electrónico del contacto.
$contact.country	Se reemplaza por el país del contacto. Si el contacto no tiene un país almacenado, no se reemplazará y se enviará la cadena real.
$contact.id	Se reemplaza por el ID de contacto del contacto.

Variables de campo de contacto personalizadas

Variable	Descripción
$contact.field_name	Se reemplaza por el valor en el campo personalizado. Por ejemplo, si existe el campo personalizado "Ciudad" y un contacto tiene el valor "Nueva York", el envío de $contacto.ciudad será reemplazado por Nueva York.

Variables del sistema

Variable	Descripción
$system.current_datetime	Se reemplaza por la fecha y hora actual en la zona horaria del espacio de trabajo. Formato: AAAA-MM-DD hh:mm:ss (por ejemplo, 2021-01-10 09:15:27)
$system.current_date	Se reemplaza por la fecha actual en la zona horaria del espacio de trabajo. Formato: AAAA-MM-DD (por ejemplo, 2021-01-10)
$system.current_time	Se reemplaza por la hora actual en la zona horaria del espacio de trabajo. Formato: hh:mm:ss (por ejemplo, 09:15:27)

Variables del Agente

Variable	Descripción
$assignee.id	Se reemplaza por el ID de usuario del agente para un contacto.
$assignee.name	Se reemplaza por el nombre completo del agente de un Contacto (Nombre + Apellido).
$assignee.email	Se reemplaza por el correo electrónico del agente de un Contacto.
$assignee.firstname	Se reemplaza por el nombre del agente de un Contacto.
$assignee.lastname	Se reemplaza por el apellido del agente de un Contacto.
$assignee.team	Se reemplaza por el nombre del equipo del agente

Flujos: Variables de activador

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

Variables de activación para el activador de conversación abierta

Variable	Descripción
$conversation.opened_timestamp	La fecha y la hora en que se abrió la conversación. Formato: AAAA-MM-DD hh:mm:ss (por ejemplo, 2023-11-10 09:15:27)
$conversation.opened_by_source	La fuente (por ejemplo, contacto, usuario, flujo de trabajo, Zapier, API, marca) que desencadena la conversación.
$conversation.opened_by_channel	El ID del canal que activa la conversación abierta.
$conversation.contact_type	El tipo de contacto (Nuevo contacto o Contacto recurrente) de la conversación.
$conversation.first_incoming_message	El primer mensaje entrante de la conversación después de abrir la conversación.
$conversation.first_incoming_message_channel_id	El Id. de canal del primer mensaje entrante de la conversación después de abrir la conversación.

Variables de activación para activación de conversación cerrada

Variable	Descripción
$conversation.opened_timestamp	La fecha y hora en que se abrió la conversación. Formato: AAAA-MM-DD hh:mm:ss (por ejemplo, 2023-11-10 09:15:27)
$conversation.opened_by_source	La fuente (por ejemplo, contacto, usuario, flujo de trabajo, Zapier, API, marca) que activa la conversación abierta.
$conversation.opened_by_channel	El ID del canal que activa la conversación abierta.
$conversation.closed_timestamp	La fecha y hora en que se cerró la conversación. Formato: AAAA-MM-DD hh:mm:ss (por ejemplo, 2023-11-10 09:15:27)
$conversation.closed_by_source	La fuente (por ejemplo, contacto, usuario, flujo de trabajo, Zapier, API, marca) que activa el cierre de la conversación.
$conversation.closed_by	El ID de usuario del usuario que cerró la conversación. Si la conversación la cierra un bot, un flujo de trabajo o una API, este campo estará vacío.
$conversation.closed_by_team	El ID de equipo del usuario que cerró la conversación.
$conversation.contact_type	El tipo de contacto (Nuevo contacto o Contacto recurrente) de la conversación.
$conversation.assignee_team	El nombre del equipo del usuario que asignó la conversación.
$conversation.first_assignment_timestamp	La fecha y la hora en que se asignó la conversación por primera vez. Formato: AAAA-MM-DD hh:mm:ss (por ejemplo, 2023-11-10 09:15:27)
$conversation.first_assignee	El ID de usuario del primer cesionario.
$conversation.first_response_timestamp	La fecha y hora en que se dio la primera respuesta. Formato: AAAA-MM-DD hh:mm:ss (por ejemplo, 2023-11-10 09:15:27)
$conversation.first_response_by	El ID de usuario del usuario que dio la primera respuesta.
$conversation.last_assignment_timestamp	La fecha y la hora en que se asignó la conversación por última vez. Formato: AAAA-MM-DD hh:mm:ss (por ejemplo, 2023-11-10 09:15:27)
$conversation.last_assignee	El ID de usuario del último asignado.
$conversation.time_to_first_assignment	El tiempo que se tarda en asignar primero la conversación al primer usuario. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.first_response_time	El tiempo que se tarda en dar la primera respuesta desde que se abre la conversación. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.first_assignment_to_first_response_time	El tiempo que se tarda en dar la primera respuesta desde el momento en que se asignó la conversación por primera vez. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.last_assignment_to_response_time	El tiempo que tarda el último asignado en dar la primera respuesta desde el momento en que se asignó la conversación por última vez. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.resolution_time	El tiempo necesario para resolver la conversación desde el momento en que se abrió la conversación. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.first_assignment_to_close_time	El tiempo necesario para resolver la conversación desde el momento en que se asignó por primera vez. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.last_assignment_to_close_time	El tiempo necesario para resolver la conversación desde el momento en que se asignó la conversación por última vez. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.average_response_time	El tiempo medio que se tarda en dar respuestas al contacto. Formato: hh:mm:ss (por ejemplo, 00:19:08)
$conversation.assignments_count	El número de asignaciones en la conversación.
$conversation.incoming_messages_count	El número de mensajes entrantes recibidos durante la conversación.
$conversation.outgoing_messages_count	El número de mensajes salientes enviados durante la conversación (excluyendo los mensajes de difusión).
$conversation.responses_count	The number of responses sent in the conversation.
$conversation.category	La categoría de conversación como se especifica en la nota de cierre.
$conversation.summary	El resumen de la nota de cierre de la conversación.

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 una correcta recuperación de datos, asegúrese de que todos los nombres de las variables sean únicos.

¿Cómo usar una variable dinámica?

Consola de mensajería

Puede incluir una variable dinámica en su mensaje mientras responde a un contacto. Hay 2 formas de usar variables dinámicas:

1. Al escribir el signo de dólar "$"

2. Al hacer clic en el icono de variable en la parte inferior del módulo de mensajes

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

Desde los atajos (Snippets)

Al redactar un atajo, puede incluir una variable dinámica para personalizar sus respuestas rápidas.

Sugerencia: puede tener múltiples variables dinámicas en un solo contenido. Las puede incluir mientras redacta los mensajes.

Importante: si el campo que intenta enviar está vacío o no existe, la cadena no se reemplazará.

Desde los flujos (Workflows)

Además de las variables de activación vinculadas a un activador específico, también hay otras variables que se pueden crear y utilizar en los flujos de trabajo.

1. Guarde las respuestas del contacto como variables en el paso Hacer una pregunta.

2. También es posible crear variables de salida agregando un campo de formulario en el formulario de shortcut. Los valores de las variables son definidos y proporcionados por el usuario que inició el shortcut y completó el formulario del shortcut.

luego, use las variables dinámicas guardadas en los pasos del flujo de trabajo.

Pasos de flujo de trabajo que admiten variables dinámicas

Send Message	Text
Send Message	WhatsApp Template
Send Message	Facebook Tagged Message
Ask a Question	Question Text Field
Branch	Contact Field Condition
Branch	Variable Condition
Update Contact Field	-
Add Comment	-
Close Conversation	Summary
HTTP Request	-
Add Google Sheets Row	-

Al verificar los resultados de la solicitud HTTP con variables dinámicas, tenga en cuenta que las variables sin un valor darán como resultado un valor null or undefined.