Alerta de atendimento e mensagem nova — Tiledesk Proxxima

Notificação do Chrome e som quando cai um atendimento novo para você, ou quando chega mensagem nova numa conversa que já é sua.

Instalação

  1. Instale a extensão Tampermonkey pela Chrome Web Store.
  2. Libere os scripts de usuário no Chrome. Sem este passo o Tampermonkey aparece instalado e o script aparece ligado, mas nada roda — é a causa mais comum de o alerta não funcionar.
    Como fazer: abra chrome://extensions → ligue o Modo do desenvolvedor (canto superior direito) → no cartão do Tampermonkey clique em Detalhes → ligue Permitir Scripts de Usuário.
    Feche e abra o Chrome depois.
    Se ao clicar no ícone do Tampermonkey aparecer a faixa azul "Por favor, habilite a opção 'Permitir Scripts de Usuário'", é exatamente disso que se trata.
  3. Clique no botão abaixo e confirme Instalar.

    Instalar o script
  4. Abra o chat do Tiledesk e clique em Permitir quando o Chrome pedir a permissão de notificação.

Como conferir se está funcionando

No canto inferior esquerdo do chat aparece um selo. Ele diz o estado em uma olhada:

SeloO que significaO que fazer
verde
"alerta ativo v1.8.8 - verificado 14:33:24"
Rodando, com a versão do script e o horário da última verificação. Nada. Clique nele para ouvir um teste.
azul Falta liberar a notificação. Clique no selo e depois em Permitir.
vermelho Notificação bloqueada para o site. Clique no selo — ele explica como reverter pelo cadeado da barra de endereço.
nenhum selo O script não está rodando. Volte ao passo 2 desta página.

Se o som toca mas a notificação não aparece

O som tocar significa que o script funcionou. O que faltou foi a notificação do sistema. Olhe a cor do selo:

De todo modo, a partir da versão 1.3 o aviso não depende mais só disso: além do som, aparece uma faixa azul no alto da página e o título da aba fica piscando 🔔 Novo atendimento! — o que é visível mesmo com a aba em segundo plano.

Limite

O aviso funciona com a aba em segundo plano e a janela minimizada. Com o Chrome fechado não há como avisar — nesse caso vale o e-mail de "conversa atribuída", que o Tiledesk já envia.

Se o Chrome estiver com a Economia de memória ligada, ele pode desligar a aba do Tiledesk depois de um tempo sem uso, e aí nada roda até você clicar nela. Para evitar: chrome://settings/performance → Sempre manter estes sites ativos → Adicionar → tiledesk.proxxima.net.

O script usa a sessão que você já tem aberta no Tiledesk. Nenhuma senha ou credencial fica guardada aqui. Ele consulta apenas os atendimentos atribuídos a você, a cada 15 segundos.

O que mudou na versão 1.4

Além do alerta, o script agora conserta a rolagem do histórico da conversa. Antes, ao abrir um atendimento antigo as mensagens anteriores não subiam e só aparecia barra de rolagem se você diminuísse a tela. Quem já tem o script instalado recebe a correção sozinho, sem fazer nada — pode levar algumas horas ou é só recarregar a página do Tiledesk.

O que mudou na versão 1.5

Chegaram as pausas. Clique na sua foto, no canto superior esquerdo, e logo abaixo do seletor de status aparecem dois botões: Pausa almoço (amarelo) e Pausa 10 minutos (laranja).

Ao escolher uma pausa você fica indisponível de verdade — para de receber conversa nova — e uma tarja colorida com o cronômetro fica visível na tela até você clicar em Voltar. Início e fim ficam registrados, então a coordenação consegue ver quanto tempo cada um passou em cada pausa.

Se você fechar o navegador esquecendo a pausa aberta, ela é encerrada sozinha no fim do dia. E se voltar o status para acessível pelo seletor de sempre, a pausa encerra junto.

Esta versão também corrige um problema silencioso: o navegador guarda mais de um token do Tiledesk, e um deles é o token do widget, que não serve para a API. Quando o script pegava esse, o alerta parava de funcionar sem avisar ninguém. Agora ele testa e escolhe o token certo sozinho.

O que mudou na versão 1.6

