Plugins

O recurso de plugins do Tolvnow permite que você inclua uma aba de complemento na janela de chat no painel de atendimento, para que os atendentes possam interagir com outros sistemas dentro da mesma tela. 

Verifique a disponibilidade deste recurso no plano contratado.

Entenda onde ficam as abas de complemento e saiba mais sobre o painel de atendimento clicando aqui

Inserindo um plugin

Para criação inicie a sessão com seu login e senha de administrador e acesse "Configuraçõesno painel administrativo para então, logo abaixo de Integrações entrar em  "Plugins". Ao abrir esta opção, você encontra a listagem dos plugins já cadastrados com a possibilidade de incluir um novo ou editar um plugin da lista. Veja como incluir um novo:

Itens do formulário

Descrição

Nome

 Insira um nome que identifique o plugin que está sendo instalado.  O nome do plugin deve ter entre 10 e 200 caracteres.

URL do pluginInforme uma URL válida de onde seu plugin será carregado. Atenção: só serão aceitos endereços válidos que contenham o certificado digital. É indispensável a utilização de protocolo HTTP sobre SSL. Ou seja, deve conter "https"na frente do endereço.
Clique neste botão para continuar a configuração do seu plugin e você vai ser redirecionado para um novo formulário.

Itens do formulário

Descrição

Homologação

 Assim que redirecionado para esta tela,  o status de homologação será exibido como "Não solicitado" e logo ao lado, encontra-se o botão "Solicitar homologação". Clique aqui e veja mais detalhes sobre a homologação. 

TokenToken único do plugin. Caso você utilize a mesma URL para o direcionamento de diferentes plugins, utilize este token para identificar o plugin. 
Título da abaSerá exibido na aba de complemento na janela de atendimento do atendente. O nome da aba do plugin deve ter entre 3 e 30 caracteres. Saiba mais sobre as abas de complemento clicando aqui
URL do pluginSerá exibida a mesma URL que foi inserida na tela anterior da criação do plugin. Depois de solicitar a homologação a URL não poderá ser alterada.
Descrição Descreva objetivamente a função deste plugin e uma URL de exemplo. Será fundamental para a homologação e ativação deste recurso pela equipe de verificação do Tolvnow. A descrição do plugin deve ter entre 30 e 2000 caracteres.
DepartamentosSelecione os departamentos nos quais este plugin será carregado. Por exemplo, se este é um plugin de integração de cobrança, ele poderá ser exibido na aba de complemento somente quando o atendimento for realizado pela equipe de cobrança. 
Clique em salvar para concluir. Não esqueça de solicitar a homologação depois que o preenchimento do formulário estiver pronto.


Listagem dos plugins

Na lista de plugins cadastrados, veja o nome do plugin, status, possibilidade de editar e excluir os plugins cadastrados. 


Detalhes dos plugins

Os plugins possibilitam a inserção de uma nova aba na janela do chat com um sistema externo para consulta dos seus atendentes no momento em que ele realiza um atendimento. 

Veja alguns exemplos de como este recurso pode ser utilizado:

• Sistema de cobrança: interface especial para atualização de boletos bancários ou emissão de faturamento dos clientes;

• Sistema de CRM: interface para consultar dados e históricos do cliente (que não tenham relação direta com o chat);

• Sistema de Suporte técnico: interface para consultar os tickets em andamento dos clientes. *

*Se você já é cliente do nosso sistema de tickets Tolvdesk, clique aqui e veja como incluir o sistema em uma nova aba sem a necessidade dos plugins. 


Homologação

Depois de preenchido todos os itens do formulário de criação, você deverá solicitar a homologação do plugin. Este processo garante que nossa equipe verifique a implementação do seu plugin, a compatibilidade dele com o Tolvnow e o impacto na operação da plataforma. 

Para liberação do seu plugin, é fundamental que você siga as seguintes diretrizes:

• URL com HTTP/SSL, com certificado SSL válido por pelo menos 1 ano. Haverá uma exceção nos certificados emitidos pela Letsencrypt com validade inferior. Este item é obrigatório. 

•  O plugin não poderá emitir eventos que bloqueiem a interface como por exemplo, Alerts nativos do JS.

•  O plugin não poderá ter redirects para outras URLs diferentes da URL que foi criada e homologada no Tolvnow. 

•  O plugin não poderá efetuar atualizações (refreshs) constantes ou requisições assíncronas (pooling) automáticas em intervalos inferiores a 30 segundos.

• O plugin não poderá interferir ou interagir com outros componentes externos ao iframe de onde ele é carregado dentro da interface. 

•  Após homologado pela nossa equipe, não será possível efetuar alterações na URL do plugin criado.

•  O plugin poderá ser disponibilizado em qualquer URL/domínio de propriedade do contratante, sendo que não serão permitidas URLs diferentes das homologadas ou de propriedade/titularidade de terceiros. 

•  Ao utilizar este recurso, você entende que o descumprimento das regras de homologação poderá ocasionar a imediata suspensão da conta e do contrato de prestação de serviços.


Desenvolvendo o plugin

A implementação de plugins para o Tolvnow exige conhecimento técnico intermediário de programação para internet. 

O plugin será carregado pelo Tolvnow em uma aba nova do atendimento de acordo com o departamento escolhido pelo cliente. 

A URL do plugin será carregada em um IFRAME identificado pela ABA do plugin. Na URL informada na configuração do plugin serão inclusos parâmetros extras conforme tabela abaixo.

Parâmetro

Descrição

token

 Token da sessão do agente no Tolvnow. Atenção: este não se trata do token do plugin.

plugin-tokenToken único do plugin. Caso você utilize a mesma URL para o direcionamento de diferentes plugins, utilize este token para identificar o plugin. 
idchatCódigo do atendimento. Poderá ser consumido através da api restful
idagentCódigo do atendente (agente). Poderá ser consumido através da api restful
agentNome do agente.
emailE-mail do cliente.


Havendo dúvidas no processo de implementação, entre em contato com nosso suporte técnico.