Objetivo

Orientar administradores de banco de dados e equipes de implantação sobre como identificar e corrigir problemas relacionados ao Nível de Compatibilidade (Compatibility Level) do banco de dados utilizado pelo Tactium.

Sintoma

Durante a execução de scripts de atualização ou procedures do Tactium podem ocorrer erros semelhantes aos abaixo:

'TRY_CONVERT' is not a recognized built-in function name.

Incorrect syntax near the keyword 'ELSE'.

'TRY_CAST' is not a recognized built-in function name.

Mesmo quando o servidor utiliza uma versão recente do SQL Server (2019 ou superior).

Causa

Embora o SQL Server instalado suporte funções como TRY_CONVERT, TRY_CAST e outros recursos modernos, o banco de dados pode estar configurado com um Nível de Compatibilidade inferior ao exigido pela aplicação.

Nessa situação, o SQL Server passa a interpretar os comandos utilizando regras de versões antigas, ocasionando falhas na compilação das procedures.

Como verificar o nível de compatibilidade

Execute a consulta abaixo:

SELECT
    name,
    compatibility_level
FROM sys.databases
WHERE name = DB_NAME();

Exemplo de retorno:

Como identificar a versão do SQL Server

SELECT @@VERSION;

Exemplo:

Microsoft SQL Server 2019
15.x

Compatibilidade recomendada

Como alterar o nível de compatibilidade

Pré-requisito: possuir permissão de administrador (ALTER DATABASE).

Execute:

ALTER DATABASE [NomeDoBanco]
SET COMPATIBILITY_LEVEL = 150;

Substitua NomeDoBanco pelo nome do banco do CRM.

Como confirmar a alteração

Após executar o comando, valide novamente:

SELECT
    name,
    compatibility_level
FROM sys.databases
WHERE name = DB_NAME();

Resultado esperado:

Próximo passo

Após alterar o nível de compatibilidade:

• Execute novamente a atualização do Tactium.
• Reexecute a procedure que apresentou erro.
• Valide se não existem novas mensagens de compilação.

Perguntas Frequentes

O SQL Server é 2019. Por que ocorre esse erro?

Porque o Compatibility Level do banco está configurado para uma versão antiga (por exemplo, 100 ou 110). O SQL Server executa determinadas instruções respeitando esse nível de compatibilidade.

Alterar o Compatibility Level atualiza o SQL Server?

Não.

O comando altera apenas o comportamento do banco de dados, sem modificar a versão instalada do SQL Server.

Há risco em alterar o nível de compatibilidade?

Em geral, não. A alteração é suportada pela Microsoft e recomendada quando o banco é executado em versões mais recentes do SQL Server.

Entretanto, como qualquer alteração de configuração, recomenda-se:

• realizar backup do banco de dados;
• executar a alteração em ambiente de homologação quando possível;
• validar os processos críticos da aplicação após a mudança.

Preciso reiniciar o SQL Server?

Não.

A alteração é aplicada imediatamente e não requer reinicialização do serviço.

Preciso executar a alteração em todos os bancos?

Somente nos bancos utilizados pelo Tactium que apresentarem nível de compatibilidade inferior ao suportado pela versão instalada do SQL Server.

Recomendação da Tactium

Para ambientes executando Microsoft SQL Server 2019, recomenda-se manter o banco de dados do Tactium com Compatibility Level 150, garantindo suporte aos recursos utilizados pelas versões atuais da aplicação e evitando erros durante futuras atualizações.

Boas práticas para futuras implantações

Antes de iniciar qualquer atualização do Tactium, recomenda-se validar:

• ✔ Versão do SQL Server suportada pela versão da aplicação.
• ✔ Nível de compatibilidade do banco de dados.
• ✔ Backup atualizado do banco.
• ✔ Permissões do usuário responsável pela atualização.

Essa verificação preventiva reduz significativamente a ocorrência de falhas durante a execução de scripts de atualização e procedimentos armazenados.

A nova funcionalidade do TactiumIP permite que, ao realizar uma ligação ativa manual que vá para a caixa postal, o agente possa escutar o áudio retornado pela operadora. Dessa forma, é possível identificar se a ligação foi realmente atendida por uma pessoa ou se caiu diretamente na caixa postal.

Passos para testar a funcionalidade:

1. Acessar o nMonitor >> Configurações >> Cliente CTI

2. Habilitar o parâmetro “Pode Ouvir Áudio de Pré-Atendimento” e definir como Sim

3. Realizar uma ligação ativa manual para um número que direciona para a caixa postal

Pronto! A partir desse momento, sempre que uma ligação ativa manual cair na caixa postal, o agente conseguirá escutar o áudio retornado pela operadora.

Observação: Caso seja necessário gravar o áudio da caixa postal, é preciso habilitar previamente a opção de gravação no sistema.

O parâmetro ‘Indicador para desabilitar a opção de consultar pessoas para operador (0/1)’ pode ser encontrado no caminho: ManagerADM >> Configurações >> Configurações Gerais. Vale ressaltar que este parâmetro se aplica exclusivamente ao perfil de ‘Operador’.

