Variáveis de sessão dos chatbots

Neste artigo vamos tratar das variáveis de sessão dos chatbots. 

As variáveis de sessão são utilizadas para referenciar informações da sessão do atendimento. Estas variáveis são de apenas leitura, e estão disponíveis para uso em qualquer outro bloco do fluxo de atendimento, como Mensagens de texto, Perguntas, condicionais, etc.

Para referenciá-las, utilize o prefixo session, conforme tabela abaixo. 

Os itens indicados com um * são relacionados ao horário. Nestes casos, o chatbot irá sempre considerar o horário no fuso-horário local do usuário. Exemplo, se um usuário no Brasil às 10 da manhã acessar o chatbot ao mesmo tempo que um usuário no Japão, a variável session.salutation será "Good morning" e "Good evening", respectivamente. 

Variáveis de sessão:

​{{session.saudacao}} Saudação em português (Bom dia, Boa tarde, Boa noite)*
​{{session.salutation}} Saudação em inglês (Good morning, Good afternoon, Good evening)*
{{session.ip}} Endereço ip do usuário
{{session.city}} Cidade do usuário baseado no endereço IP.
{{session.region}} Estado do usuário baseado no endereço IP.
{{session.country}} País do usuário baseado no endereço IP.
{{session.name}} Nome do usuário.
{{session.email}} Email do usuário.
{{session.identifier}} Identificador do usuário.
{{session.chatstart}} Início do atendimento.
{{session.localnow}} Horário atual no formato AAAA-MM-DD HH:MM:SS no fuso-horário do chatbot
{{session.now}} Horário atual no formato AAAA-MM-DD HH:MM:SS*
{{session.localagora}} Horário atual no formato DD-MM-AAAA HH:MM:SS no fuso-horário do chatbot
{{session.agora}} Horário atual no formato DD-MM-AAAA HH:MM:SS*
{{session.hour}} Hora do dia de 0 a 23*
{{session.minute}} Minuto do dia de 0 a 59*
{{session.second}} Segundo do dia de 0 a 59*
{{session.day}} Dia do mês de 1 a 31*
{{session.month}} Mês do ano de 1 a 12*
{{session.year}} Ano com 4 dígitos*
{{session.weekday}} Dia da semana de 1 a 7, sendo 1 segunda, 2 terça ... 7 domingo.*
{{session.seconds}} Quantidade de segundos desde que iniciou o atendimento.
{{session.time}} Tempo desde o início da sessão no formato HH:MM:SS
{{session.useragent}} Cabeçalho user-agent do usuário
{{session.lang}} Cabeçalho language do usuário
{{session.channel}} Canal utilizado pelo usuário (webchat, telegram, whatsapp, facebook-messenger)
{{session.os}} Sistema operacional do usuário
{{session.device}} Dispositivo do usuário (computer, tablet, mobile)
{{session.browser}} Browser do usuário
{{session.page}} Primeira página de chamada do chatbot
{{session.lastpage}} Última página durante a sessão do chatbot

Valores de exemplo:

{{session.saudacao}} Boa noite
{{session.salutation}} Good evening
{{session.ip}}: 34.232.118.100
{{session.city}} Ashburn
{{session.region}} Virginia
{{session.country}} US
{{session.name}}: João Silva
{{session.email}}: joao@gmail.com
{{session.identifier}} 10.100.100/0001-10
{{session.chatstart}} 12/01/2022 21:56:00
{{session.localnow}} 2022-01-12 21:56:30
{{session.now}} 2022-01-12 19:56:30
{{session.localagora}} 12/01/2022 21:56:30
{{session.agora}} 12/01/2022 19:56:30
{{session.hour}} 19
{{session.minute}} 56
{{session.second}} 30
{{session.day}} 12
{{session.month}} 1
{{session.year}} 2022
{{session.weekday}} 3
{{session.seconds}} 30
{{session.time}} 00:00:02
{{session.useragent}} Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0.4692.71 Safari/537.36
{{session.lang}} pt-BR,pt;q=0.9,en-US;q=0.8,en;q=0.7
{{session.channel}} webchat
{{session.os}} os x
{{session.device}} computer
{{session.browser}} chrome​
{{session.page}} https://www.tolvnow.com
{{session.lastpage}} https://www.tolvnow.com/planos

Casos de uso das variáveis de sessão:

​- Incluir informações pertinentes como localidade do usuário em um e-mail 

- Tratar diferentes idiomas em diferentes fluxos

- Tratar fluxos diferentes caso o cliente esteja em um computador ou um celular

- Incluir informações de IP e Horário local nos e-mails que são enviados do fluxo

- Direcionar o usuário para uma promoção ou oferta se ele estiver em uma determinada localidade

- Apresentar diferentes mensagens de boas vindas de acordo com o horário local