1. All Collections >
  2. Producto >
  3. Variables dinámicas >
  4. Descripción general de las variables dinámicas

Descripción general de las variables dinámicas

Avatar
Susan Swier
5 min de lectura

Las variables dinámicas se pueden utilizar para personalizar los mensajes salientes. Dirigirse personalmente a los Contactos en las Conversaciones puede ser clave para construir relaciones, ya que los hace sentirse vistos e incluidos.

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

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

  2. Variables de campos personalizados de Contacto representan campos personalizados añadidos al espacio de trabajo.

  3. Variables de flujo de trabajo son variables temporales que existen solo durante una sesión de flujo de trabajo. Una vez que el Contacto salga del flujo de trabajo, el valor de la variable será borrado.

Hay tres tipos de variables de flujo de trabajo: variables de disparador, variables de salida y variables creadas mediante el paso 'Hacer una pregunta'.

Ejemplos de variables dinámicas

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

$contact, $assignee o $system

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

Variables de contacto estándar

Variable

Descripción

$contact.name

Se sustituye por el nombre completo del contacto (Nombre + Apellido).

$contact.firstname

Se sustituye por el nombre del contacto.

$contact.lastname

Se sustituye por el apellido del contacto.

$contact.email

Se sustituye por el correo electrónico del Contacto.

$contact.country

Se reemplaza por el país del contacto. Si el contacto no tiene ningún país almacenado, no será reemplazado y se enviará la cadena real.

$contact.id

Se sustituye por el ID de contacto del Contacto.

Variables de campos de contacto personalizados

Variable

Descripción

$contact.field_name

Se sustituye por el valor en el campo personalizado. Por ejemplo, si el campo personalizado 'Ciudad' existe y un contacto tiene el valor 'Nueva York', enviando $contact.city se sustituirá por 'Nueva York'.

Variables del sistema

Variable

Descripción

$system.current_datetime

Se reemplaza por la fecha y hora actuales en la zona horaria del espacio de trabajo.

