Pular para o conteúdo principal

Text Rotation

Text Rotation permite escrever variações de uma mesma mensagem usando grupos de opções entre chaves. Antes do envio, o backend escolhe uma opção de cada grupo e monta uma versão final da mensagem.

Use esse recurso quando a operação precisa evitar que mensagens automáticas sejam sempre idênticas, mantendo o mesmo sentido do atendimento.

Sintaxe

Separe as opções com | dentro de {}:

{Olá|Oi|Bom dia}, {tudo bem?|como vai?}

Esse texto pode gerar resultados como:

Olá, tudo bem?
Oi, como vai?
Bom dia, tudo bem?

Exemplo em mensagem de inatividade

{Olá|Oi}! {Ainda está aí?|Você ainda está por aqui?}
Seu atendimento {poderá ser encerrado|será finalizado} por inatividade.

Um resultado possível seria:

Oi! Você ainda está por aqui?
Seu atendimento poderá ser encerrado por inatividade.

Grupos aninhados

É possível usar grupos dentro de outros grupos:

{Olá|{Bom dia|Boa tarde}}, {{ cliente.nome }}.

Resultados possíveis:

Olá, Maria.
Bom dia, Maria.
Boa tarde, Maria.

Onde funciona

Text Rotation é aplicado de forma transversal nas mensagens enviadas pelo backend. Isso inclui, por exemplo:

  • Mensagens de fluxo.
  • Perguntas automáticas.
  • Respostas automáticas.
  • Variáveis de sistema com mensagens.
  • Avisos de inatividade.
  • Mensagens de fila.
  • Mensagens fora de expediente.
  • Mensagens de autenticação, ERP e desbloqueio.

Na prática, mensagens configuradas em variáveis como CHAT_INACTIVITY_WARNING_MESSAGE, CHAT_INACTIVITY_END_MESSAGE, MSG_POS_AUTH, MSG_SERVICO_DESBLOQUEADO e mensagens equivalentes podem usar variações de texto antes do envio.

Ordem de processamento

O backend resolve Text Rotation antes de processar recursos especiais da mensagem, como:

  • {{ delay(...) }}
  • {file=...}
  • Quebras de mensagem e demais instruções do template.

Isso permite combinar variações de frase com atrasos, envio de mídia e templates dinâmicos.

Compatibilidade com Templates Jinja

Blocos Jinja são preservados durante a rotação de texto. Você pode combinar Text Rotation com variáveis e controles Jinja:

{Olá|Oi}, {{ cliente.nome }}.
{{ delay(5) }}
{Encontrei sua fatura|Localizei seu boleto} com vencimento em {{ fatura.vencimento }}.

Também são preservados blocos como:

{{ cliente.nome }}
{{ delay(5) }}
{% if fatura %}
{# comentário #}
dica

Use Text Rotation para variar frases, saudações e chamadas curtas. Evite aplicar variação em números, URLs, códigos de barras, chaves Pix, protocolos ou qualquer dado que precise permanecer exato.