Configurando a Integração Sistema Finaz com a API do Tactium IP
Sumário
Pré-requisito
- O Tactium IP deverá está atualizado em versões igual ou superior à 5.5.104.1.
- A API de integração Tactium IP precisará ser instalada.
- O pool de configuração da API de integração do Tactium IP precisará está com as configurações do pool de reciclagem, conforme estamos habituados a usar nas aplicações de acesso ao cliente. Para mais informações acesse Configurando a reciclagem do pool no IIS.
Integração FINAZ
A integração FINAZ tem uma particularidade em relação às demais integrações, no qual eles não gerarão token sob demanda (a partir do método de autenticação) e também não trata o recebimento do retorno dos eventos a partir do WebHook.
Portanto, torna-se necessário realizar algumas configurações especificas explicadas a seguir.
Configurar a validar estendida do Token e URL para recebimento de evento de atendimento de ligação.
No arquivo de configuração é necessário habilitar a quantidade de dias da expiração do Token. O Token para a integração da Finaz será fixo e não será renovado, visto que se trata de uma configuração estática por parte do Suporte da Finaz. Portanto, deve-se configurar uma quantidade elevada de dias, evitando e invalidade do Token.
A URL deverá ser configurada conforme o exemplo abaixo, sendo necessário alterar o valor fixo do ID da empresa, obtido através do Suporte da Finaz, conforme sinalizado em vermelho na URL. Essa URL será notificada em toda ocupação da PA, permitindo que a Finaz recebe os valores das variáveis definidas de forma fixa na URL.
Um ponto importante é que essa URL deverá ser configurada de forma codificada (URL encode), conforme explicado abaixo.
URL (normal):
https://api.finaz.com.br/telephony-proxy/atendimentodiscador?pid=${dialer.ExternalData}&num=${CalledDevice}&cid=${SwitchCallID}&ramal=${DeviceIdentifier}&empresaId=1185
URL (codificada):
https%3A%2F%2Fapi.finaz.com.br%2Ftelephony-proxy%2Fatendimentodiscador%3Fpid%3D%24%7Bdialer.ExternalData%7D%26num%3D%24%7BCalledDevice%7D%26cid%3D%24%7BSwitchCallID%7D%26ramal%3D%24%7BDeviceIdentifier%7D%26empresaId%3D1185
Dica! Através do site informado é possível adicionar a URL e clicar no botão “Enconde” para codifica-la.
Configurar o DDD local para forçar a passagem nas ligações locais
No arquivo de configuração (web.config) do IPIntegrationServices será necessário adicionar a TAG sinalizada abaixo o DDD local (mesmo configurado no nMononitor >> No menu “Configurações” – Aba “Geral – “Localidade”/ “Código da área local”) para que nas ligações locais a URL de integração repasse o DDD junto com o número nas ligações locais.
Fornecer um Token válido para o Suporte da Finaz
Será necessário iniciar o console do IntegrationServices ou, através da própria API de integração do Tactium IP, acessando o simular Swagger para gerar um Token válido.
Esse Token deverá ser passado para o Suporte da Finaz realizar as configurações globais da integração.
Publicar a API de integração do Tactium IP para acesso externo do sistema Finaz
Será necessário publicar o endereço da API de integração do Tactium IP para que a Finaz possa provê a integração, podendo executar os comandos que estão dentro escopo da integração, visto que o sistema é instalado em nuvem.
Path padrão: https://IP-Externo-Cliente/tactiumvoip/IPIntegrationServices
IMPORTANTE! Recomendamos enfaticamente que a publicação da API de integração do Tactium IP seja protegida através de certificado digital (https).