Visão geral das variáveis dinâmicas

Variáveis dinâmicas podem ser usadas para personalizar mensagens de saída. Tratar Contatos pessoalmente em Conversas pode ser um componente chave para construir relacionamentos, fazendo com que se sintam vistos e incluídos.

Há três tipos de variáveis dinâmicas na plataforma:

Variáveis de Contato Padrão representam campos de contato padrão como primeiro nome, sobrenome e e-mail.
Variáveis de campo de contato personalizado representam campos personalizados adicionados ao espaço.
Variáveis de fluxo de trabalho são variáveis temporárias que existem apenas durante uma sessão do fluxo de trabalho. Assim que o Contato sair do Fluxo de Trabalho, o valor da variável será apagado.

Existem três tipos de Variáveis de Fluxo de Trabalho: Variáveis de Gatilho, Variáveis de Saída e variáveis criadas por meio da etapa Fazer uma Pergunta.

Variáveis Dinâmicas: Exemplos

Variáveis dinâmicas podem ser incluídas adicionando o prefixo "$" para o campo de contato. A seguinte é a sua sintaxe:

$contact, $assignee ou $system

A plataforma suporta a interpolação do texto estático + variáveis dinâmicas.

Variáveis de contato padrão

Variável	Descrição
Nome $contact	É substituído pelo nome completo do contato (Primeiro Nome + Sobrenome).
$contact.Primeiro nome	É substituído pelo primeiro nome do contato.
$contact.lastname	É substituído pelo último nome do contato.
Endereço $contact	É substituído pelo e-mail do contato.
$contact.país	É substituído pelo país do Contato. Se o Contato não tiver nenhum país armazenado, ele não será substituído e a seqüência de caracteres real será enviada.
$contact.id	É substituído pelo ID de contato do contato.

Variáveis de campo de contato personalizado

Variável	Descrição
$contact.nome_campo	É substituído pelo valor no campo personalizado. Por exemplo, se o Campo Personalizado "Cidade" existir e um contato tiver o valor "Nova York", ao enviar $contact.city será substituído por Nova York.

Variáveis do sistema

Variável	Descrição
$system.current_datetime	É substituído pela data e hora atuais no fuso horário da Área de Trabalho. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-01-10 09:15:27)
$system.current_date	É substituído pela data atual no fuso horário da área de trabalho. U Formato: AAAA-MM-DD (ex. 2023-01-10)
$system.current_time	É substituído pela hora atual no fuso horário da área de trabalho. U Format: hh:mm:ss (e.g. 09:15:27)

Por exemplo, se o campo da variável "Atribuído" existe, ao enviar $assignee.name, será substituído pelo nome da pessoa designada.

Variável	Descrição
$assignee.id	É substituído pelo ID do usuário do atribuído por um contato.
Nome $assignee	É substituído pelo nome completo do atribuído para um contato (Primeiro Nome + Sobrenome).
Endereço $assignee	É substituído pelo e-mail do atribuído por um contato.
$assignee.Primeiro nome	É substituído pelo primeiro nome do atribuído por um contato.
$assignee.lastname	É substituído pelo último nome do atribuído por um contato.
Equipe.$assignee	É substituído pelo nome da equipe do responsável.

Fluxo de trabalho - Gatilho Variáveis

As variáveis do gatilho são variáveis que estão ligadas a um gatilho do fluxo de trabalho. Eles só estão disponíveis quando o gatilho específico é usado para o fluxo de trabalho.

Gatilho Variáveis para a Conversa aberta

Variável	Descrição
$conversation.opened_timestamp	A data e hora em que a conversa foi aberta. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.aberto_por_fonte	A fonte (exemplo: Contato, Usuário, Fluxo de Trabalho, Zapier, API, Make) que aciona a conversa.
$conversation.aberto_por_canal	O ID do canal que aciona a conversa aberta.
Tipo $conversation.contact_type	O tipo de contato (Novo Contato ou Contato Retorno) da conversa.
$conversation.first_incoming_message	A primeira mensagem recebida da conversa após a abertura.
$conversation.first_incoming_message_channel_id	O ID do canal da primeira mensagem recebida da conversa após a abertura.

Variáveis de Gatilho para o Gatilho de Conversa Fechada.

