Configurando Integração URL Externa Toolbar
Sumário
Pré-requisito
- Desabilitar o bloqueador de pop-ups do link externo que será configurado;
- Configurar a URL no parâmetro “UrlAppExternal” do arquivo de configuração da Toolbar para uso no discador e os parâmetros necessários, conforme a aplicabilidade desejada (somente discador automática, discagem manual, receptivo ou uso de variáveis oriundas da URA.
Como funciona?
O cliente precisará disponibilizar uma URL que permita passar parâmetros (variáveis) para abertura da tela de cadastro do cliente de acordo com o contexto da ligação que ocupará a PA.
Nas ligações ativa do Discador preferencialmente será usado o ID do cliente (código do mailing importado na Campanha) e para o receptivo ou discagem manual pode-se usar o número do telefone do cliente.
Estão disponíveis os seguintes parâmetros fixos que poderão ser repassados na abertura da tela do sistema externo do cliente.
- ID do cliente (deverá ser carregado através do mailing do cliente usado no Discador que pode ser importado pelo TTCampanha ou através de outras camadas de inserção de mailing)
- Número do cliente (Número discado ou recebido de acordo com o contexto da ligação)
- Login do Agente (do operador logado no Tactium IP)
Habilitando a integração ligações ativa Discador
Por padrão a integração funciona para as ligações ativa do Discador e para habilitar será necessário acessar o arquivo de configuração da Toolbar (dentro do seu diretório de instalação) e incluir a TAG “UrlAppExternal” dentro da section <appSettings>, conforme ilustrando no exemplo abaixo.
<add key=”UrlAppExternal” value=”http://www.softium.com.br?param1={0}&param2={1}&param3={2}” />
Podemos observar na URL dois pontos importantes no exemplo acima, sendo:
- Os números 0, 1, 2 e 3 representaram os valores fixos dos parâmetros que serão mesclados
{0}-ExtenalData (ID externo do mailing carregado)
{1}-Telefone do cliente
{2}-AgentLogin (Login do agente do Tactium IP que recebeu a ligação).
{3}-CallID (Identificador da ligação).
- A informação & trata-se de um separador dos parâmetros que antecederá o “;”, com base no exemplo acima.
Habilitando a integração ligações Receptivas e ligações Ativas manuais
Para habilitar será necessário adicionar a sua respectiva TAG no arquivo de configuração da Toolbar:
- Ligações do receptivo:
<add key=”Toolbar:UseUrlAppExternalForReceptiveCall” value=”true”/> - Ligações do ativo manual:
<add key=”Toolbar:UseUrlAppExternalForManualOutcomingCall” value=”true” />
Habilitando e configurando variáveis publicadas na URA na URL de integração
Para habilitar o uso das variáveis de URA nos parâmetros da URL de integração que foram publicados previamente na árvore será necessário adicionar TAG no arquivo de configuração da Toolbar:
<add key=”Toolbar:UsePublicVariablesForIvr” value=”true”/>
Exemplo: No final a URL de teste ficará da seguinte forma, imaginando que existem duas variáveis publicadas na URA, sendo uma o CPFCNPJ e a outra o Valor_Contrato.
Em laranja sinalizo os valores mesclados das variáveis fixas e em verde o que será criado de forma dinâmica das variáveis de URA, de acordo com o contexto da ligação navegada na URA.
URL resultante: http://www.softium.com.br?param1=4567546;param2=8540050500;param3=ailton;ivr_CPFCNPJ=60007998740;ivr_Valor_Contrato=1,00
1- Para usar o recurso de variáveis publicadas será necessário garantir que elas estavam marcadas como públicas no cadastro do IVR.
2- Para que a variável publicada seja mostrada na URL a navegação da URA precisa passar pelo ponto onde essa variável é atribuída, dentro do contexto da ligação que foi direcionada para a PA.
3- As variáveis publicadas oriundas da URA ficarão sempre nesse formato “ivr_{NOME_VARIAVEL}={VALOR}”.