Até aqui o alerta só disparava na primeira vez que uma conversa caía para você. Se o cliente mandasse uma mensagem nova depois — mesmo horas depois, na mesma conversa — não vinha aviso nenhum, porque para o script aquela conversa já era "conhecida". Agora ele também acompanha cada conversa já atribuída a você e, quando percebe atividade nova nela, confere se a última mensagem é mesmo do cliente (nunca conta como aviso quando quem respondeu por último foi você) antes de repetir o som, a faixa na página e a notificação — dessa vez com o texto "Nova mensagem" em vez de "Novo atendimento".

O que mudou na versão 1.7

Imagem e PDF agora chegam no WhatsApp do cliente. Antes, a imagem enviada pelo clipe do chat aparecia como enviada na sua tela, mas o cliente não recebia nada — o chat montava o link do arquivo pela metade (/api/images?..., sem o endereço do servidor) e o WhatsApp não tinha de onde baixar. O script corrige esse endereço assim que o chat abre.

O PDF também foi liberado: até aqui o clipe só aceitava imagem e mostrava o aviso de que só imagens eram permitidas.

Para valer, recarregue a página do chat (F5) depois que o script atualizar — o chat só lê esse endereço na abertura.

O que mudou na versão 1.7.1

Anexo no bate-papo direto. Na conversa entre colegas (bate-papo direto) o clipe não fazia nada: você escolhia a imagem ou o PDF e a prévia nem abria. Agora abre e envia normalmente.

O selo do canto inferior esquerdo passou a mostrar a versão (ex.: alerta ativo v1.8.0). Se aparecer uma versão menor que a última desta página, o seu script ainda não atualizou — veja abaixo.

O que mudou na versão 1.8

Mensagem de áudio. Ao lado do clipe e do emoji apareceu um microfone. Clique nele para começar a gravar (na primeira vez o Chrome pede permissão para usar o microfone — clique em Permitir). Enquanto grava aparece o tempo em vermelho e dois botões: ✓ para parar e enviar, ✕ para descartar. A gravação para sozinha em 5 minutos.

Vale a mesma regra do WhatsApp para qualquer mensagem: só dá para enviar dentro das 24 horas depois da última mensagem do cliente.

O que mudou na versão 1.8.8

Mensagens aparecem sem precisar atualizar a página. Com a aba do chat em segundo plano (você em outro sistema, ou a janela minimizada), o Chrome economiza energia e atrasa o chat, e a conexão em tempo real com o servidor caía. As mensagens que chegavam nesse intervalo não apareciam na tela, e só um F5 trazia de volta. Agora, quando a conexão volta, ou quando você volta para a aba, o script busca sozinho as mensagens e conversas que faltaram e coloca na tela, sem duplicar nada.

Se você voltar para a aba e a mensagem ainda não estiver lá, espere 2 ou 3 segundos antes de recarregar: é o tempo de reconectar e buscar o que faltou.

O que mudou na versão 1.8.7

Barra de rolagem na lista de conversas. A coluna da esquerda do chat (bate-papo direto e atendimentos) rolava só com a roda do mouse, porque o chat escondia a barra. Sem roda, não dava para chegar nas conversas mais antigas. Agora aparece uma barra fina à direita da lista, que dá para arrastar.

O que mudou na versão 1.8.6

Aviso de mensagem nova do cliente na hora. Alguns atendentes viam a mensagem chegar, mas o aviso só vinha depois de abrir o chat e recarregar a página. O motivo: o script percebia mensagem nova pela "data de atualização" da conversa, e o servidor não muda essa data quando o cliente escreve — às vezes ela ficava horas atrasada. Agora o script lê a mesma lista de conversas que o chat mostra à esquerda, que traz o horário e o autor da última mensagem, e avisa em até 15 segundos.

Com a aba em segundo plano há bastante tempo, o próprio Chrome pode atrasar o aviso em até 1 minuto. Isso é economia de energia do navegador, não defeito.

O que mudou na versão 1.8.5

Cada atendente vê só as próprias conversas no painel. No Histórico, na exportação em CSV e na ficha do contato aparecem apenas as conversas em que você participou. Se alguém abrir pelo link uma conversa que já é de outro atendente, a tela fica coberta com o aviso "Esta conversa é de outro atendente" e volta para a tela anterior. Conversas ainda sem atendente (na fila) continuam visíveis. Supervisores (administradores) e proprietários continuam vendo tudo.

Junto com esta versão, o e-mail de "conversa não atribuída", que ia para todos os atendentes a cada lead que ficava na fila, foi desligado no projeto. Cada um continua recebendo o e-mail apenas das conversas atribuídas a ele.

O que mudou na versão 1.8.4