Para bloquear o envio de mensagens para um número específico durante o desempenho das campanhas ou para não enviado pelo operador (ativo manual) no Omni PA, o usuário com perfil “Administrador” deverá cadastrá-lo no Tactium Admin.

Acesse Cadastros Básicos >> Bloqueio Contatos Omni.

A página seguinte contém um dashboard que irá apresentar todos os contatos já bloqueados. Para bloquear um novo contato, clique em “+Novo”.

Preencha os campos respectivos para salvar o novo registro:

Após clicar no botão “Salvar” o contato estará bloqueado, logo não será possível enviar mensagens através de canais ativos (campanha/ativo manual).

Existe um novo parâmetro no config para clientes que possuem problema com carregamento de arquivos estáticos com HTTPS. Para habilitar o novo parâmetro basta no config do IntegrationServices dentro da tag “<appSettings> </appSettings>” adicionar “<add key=”config:URLQualified” value=” “/> ” sendo o valor o endereço da aplicação.

<appSettings>

<add key=”config:URLQualified” value=”http://meuendereco/ip/api” />

</appSettings>

No Tactium CRM é possível realizar uma ligação através do botão () disponível durante a revisão/ abertura de uma ocorrência já registrada. Através dele será possível desmarcar a opção manualmente de “Gerar atendimento” que por default ficará habilitado. Ao discar com essa opção habilitada, o sistema fará com que a ligação completada seja aberto uma nova ocorrência a partir da atual. Entretanto, ao desmarcar essa opção o sistema não abrirá uma nova ocorrência, entendendo que deseja continuar o atendimento na ocorrência aberta inicialmente.

Entretanto, existe o seguinte parâmetro “Habilitar por padrão a opção “Gerar Atendimento” dentro da discagem da ficha de atendimento.” que está disponível em “Configurações Gerais” no ManagerADM que permitirá com que a opção default do Checkbox “Gerar atendimento” fique desmarcada.

Aplicando a licença SQLServer 2019

Este procedimento visa ensinar como licenciar um SQLSever 2019, para sair da versão Enterprise Evaluation para a versão Standard Edition.

Execute o Instalador que contem a licença aplicada.

Nesta tela abaixo, clique em Manutenção(Maintenance) e clique em Atualização de Edição(Edition Upgrade).

Na tela seguinte, ira mostrar a licença. Basta clicar em avançar e ir avançando até concluir. Não tem muita necessidade de mostrar cada tela, pois é basicamente clicar em avançar em todas elas.

Ao final, basta clicar em atualizar e pronto. Interessante após este procedimento reiniciar o serviço do Sql.

No Manager ADM (TTAdmin) configurar os dois parâmetros, sendo primeiro com o link externo e segundo com o link interno, ambos apontando para o WebHook Tactium.

• Com o link externo é o parâmetro (PMT) “URL externa webhook OmniChannel” para o funcionamento da troca de anexos, sem declarar o método específico.

Em vermelho sinalizamos os dados que serão variáveis de acordo com o site configurado no cliente.

https://SiteDomínioDoCliente/OMNI/Webhook/

• Com o link interno é o parâmetro (PMT) “URL para acesso interno ao webhook OmniChannel” para o funcionamento da troca de anexos, sem declarar o método específico.

Em vermelho sinalizamos os dados que serão variáveis de acordo com o site configurado no cliente.

https://IP do Servidor Cliente/OMNI/Webhook/

Antes de iniciar a configuração do horário padrão é necessário realizar o cadastro no Manager ADM. Para mais informações acesse Cadastrando um horário padrão no Tactium CRM. Após cadastrá-lo, será necessário associar o horário padrão nos serviços de mensagem na aba Cadastrar Serviço, personalizando uma mensagem de fora de horário específica.

A solução Tactium OMNI permite que o cliente possa iniciar o atendimento através de um canal, migrando para um outro dando a devida flexibilidade de acordo com a preferência do cliente, conforme o desenrolar do atendimento. Temos disponível os seguintes tipos de mudanças de canal:

Telefone para WhatsApp

A mudança é feita através do botão do WhatsApp  que é habilitado no ticket de telefonia ao clicar no botão será apresentado os Template dos Serviços de WhatsApp que estão habilitados para atendimento, após seleciona-lo aparecerá um novo ticket de atendimento de WhatsApp, finalizando o ticket de telefone automaticamente. Para realizar a mudança é necessário que cliente esteja vinculado ao atendimento. Caso contrário, não será apresentado o botão de transferência para o WhatsApp.

Mensageria para Telefone

A mudança dos atendimentos de WhatsApp e WebChat para Telefonia é através do o botão que fica na barra inferior da conversa, ao clicar nele é possível realizar um ativo por meio dos números já cadastrados ou por meio de um novo número digitado no momento da mudança. Ao discar é transferido para a toolbar e aberto um novo ticket para atendimento de telefone, mantendo os dois em aberto. Para realizar a mudança é necessário que cliente esteja vinculado ao atendimento e que a Toolbar esteja logada dentro do OmniPA para que o botão fique habilitado.

Para melhor compreensão do funcionamento da troca de canais de atendimento acesse Realizando a troca de atendimento entre canais do OMNI.