Variáveis para Mensagens - Comunicação Externa
Introdução
As variáveis do sistema funcionam como placeholders (espaços reservados para uma informação) que permitem personalizar mensagens automáticas de e-mail e SMS. Elas servem para inserir informações reais — como dados do cliente, do contrato ou de cobranças — no momento do envio, garantindo clareza e padronização nas comunicações.
Como localizar as variáveis?
As variáveis de mensagens estão atreladas à editores de texto no cadastro de mensagens. Acesse em:
- Mensagens de e-mail:
- Mensagens de SMS:
- Templates Omnichannel:
Estrutura da Funcionalidade
A funcionalidade de variáveis é baseada em três pilares:
- Identificadores pré-definidos: cada variável possui um código padronizado (ex.:
#cliente_email#) que o sistema reconhece como um espaço reservado que será substituído pelo valor real no momento do uso. - Mapeamento com o banco de dados: cada código está vinculado a um campo específico da base, garantindo que a informação usada seja atual e consistente.
- Substituição no momento da emissão: quando a mensagem ou template é acionado, o sistema lê cada variável e preenche automaticamente com o valor correspondente.
As variáveis disponibilizadas seguem sempre o formato:
#nome_da_variavel#
Esse formato identifica que aquele trecho não é um texto fixo. Ele será substituído automaticamente por um valor real somente no momento do envio. Elas ficam disponíveis diretamente nos formulários de cadastro de mensagens, onde podem ser inseridas livremente no corpo da mensagem.
Cuidado ao usar uma variável!
Cada variável só funciona em formularios tratados, ou seja, naqueles tipos de envio que realmente suportam aquele dado. Se a variável for usada em um local não compatível, ela não será preenchida e será enviada em seu estado original.
Envios Suportados
O uso de variáveis no IXC Provedor se relaciona diretamente das integrações configuradas para os disparos. Atualmente, o sistema reconhece três integrações principais responsáveis por entregar as mensagens aos clientes.
Integrações Disponíveis
Os envios realizados através do sistema são realizados por meio do uso das integrações de:
Métodos de Disparo
A partir do uso de integrações de canais de comunicação, o sistema trabalha com diferentes métodos de disparo, e cada método possui sua própria lista de variáveis suportadas. Ou seja, uma variável pode existir no sistema, mas só será preenchida se o fluxo que está enviando a mensagem souber tratá-la. Verifique- a seguir, a relação de métodos de disparo e as variáveis que podem ser utilizadas
::: details Variáveis de E-mail
Integração necessária:
:::
::: details Variáveis de SMS
Integração necessária:
::: details Variáveis Omnichannel
Integração necessária:
Métodos de envio:
Variáveis Suportadas
As variáveis utilizadas neste envio seguem a lista oficial de variáveis do Omnichannel. Para consultar a lista completa e atualizada, acesse: Variáveis Templates - Omnichannel (Opa! Suite)
:::
Boas Práticas
- Use apenas variáveis listadas oficialmente para evitar falhas no envio.
- Não altere o formato (
#variavel#), pois isso impede o preenchimento. - Evite duplicação desnecessária de variáveis no mesmo texto.
- Não dependa de variáveis em mensagens genéricas que podem ser usadas em fluxos diferentes.
- Teste sempre o envio antes de colocar uma mensagem em produção.
- Evite dados sensíveis fixos em textos; use variáveis quando possível.
Considerações Finais
O uso de variáveis torna a comunicação automatizada mais inteligente, contextualizada e profissional. Quando configuradas nos fluxos certos, elas reduzem retrabalho e eliminam erros manuais. Para garantir o melhor resultado, é essencial seguir a estrutura correta, validar o tipo de envio e manter as integrações ativas.