Registro das pausas. O início e o fim das pausas voltaram a chegar na planilha da coordenação: o envio passou a ser feito pelo próprio Tampermonkey, porque o navegador bloqueava em silêncio o envio feito de dentro da página do Tiledesk. Ao atualizar, o Tampermonkey pode pedir para você confirmar a permissão de acesso a script.google.com — é esse envio.

O que mudou na versão 1.8.3

Aviso de mensagem no bate-papo direto. Até aqui o alerta só avisava sobre atendimentos de cliente. Mensagem de colega ou do supervisor no bate-papo direto (e em grupo interno) chegava sem som e sem notificação. Agora chega com os mesmos avisos: som, faixa azul na página, título da aba piscando e notificação do Chrome "Mensagem de Fulano" com o texto. Clicar na notificação abre a conversa. Se você já estiver com aquela conversa aberta na tela, não toca. Se chegarem muitas de uma vez (por exemplo, ao abrir o chat de manhã), vem um aviso só com a quantidade.

O que mudou na versão 1.8.2

Respostas predefinidas no bate-papo direto. Na conversa entre colegas o raio (Respostas predefinidas) ficava apagado. Agora ele abre uma lista com as respostas do projeto, com busca pelo título ou pelo texto (setas ↑ ↓ e Enter também funcionam). A resposta escolhida vai para o campo de mensagem — confira e envie como sempre. Nas conversas de cliente nada muda: o raio já funcionava (ou digite / no campo de mensagem).

O que mudou na versão 1.8.1

O próprio selo avisa quando há versão nova. Se o seu script estiver desatualizado, o selo do canto inferior esquerdo fica laranja com "atualizacao disponivel ... clique aqui". Clique nele e depois em Atualizar na página do Tampermonkey que abrir; em seguida, F5 no chat. A biblioteca usada para gerar o MP3 do áudio passou a vir deste mesmo site, para não depender de outro endereço.

Como atualizar na hora

Jeito que sempre funciona (use este quando um computador "não atualiza"):

  1. No Chrome do atendente, abra esta página e clique no botão azul Instalar o script lá em cima.
  2. Abre a página do Tampermonkey mostrando a versão instalada e a nova. Clique em Atualizar (se aparecer Reinstalar, a versão já é a mais nova).
  3. Recarregue a página do chat (F5) e confira a versão no selo.

Atalho pelo menu: ícone do Tampermonkey → Verificar atualizações de userscript. Esse atalho às vezes não encontra a versão nova; nesse caso use o jeito acima.

Se mesmo assim não atualizar

O que apareceO que fazer
Ao clicar em Instalar o script aparece um texto cheio de código em vez da página do Tampermonkey O Tampermonkey não está ativo nesse Chrome. Confira em chrome://extensions se ele está ligado e com Permitir Scripts de Usuário ativado (passo 2 da instalação).
Abre uma página do site tampermonkey.net escrita "SCRIPT INSTALLATION — This page is used as an intermediate step..." e fica parada nela É um defeito conhecido do Tampermonkey nas versões novas do Chrome. Tente nesta ordem:
  1. Em chrome://extensions, desligue e ligue o Tampermonkey e repita o passo 1.
  2. Ícone do Tampermonkey → Painel → aba Utilitários → campo Instalar a partir de URL (Install from URL) → cole https://alerta-tiledesk.pages.dev/alerta-tiledesk.user.js → Instalar → Atualizar.
  3. Se ainda travar: abra o código do script em texto, copie tudo (Ctrl+A, Ctrl+C); no Painel do Tampermonkey clique no nome Alerta Tiledesk - Proxxima, apague todo o texto do editor (Ctrl+A, Delete), cole (Ctrl+V) e salve (Ctrl+S).
Depois, F5 no chat e confira a versão no selo.
Selo vermelho dizendo "alerta instalado 2 vezes", ou dois scripts "Alerta Tiledesk" no painel do Tampermonkey Apague o mais antigo no painel do Tampermonkey (ícone da lixeira) e recarregue o chat.
Atualizou, mas o selo continua com a versão antiga Faltou recarregar a página do chat (F5). Se tiver mais de uma aba do chat aberta, recarregue todas.
A página do Tampermonkey mostra erro ao baixar A rede desse computador está bloqueando alerta-tiledesk.pages.dev. Precisa liberar esse endereço no firewall/antivírus.

Imagem ou PDF enviados antes da atualização não são corrigidos depois: se o cliente não recebeu, envie de novo.