Utilizando Tokens de Data e Hora

Como trabalhar com tokens de data e funções de tempo.

Sobre o Tipo do Campo

Na Sprinthub, você pode trabalhar com diversos tokens relacionados a data e hora. Por padrão, os valores de data são armazenados no formato ISO, sempre no fuso UTC — por exemplo: 2024-10-11T16:12:47.750Z. No entanto, é possível formatar essas datas ou até mesmo gerar datas relativas, como veremos ao longo deste artigo.

Além disso, a plataforma permite criar campos customizados de Data e Hora ou apenas de Data, oferecendo flexibilidade para se adaptar às necessidades do seu processo, como mostra o exemplo abaixo:

Campo 'Aula Experimental' na listagem de campos.

Campo 'Aula Experimental' em dados completos do lead.

Formatando Campos do Lead

Para formatar um campo do tipo Data e Hora, você pode utilizar diferentes opções de token:

• [date] → exibe apenas dia, mês e ano no formato brasileiro.

• [datetime] → funciona como o [date], mas inclui também as horas.

• [yyyy-mm-dd] → mantém o padrão internacional (ISO 8601).

• [yyyy-dd-mm] → inverte a ordem de dia e mês no padrão de ano primeiro.

• [unix] → converte a data para o formato Unix Timestamp (total de segundos desde 01/01/1970), ideal para integrações via API ou bancos de dados.

• [month] → extrai apenas o número do mês (01 a 12).

• [year] → extrai apenas o ano com quatro dígitos.

• [day] → extrai apenas o dia do mês.

• [time] → exibe apenas o horário (horas e minutos), ignorando a data.

O valor entre colchetes deve ser colocado antes do alias do token no momento da substituição. Por exemplo:

{contactfield=[date]aula_experimental}

A seguir, está um exemplo prático mostrando como esse token é substituído em cada uma das formatações:

Tokens utilizados em um atendimento do SAC360.

Funções de Data

Em alguns casos, pode ser útil gerar datas relativas em tempo real, por exemplo, pegar a data de hoje no momento em que uma automação é executada, calcular o dia seguinte ou até mesmo uma semana à frente.

Isso é feito por meio dos tokens function.

• À direita do sinal de igual fica a referência temporal (ex.: yesterday, tomorrow).

• A formatação (opcional) pode ser colocada no meio do token.

Exemplos comuns:

• Um ano atrás → {function=lastYear}

• Mês passado → {function=lastMonth}

• Ontem → {function=yesterday}

• Semana passada → {function=lastWeek}

• Hoje → {function=today}

• Também funciona para nextYear, nextMonth, tomorrow, etc.

Exemplo com formatação, sendo executado 27/09/2025:

{function=[date]tomorrow} -> 28/09/2025

Esses tokens podem ser usados em diferentes pontos da Sprinthub, como em atendimentos, automações de envio de mensagens ou até mesmo em integrações via Webhook para plataformas externas.