Variáveis dinâmicas podem ser usadas para personalizar mensagens de saída. Dirigir-se aos 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 campos personalizados do contato 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'.
Exemplos de variáveis dinâmicas
Variáveis dinâmicas podem ser incluídas adicionando o prefixo "$" ao campo de contato. A sintaxe é a seguinte:
$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 |
|---|---|
$contact.name | É substituído pelo nome completo do contato (primeiro nome + sobrenome). |
$contact.firstname | É substituído pelo primeiro nome do contato. |
$contact.lastname | É substituído pelo último nome do contato. |
$contact.email | É substituído pelo e-mail do contato. |
$contact.country | É substituído pelo país do Contato. Se o Contato não tiver país armazenado, ele não será substituído e a sequência de caracteres real será enviada. |
$contact.id | É substituído pelo ID do contato. |
Variáveis de campos personalizados do contato
Variável | Descrição |
|---|---|
$contact.field_name | É 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. |
$system.current_date | É substituído pela data atual no fuso horário da Área de Trabalho. |
$system.current_time | É substituído pela hora atual no fuso horário da Área de Trabalho. |
Variáveis do responsável
Variável | Descrição |
|---|---|
$assignee.id | É substituído pelo ID do usuário do responsável pelo contato. |
$assignee.name | É substituído pelo nome completo do responsável pelo contato (Primeiro Nome + Sobrenome). |
$assignee.email | É substituído pelo e-mail do responsável pelo contato. |
$assignee.firstname | É substituído pelo primeiro nome do responsável pelo contato. |
$assignee.lastname | É substituído pelo último nome do responsável pelo contato. |
$assignee.team | É substituído pelo nome da equipe do responsável. |
Variáveis de gatilho do fluxo de trabalho
As variáveis do gatilho são variáveis que estão ligadas a um gatilho do fluxo de trabalho. Elas só estão disponíveis quando o gatilho específico é usado para o fluxo de trabalho.
Variáveis de gatilho para o evento 'Conversa aberta'
Variável | Descrição |
|---|---|
$conversation.opened_timestamp | A data e hora em que a conversa foi aberta. |
$conversation.opened_by_source | A fonte (por exemplo: Contato, Usuário, Fluxo de Trabalho, Zapier, API, Make) que aciona a conversa. |
$conversation.opened_by_channel | O ID do canal que aciona a abertura da conversa. |
$conversation.contact_type | O tipo de contato (Novo ou Retornando) 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 evento 'Conversa fechada'
Variável | Descrição |
|---|---|
$conversation.opened_timestamp | 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 abertura da conversa. |
$conversation.opened_by_channel | O ID do canal que aciona a abertura da conversa. |
$conversation.closed_time | A data e hora em que a conversa foi fechada. |
$conversation.closed_by_source | Fonte (por exemplo: Contato, Usuário, Fluxo de Trabalho, Zapier, API, Make) que aciona o fechamento da conversa. |
$conversation.closed_by | O ID do usuário que fechou a conversa. Se a conversa for fechada por bot, fluxo de trabalho 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 ou Retornando) da conversa. |
$conversation.assignee_team | O nome da equipe do usuário que atribuiu a conversa. |
$conversation.first_assignment_timestamp | A data e hora de quando a conversa foi atribuída pela primeira vez. |
$conversation.first_assignee | O ID do primeiro responsável. |
$conversation.first_response_time | O tempo gasto para dar a primeira resposta desde o momento em que a conversa foi aberta. |
$conversation.first_response_by | O ID do usuário que deu a primeira resposta. |
$conversation.last_assignment_timestamp | A data e hora de quando a conversa foi atribuída pela última vez. |
$conversation.last_assignee | O ID do último responsável. |
$conversation.time_to_first_assignment | O tempo gasto para atribuir a conversa ao primeiro usuário. |
$conversation.first_assignment_to_first_response_time | O tempo gasto para dar a primeira resposta desde o momento em que a conversa foi atribuída pela primeira vez. |
$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. |
$conversation.resolution_time | O tempo gasto para resolver a conversa desde o momento em que a conversa foi aberta. |
$conversation.first_assignment_to_close_time | O tempo gasto para resolver a conversa desde o momento em que foi atribuída pela primeira vez. |
$conversation.last_assignment_to_close_time | O tempo gasto para resolver a conversa desde o momento em que foi atribuída pela última vez. |
$conversation.average_response_time | O tempo médio para responder ao contato. |
$conversation.assignments_count | O número de atribuições na conversa. |
$conversation.incoming_messages_count | O número de mensagens recebidas durante a conversa. |
$conversation.outgoing_messages_count | O número de mensagens de saída enviadas durante a conversa (excluindo mensagens de transmissão). |
$conversation.responses_count | O número de respostas enviadas na conversa. |
$conversation.category | A categoria da conversa conforme especificado na nota de fechamento. |
$conversation.summary | O resumo da nota de fechamento da conversa. |
Variáveis de gatilho para o evento de anúncios Click-to-Chat
Nome da Variável | Descrição |
|---|---|
$clicktochat.ad_timestamp | O timestamp quando a mensagem foi recebida. |
$clicktochat.ad_first_incoming_message | 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 foi recebida. |
$clicktochat.ad_channel_type | O canal através do qual está ocorrendo a conversa relacionada ao anúncio. |
$clicktochat.ad_contact_type | O tipo de Contato associado ao 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 status do anúncio CTC. |
$clicktochat.ad_objective | O objetivo do anúncio CTC. |
$clicktochat.ad_optimization_goal | O objetivo de otimização do anúncio CTC. |
$clicktochat.ad_destination_type | O tipo de destino associado com o anúncio CTC. |
Variáveis de gatilho para anúncios de mensagens do TikTok
Variável | Descrição |
|---|---|
$tiktokmessagingad.ad_timestamp | Hora do clique no anúncio |
$tiktokmessagingad.ad_first_incoming_message | Primeira mensagem enviada pelo contato |
$tiktokmessagingad.ad_channel_id | ID do canal de mensagens |
$tiktokmessagingad.ad_channel_type | Tipo de canal (por exemplo, TikTok) |
$tiktokmessagingad.ad_contact_type | Tipo de contato (por exemplo, novo ou existente) |
$tiktokmessagingad.ad_id | ID do anúncio |
$tiktokmessagingad.ad_name | Nome do anúncio |
$tiktokmessagingad.ad_campaign_id | ID da campanha |
$tiktokmessagingad.ad_campaign_name | Nome da campanha |
$tiktokmessagingad.ad_adgroup_id | ID do grupo de anúncios |
$tiktokmessagingad.ad_adgroup_name | Nome do grupo de anúncios |
$tiktokmessagingad.ad_advertiser_id | ID do anunciante |
$tiktokmessagingad.ad_operation_status | Status operacional do anúncio |
$tiktokmessagingad.ad_secondary_status | Status secundário do anúncio |
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.
