Variáveis de Sistema

As variáveis de sistema ficam em:

Configurações > Variáveis de Sistema

ou pela rota:

/configs/variables

Elas permitem customizar mensagens, intervalos e parâmetros operacionais sem alterar código.

Campos da tela

Campo	Uso
Variável	Chave técnica usada pelo sistema.
Descrição	Explicação interna para operadores/admins.
Valor	Conteúdo usado pelo sistema.
Status	Quando ativo, a variável pode ser considerada pelo backend.

Variáveis disponíveis

As variáveis abaixo são lidas pelo backend quando estão cadastradas e ativas. Para valores ausentes, o sistema usa o fallback descrito em cada linha.

Inatividade do atendimento

Variável	Tipo	Padrão/Fallback	Uso
CHAT_INACTIVITY_WARNING_MESSAGE	texto	vazio / configurável	Mensagem enviada nos avisos de inatividade. Suporta {{ delay(n) }}.
CHAT_INACTIVITY_WARNING_INTERVAL_MINUTES	inteiro	3 minutos	Intervalo entre avisos de inatividade.
CHAT_INACTIVITY_WARNING_ATTEMPTS	inteiro	0	Limite de avisos. 0 ou vazio = sem limite de avisos.
CHAT_INACTIVITY_END_MESSAGE	texto	vazio / configurável	Mensagem enviada ao encerrar por inatividade. Suporta {{ delay(n) }}.

Atenção

A descrição antiga de CHAT_INACTIVITY_WARNING_ATTEMPTS no banco pode estar desatualizada, dizendo algo como “Use 0 para encerrar direto”. A regra correta é: 0 ou vazio = avisos ilimitados.

Fila de atendimento

Variável	Tipo	Padrão/Fallback	Uso
CHAT_QUEUE_POSITION_NOTIFY_INTERVAL_MINUTES	inteiro	3 minutos	Intervalo entre avisos de posição na fila.
CHAT_QUEUE_POSITION_INCLUDE_AVERAGE_WAIT	booleano	false	Define se o aviso da fila inclui tempo médio de espera.

Mensagens de autenticação, ERP e desbloqueio

Variável	Tipo	Padrão/Fallback	Uso
MSG_POS_AUTH	texto	Olá {nome}, que bom te ver por aqui!	Mensagem após autenticação ERP antes de mostrar faturas/contratos.
MSG_SERVICO_DESBLOQUEADO	texto	resposta do ERP	Template de sucesso da liberação em confiança. Suporta {{ delay(n) }}.
MSG_SERVICO_PROMESSA_QTD_EXCEDIDA	texto	resposta do ERP	Template quando excede o limite de liberação em confiança. Suporta {{ delay(n) }}.

Intervalos de envio

Variável	Tipo	Padrão/Fallback	Uso
INTERVALO_MENSAGENS_GERAL	inteiro	3 segundos	Delay entre estágios automáticos do fluxo.
INTERVALO_MENSAGENS_SMS	inteiro	3 segundos	Delay usado no envio remoto/SMS.

Canais e telefonia

Variável	Tipo	Padrão/Fallback	Uso
MENSAGEM_NAO_RECEBE_CHAMADA	texto	Não recebemos chamada.	Mensagem enviada quando chega evento de chamada pelo WhatsApp.

Recursos técnicos

Variável	Tipo	Padrão/Fallback	Uso
TR_69_ENABLE	booleano	false se ausente	Habilita exibição/uso de detalhes TR-069 na consulta técnica ERP.

Aliases e compatibilidade

Algumas constantes antigas continuam existindo como alias interno para manter compatibilidade com código anterior.

Alias interno	Equivale a
INACTIVITY_WARNING_ATTEMPTS_KEY	CHAT_INACTIVITY_WARNING_ATTEMPTS
INACTIVITY_WARNING_INTERVAL_KEY	CHAT_INACTIVITY_WARNING_INTERVAL_MINUTES
INACTIVITY_WARNING_MESSAGE_KEY	CHAT_INACTIVITY_WARNING_MESSAGE

informação

Na tela de configuração, cadastre sempre o nome final da variável, por exemplo CHAT_INACTIVITY_WARNING_ATTEMPTS. Os aliases acima são apenas referência técnica de compatibilidade.

Valores booleanos aceitos

Para variáveis booleanas como TR_69_ENABLE e CHAT_QUEUE_POSITION_INCLUDE_AVERAGE_WAIT, o sistema considera verdadeiro valores como:

1
true
sim
yes
enabled
ativo

Para CHAT_QUEUE_POSITION_INCLUDE_AVERAGE_WAIT, prefira documentar e preencher como true ou false.

Text Rotation nas variáveis

Variáveis de sistema que enviam mensagens podem usar Text Rotation para gerar variações antes do envio.

Exemplo para CHAT_INACTIVITY_WARNING_MESSAGE:

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

Use esse recurso em mensagens de inatividade, fila, ERP, autenticação e respostas automáticas quando fizer sentido variar a frase sem alterar o significado.

Templates Jinja nas variáveis

Algumas variáveis aceitam template Jinja, especialmente mensagens relacionadas a inatividade, fila e desbloqueio em confiança.

Exemplo para MSG_SERVICO_DESBLOQUEADO:

Olá! Já estou agilizando a liberação do seu sinal.
{{ quebra_de_linha }}
Contrato: {{ contrato.id }}

Exemplo para MSG_SERVICO_PROMESSA_QTD_EXCEDIDA:

No momento, não foi possível realizar uma nova liberação em confiança.
{{ quebra_de_linha }}
Motivo: limite de uso excedido.

Exemplo com atraso em uma mensagem de inatividade:

Ainda está por aí?
{{ delay(30) }}
{{ quebra_de_linha }}
Vou encerrar o atendimento se não houver resposta.

dica

Para mensagens que usam dados de fatura, contrato ou cliente, veja também o guia de Templates Jinja.

Variáveis exibidas na tela do exemplo

Na tela de /configs/variables, é comum encontrar:

Variável	Descrição sugerida
MSG_SERVICO_DESBLOQUEADO	Mensagem Liberação Serviço Confiança
MSG_SERVICO_PROMESSA_QTD_EXCEDIDA	Mensagem de liberação não feita por excesso de uso
MENSAGEM_NAO_RECEBE_CHAMADA	Mensagem para responder quando cliente ligar
CHAT_INACTIVITY_WARNING_ATTEMPTS	Quantidade máxima de avisos de inatividade antes do encerramento
CHAT_QUEUE_POSITION_NOTIFY_INTERVAL_MINUTES	Intervalo de aviso de posição na fila

Recomendações

• Mantenha as chaves em caixa alta e com _.
• Não altere a chave técnica depois que ela estiver em uso.
• Use Status = Ativo apenas para variáveis que devem ser consideradas.
• Em intervalos, use apenas números inteiros.
• Em mensagens longas, use {{ quebra_de_linha }} para dividir o envio.
• Em variáveis booleanas, prefira true ou false para facilitar auditoria.