Variável	Descrição
$conversation.opened_timestamp	A data e hora em que a conversa foi aberta. A data e hora em que a conversa foi aberta.
$conversation.opened_by_source	Fonte (por exemplo, Contato, Usuário, Fluxo de Trabalho, Zapier, API, Make) que aciona a conversa aberta.
$conversation.opened_by_channel	O ID do canal que aciona a conversa aberta.
$conversation.closed_time	A data e hora em que a conversa foi fechada. Formato: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.closed_by_source	Fonte (por exemplo, Contato, Usuário, Fluxo de Trabalho, Zapier, API, Make) que aciona a conversa fechada.
$conversation.closed_by	A ID do usuário que fechou a conversa. Se a conversa é fechada por bot, workflow ou API, este campo ficará vazio.
$conversation.closed_by_team	O ID da equipe do usuário que fechou a conversa.
$conversation.contact_type	O tipo de contato (Novo Contato ou Contato Retorno) da conversa.
$conversation.responsável_equipe	$conversation.assignee_team
$conversation.first_assignment_timestamp	A data e hora de quando a conversa foi atribuída pela primeira vez. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.first_assignee	A ID do primeiro usuário atribuído.
$conversation.first_response_time	O tempo que levou para dar a primeira resposta desde o momento em que a conversa foi aberta. Nenhum valor é exibido se qualquer uma das seguintes ocorrências: - a conversa é fechada sem nenhuma resposta. - se a primeira resposta for fornecida pela API ou o contato tiver sido atribuído ao usuário antes, e então a conversa for aberta pelo agente. Formato: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.first_response_by	O ID de usuário do usuário que deu a primeira resposta.
$conversation.last_assignment_timestamp	A data e horário de quando a conversa foi atribuída pela última vez. Nenhum valor é exibido se qualquer uma das seguintes situações ocorrer: - a conversa é encerrada sem um responsável. - Nenhuma atribuição acontece na conversa, ou seja, a conversa foi atribuída ao usuário antes de ser aberta. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.last_assignee	O ID do usuário do último responsável.
$conversation.time_to_first_assignment	O tempo gasto para atribuir a conversa ao primeiro usuário. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.first_assignment_to_first_response_time	O tempo necessário para dar a primeira resposta a partir do momento em que a conversa foi atribuída pela primeira vez. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.last_assignment_to_response_time	O tempo gasto para dar a primeira resposta do último responsável desde a última atribuição da conversa. Format: hh:mm:ss (e.g. 00:19:08)
O tempo médio de resolução da conversa desde a última atribuição.	O tempo que levou para resolver a conversa a partir do momento em que a conversa foi aberta. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.first_assignment_to_close_time	O tempo necessário para resolver a conversa a partir do momento em que a conversa foi atribuída pela primeira vez. U Format: hh:mm:ss (e.g. 00:19:08)
$conversation.last_assignment_to_close_time	O tempo necessário para resolver a conversa a partir do momento em que a conversa foi atribuída pela última vez. U Format: hh:mm:ss (e.g. 00:19:08)
Tempo médio de resposta de $conversation.	Tempo médio para responder aos contatos. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.assignments_count	O número de trabalhos na conversa.
$conversation.incoming_messages_count	O número de mensagens recebidas durante a conversa.
$conversation.outgoing_messages_count	O número de mensagens enviadas durante a conversa (excluindo mensagens de transmissão).
$conversation.responses_count	O número de respostas enviadas na conversa.
$conversation.category	A categoria de conversa conforme especificado na nota de fechamento.
Resumo de $conversation.	O resumo da nota de fechamento da conversa.

Variáveis de Gatilho para Anúncios Click-to-Chat.

Nome da Variável	Descrição
$clicktochat.ad_timestamp	O timestamp quando a mensagem foi recebida.
$clicktochat.ad_primeira_mensagem_de_entrada	A primeira mensagem na conversa resultante do Click-to-Chat.
$clicktochat.ad_channel_id	O ID do canal pelo qual a mensagem do anúncio recebida foi recebida.
Tipo de canal $clicktochat.	O canal através do qual está ocorrendo a conversa relacionada ao anúncio.
Tipo de contato $clicktochat.	Tipo de contato associado com o anúncio: novo ou retornando.
$clicktochat.ad_id	O número do ID do anúncio CTC.
$clicktochat.ad_name	O nome do anúncio CTC.
$clicktochat.ad_campaign_id	O número de ID da campanha publicitária CTC.
$clicktochat.ad_campaign_name	O nome da campanha CTC.
$clicktochat.ad_adset_id	O número do ID do adset do anúncio CTC.
$clicktochat.ad_adset_name	Nome do conjunto de anúncios CTC.
$clicktochat.ad_ad_url	A URL do anúncio CTC.
$clicktochat.ad_reference	A referência associada ao anúncio CTC.
$clicktochat.ad_status	O estado do anúncio do CTC.
$clicktochat.ad_objective	O objetivo do anúncio CTC.
Meta de otimização $clicktochat.	O objetivo de otimização do anúncio CTC.
Tipo de destino $clicktochat.	O tipo de destino associado com o anúncio CTC.

No caso de um campo de contato padrão compartilhar o mesmo nome de um campo de contato personalizado, a prioridade para a recuperação de dados será dada à variável de contato padrão. Para uma recuperação de dados correta, certifique-se de que todos os nomes de variáveis são únicos.