Formato: YYYY-MM-DD hh:mm:ss (p. ej. 2023-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 (p. ej. 2023-01-10)

$system.current_time

Se reemplaza por la hora actual en la zona horaria del Espacio de trabajo.

Formato: hh:mm:ss (p. ej. 09:15:27)

Variables del asignado

Variable

Descripción

$assignee.id

Se sustituye por el ID de usuario del asignado de un Contacto.

$assignee.name

Se sustituye por el nombre completo de la persona asignada a un contacto (Nombre + Apellido).

$assignee.email

Se sustituye por el correo electrónico del asignado de un Contacto.

$assignee.firstname

Se sustituye por el nombre de la persona asignada para un contacto.

$assignee.lastname

Se sustituye por el apellido del asignado para un contacto.

$assignee.team

Se sustituye por el nombre del equipo del asignado.

Variables de disparador del flujo de trabajo

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

Variables del disparador para 'conversación abierta'

Variable

Descripción

$conversation.opened_timestamp

Fecha y hora en que se abrió la conversación.

Formato: YYYY-MM-DD hh:mm:ss (p. ej. 2023-11-10 09:15:27)

$conversation.opened_by_source

La fuente (por ejemplo, Contacto, Usuario, Flujo de trabajo, Zapier, API, Make) que activa la conversación.

$conversation.opened_by_channel

El ID del canal que activa la apertura de la conversación.

$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 que se abra la conversación.

$conversation.first_incoming_message_channel_id

El ID del canal del primer mensaje entrante de la conversación después de que se abra la conversación

Variables del disparador para 'conversación cerrada'

Variable

Descripción

$conversation.opened_timestamp

Fecha y hora en que se abrió la conversación.

Formato: YYYY-MM-DD hh:mm:ss (p. ej. 2023-11-10 09:15:27)

$conversation.opened_by_source

La fuente (por ejemplo, Contacto, Usuario, Flujo de trabajo, Zapier, API, Make) que activa la apertura de la conversación.

$conversation.opened_by_channel

El ID del canal que activa la apertura de la conversación.

$conversation.closed_time

La fecha y hora en que se cerró la conversación.

Formato: YYYY-MM-DD hh:mm:ss (p. ej. 2023-11-10 09:15:27)

$conversation.closed_by_source

La fuente (por ejemplo, Contacto, Usuario, Flujo de trabajo, Zapier, API, Make) que activa el cierre de la conversación.

$conversation.closed_by

El identificador del usuario que cerró la conversación. Si la conversación se cierra por bot, flujo de trabajo o API, este campo estará vacío.

$conversation.closed_by_team

El ID del 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

Fecha y hora de la primera asignación de la conversación.

Formato: YYYY-MM-DD hh:mm:ss (p. ej. 2023-11-10 09:15:27)

$conversation.first_assignee

El ID de usuario del primer asignado.

$conversation.first_response_time

El tiempo que tarda en dar la primera respuesta desde el momento en que se abrió la conversación.

No se muestra ningún valor si ocurre alguna de las siguientes situaciones:
- la conversación se cierra sin ninguna respuesta.
- si la primera respuesta la proporciona la API, o si el Contacto fue asignado al usuario previamente y luego el agente abre la conversación.

Formato: YYYY-MM-DD hh:mm:ss (p. ej. 2023-11-10 09:15:27)

$conversation.first_response_by

El ID del usuario que dio la primera respuesta.

$conversation.last_assignment_timestamp

Fecha y hora de la última asignación de la conversación.

No se muestra ningún valor si ocurre alguna de las siguientes situaciones:
- la conversación se cierra sin un asignado.
- no ocurre ninguna asignación en la conversación, por ejemplo, la conversación fue asignada al usuario antes de que se abra la conversación.

Formato: YYYY-MM-DD hh:mm:ss (p. ej. 2023-11-10 09:15:27)

$conversation.last_assignee

El ID de usuario del último asignado.

$conversation.time_to_first_assignment

El tiempo que tarda en asignar la conversación al primer usuario.

Formato: hh:mm:ss (p. ej. 00:19:08)

$conversation.first_assignment_to_first_response_time

El tiempo que tarda en dar la primera respuesta desde el momento en que se asignó la conversación por primera vez.

Formato: hh:mm:ss (p. ej. 00:19:08)

$conversation.last_assignment_to_response_time

El tiempo que tarda en dar la primera respuesta por el último asignado desde el momento en que se asignó la conversación por última vez.

Formato: hh:mm:ss (p. ej. 00:19:08)

$conversation.resolution_time

El tiempo que lleva resolver la conversación desde el momento en que se abrió la conversación.

Formato: hh:mm:ss (p. ej. 00:19:08)

$conversation.first_assignment_to_close_time

El tiempo que lleva resolver la conversación desde el momento en que se asignó por primera vez.

Formato: hh:mm:ss (p. ej. 00:19:08)

$conversation.last_assignment_to_close_time

El tiempo que lleva resolver la conversación desde el momento en que se asignó por última vez.

Formato: hh:mm:ss (p. ej. 00:19:08)

$conversation.average_response_time

El tiempo promedio para responder al Contacto.

Formato: hh:mm:ss (p. ej. 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 (excluidos los mensajes de difusión).

$conversation.responses_count

El número de respuestas enviadas en la conversación.

$conversation.category

La categoría de la conversación como se especifica en la nota de cierre.

$conversation.summary

El resumen de la nota de cierre de la conversación.

Variables del disparador para Anuncios de mensajes

Nombre de la variable

Descripción

$clicktochat.ad_timestamp

La marca de tiempo en que se recibió el mensaje entrante.

$clicktochat.ad_first_incoming_message

El primer mensaje en la conversación que resulta de un Anuncio de mensajes.

$clicktochat.ad_channel_id

El ID del canal a través del cual el mensaje de anuncio entrante fue recibido.

$clicktochat.ad_channel_type

El canal a través del cual se está llevando a cabo la conversación relacionada con los anuncios.

$clicktochat.ad_contact_type

El tipo de Contacto asociado con el anuncio: nuevo o existente

$clicktochat.ad_id

El número de identificación del anuncio del CTC.

$clicktochat.ad_name

El nombre del anuncio del CTC.

$clicktochat.ad_campaign_id

Número de ID de la campaña del CTC.

$clicktochat.ad_campaign_name

El nombre de la campaña CTC.

$clicktochat.ad_adset_id

El número de identificación de adset del anuncio del CTC.

$clicktochat.ad_adset_name

El nombre del adset del anuncio CTC.

$clicktochat.ad_ad_url

La URL del anuncio del CTC.

$clicktochat.ad_reference

La referencia asociada con el anuncio del CTC.

$clicktochat.ad_status

El estado del anuncio del CTC.

$clicktochat.ad_objective

El objetivo del anuncio del CTC.

$clicktochat.ad_optimization_goal

El objetivo de optimización del anuncio del CTC.

$clicktochat.ad_destination_type

El tipo de destino asociado con el anuncio del CTC.

Variables del disparador para anuncios de mensajería de TikTok

Variable

Descripción

$tiktokmessagingad.ad_timestamp

Hora en que se hizo clic en el anuncio

$tiktokmessagingad.ad_first_incoming_message

Primer mensaje enviado por el contacto

$tiktokmessagingad.ad_channel_id

ID del canal de mensajería

$tiktokmessagingad.ad_channel_type

Tipo de canal (por ejemplo, TikTok)

$tiktokmessagingad.ad_contact_type

Tipo de contacto (por ejemplo, nuevo o existente)

$tiktokmessagingad.ad_id

ID de anuncio

$tiktokmessagingad.ad_name

Nombre del anuncio

$tiktokmessagingad.ad_campaign_id

ID de campaña

$tiktokmessagingad.ad_campaign_name

Nombre de la campaña

$tiktokmessagingad.ad_adgroup_id

ID de grupo de anuncios

$tiktokmessagingad.ad_adgroup_name

Nombre del grupo de anuncios

$tiktokmessagingad.ad_advertiser_id

ID de anunciante

$tiktokmessagingad.ad_operation_status

Estado operativo del anuncio

$tiktokmessagingad.ad_secondary_status

Estado secundario del anuncio

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 recuperar los datos correctamente, asegúrate de que todos los nombres de variables sean únicos.

Compartir este artículo
Telegram
Facebook
Linkedin
Twitter

¿No encuentras lo que estás buscando? 🔎