Help Desk: widget e chat ao vivo

Um botão de atendimento no site do órgão ou da empresa: o assistente responde primeiro, um agente assume quando precisa e tudo vira chamado.

O visitante clica no botão do site, conversa com o assistente (a conversa guiada) e, se precisar, fala com um agente on-line. A conversa vira chamado no Help Desk, com a transcrição completa. Quando ninguém está on-line, o visitante deixa um recado e recebe a resposta por e-mail.

Visão geral

Onde encontrar: Help Desk Widget, chat e chatbot (configuração) e Help Desk Chat ao vivo (o dia a dia do agente).

EtapaO que acontece
AssistenteA conversa guiada cumprimenta, mostra botões, sugere artigos da base de conhecimento, coleta dados e pode abrir chamado sozinha.
FilaQuando o visitante pede um atendente, a conversa entra na fila do departamento.
AtendimentoO sistema entrega ao agente on-line com menos conversas (ou o agente pega na fila). Nesse momento o chamado é aberto, com o agente como responsável.
EncerradaA transcrição da conversa vai para o chamado.
Precisa do tempo real. O chat com agentes usa o tempo real do painel (Cadastros Aplicativo e acessibilidade). Sem ele, o widget funciona só com a conversa guiada e o recado, e as telas avisam.

Widget para o site

Cada widget é um botão com aparência e finalidade próprias: um para o portal do cidadão, outro para a intranet dos servidores, outro para a ouvidoria. Você escolhe o departamento, a conversa guiada que atende primeiro, a central de ajuda dos artigos, as cores e os textos.

Lista de widgets com onde aparecem, com o que atendem e a identidade
Aba Widgets: onde cada botão aparece e com o que ele atende.
Formulário do widget com sites permitidos, departamento, conversa guiada, cores e identidade
Editar widget: sites onde ele pode aparecer, departamento, conversa guiada, aparência e identidade.
Sites permitidos. Só os endereços cadastrados (por exemplo https://www.prefeitura.mg.gov.br) conseguem mostrar o chat. Use https://*.prefeitura.mg.gov.br para todos os subdomínios. Endereço com http:// ou com caminho é recusado.

Colar o código

Clique em Código e cole a linha antes do </body> de cada página do site. O botão aparece no canto da tela.

Janela com o código do widget para copiar
O código traz a chave pública do widget e a aparência do botão (cor, texto e lado). Trocar a chave invalida o código antigo.
Site da prefeitura com o botão Fale com a prefeitura no canto
O botão no site do cliente, com o texto e a cor escolhidos.

O chat abre numa janela do Brasmobi dentro do site, isolada dele: o site não lê a conversa e o Brasmobi não executa código do site.

Mudou a cor, o texto ou o lado do botão? Cole o código de novo. A aparência vai no próprio código para que abrir uma página do site não consulte o Brasmobi: o chat só é consultado quando o visitante clica no botão. Um código antigo (só com a chave) continua funcionando e busca a aparência, guardada pelo navegador por 5 minutos.

Identidade do servidor (JWT)

Na intranet, o sistema do órgão pode dizer quem é o servidor logado. Gere o segredo do widget (ele aparece uma vez só) e peça à equipe de TI para assinar um JWT HS256 com os campos sub (matrícula), name, email, aud e exp, entregue ao widget assim:

<script>window.BrasmobiChatConfig = { identidade: "<JWT>", sessao: { matricula: "4521" } };</script>
<script src="https://sistema.brasmobi.com/assets/js/chat_widget.js?v=2" data-brasmobi-chat="<chave>" data-cor="#0B5394" … async></script>
Campo do JWTRegra
aud obrigatórioA chave pública do widget, ou o valor escrito em aud exigido no widget. Pode ser uma lista que contenha esse valor. Sem ele, ou com outro valor, o JWT é recusado — assim um JWT feito para outro sistema não vale aqui.
issConferido só quando o widget tem iss exigido preenchido.
expValidade de no máximo 24 horas.

O agente vê Identidade verificada. Com Exigir identidade, o widget não abre conversa sem um JWT válido. Numa conversa verificada, o nome e o e-mail são os do JWT: o que o visitante digitar no formulário ou no recado não os troca. Se o JWT não trouxe o e-mail e o visitante digitar um, ele vale para a resposta, mas a conversa deixa de aparecer como verificada.

Site do Negócio e loja

Marque Mostrar no Site do Negócio ou Mostrar na loja virtual no widget: o botão aparece nas páginas do seu site e da sua loja no Brasmobi (inclusive no domínio próprio), sem colar código.

Conversas guiadas

A conversa guiada é o assistente sem código: ela atende primeiro e resolve o que for simples. Cada uma tem rascunho e versões publicadas: você edita à vontade e o site só muda quando você publica.

Lista de conversas guiadas com situação e versão no ar
Aba Conversas guiadas: situação, versão no ar e quantos widgets usam cada uma.

Construtor visual

Arraste os blocos no quadro, clique num bloco para editar e escolha para onde cada botão leva. O simulador ao lado testa o rascunho da tela, mesmo sem salvar, sem gravar nada.

Construtor visual com blocos ligados e o editor do bloco
Construtor: blocos ligados por linhas, editor do bloco e simulador.
BlocoO que faz
MensagemMostra um texto e segue.
Pergunta com botõesAté 10 botões, cada um com o seu caminho. Quem digita também é entendido (número da opção, o nome do botão, "sim"/"não" ou parecido).
Coletar dadoPede texto, e-mail, telefone, número, data ou CPF, confere e guarda numa variável.
CondiçãoEscolhe o caminho pelo valor de uma variável (igual, contém, vazia, maior, menor…).
Definir variávelGuarda um valor para usar depois.
Artigo da baseSugere artigos publicados da central de ajuda, com o link.
Resposta com IAA IA escreve a resposta usando só os artigos publicados da central do widget, com os links. Sem resposta, mostra o texto de falha. Veja Resposta com IA.
Abrir chamadoAbre o chamado e mostra o protocolo (precisa do e-mail: colete antes).
Transferir para atendentePassa para a fila do departamento. Sem agente, pede recado.
FimDespede e encerra.
Dica: em qualquer pergunta, se o visitante escrever "quero falar com um atendente", ele vai para a fila.

Valores e variáveis

Os textos aceitam marcadores trocados na hora:

MarcadorDe onde vem
{{global.horario}}Valores globais (aba Valores globais) — mude num lugar e todos os fluxos mostram o novo.
{{email}}, {{assunto}}Variáveis da conversa (coletadas ou definidas nos blocos). Vazia, vale o valor predefinido do fluxo.
{{sessao.matricula}}Variáveis que o site passa ao widget e que valem até fechar o navegador.
{{visitante.nome}}, {{mensagem_inicial}}, {{protocolo}}Nome digitado, primeira mensagem e o protocolo do chamado aberto.
Aba de valores globais com horário e telefone
Valores globais do suporte.

Resposta com IA

O bloco Resposta com IA manda a pergunta do visitante à IA junto com os artigos publicados e públicos da central de ajuda do widget, e a IA responde só com o que está neles (com o link dos artigos usados). Ela não inventa: sem artigo que responda, o visitante vê o texto de falha do bloco e segue o fluxo (por exemplo, para um atendente).

  • Desligada por padrão. Ligue Resposta com IA no assistente no widget; a IA também precisa estar ligada na Base de conhecimento. Com o interruptor desligado, o bloco mostra o texto de falha sem chamar a IA.
  • Limites (Configurações › Chat ao vivo): respostas por conversa, por rede (endereço de internet) por hora e por dia do negócio. O uso conta no limite de IA do plano e pode usar a chave própria de IA do negócio.
  • A conferência anti-robô do widget vale antes de qualquer resposta. No simulador a IA não é chamada.

Uso do fluxo

O botão Uso mostra, nos últimos 30 dias, quantas conversas passaram pelo fluxo, quantas estão ativas agora, quantas foram para um atendente, quantas terminaram no assistente, os chamados abertos, as passagens por bloco e as rotas mais comuns.

Console do agente

Em Help Desk Chat ao vivo o agente vê a fila do departamento, as conversas dele e quem da equipe está on-line.

On-line, ausente e tempo ocioso

Escolha On-line para receber conversas. Ausente e Off-line não recebem. Se você ficar sem usar o sistema além do tempo ocioso configurado (ou fechar o navegador), o sistema passa você para off-line e para de mandar conversas.

Console com a situação On-line, a fila e os agentes agora
Console: situação, fila, minhas conversas e agentes agora.

Atender uma conversa

A conversa nova chega sozinha em Minhas conversas. O agente vê o que o assistente já conversou e os dados coletados, e o visitante vê "está digitando" enquanto o agente escreve (e vice-versa).

Conversa aberta no console do agente
A mesma conversa no widget do site
A mesma conversa no console e no site do cliente.
Formulário do widget com nome, e-mail e mensagem
Assistente com botões de assunto
O visitante começa pelo formulário e o assistente responde com botões.
Assistente sugerindo um artigo da base de conhecimento
Artigo da base de conhecimento sugerido pelo assistente.

Também dá para responder pelo próprio chamado: enquanto a conversa está aberta, a resposta pública chega ao visitante no chat.

Transferir e encerrar

Transferir manda a conversa para outro agente disponível ou para outro departamento; o chamado acompanha. Encerrar termina a conversa e grava a transcrição no chamado.

Janela de transferir com agentes e departamentos
Transferir: agentes disponíveis (com quantas conversas cada um tem) e departamentos.
Widget com a conversa encerrada e o protocolo
Chamado com a aba Chat mostrando a conversa
O visitante recebe o protocolo; no chamado, a aba Chat guarda a conversa inteira.

Ver a tela do visitante

Com o compartilhamento ligado, o agente clica em Ver a tela. O visitante recebe um pedido claro e escolhe se mostra uma janela, uma aba ou a tela inteira. A imagem vai direto do navegador do visitante para o do agente: nada é gravado e o visitante para quando quiser.

Widget pedindo consentimento para mostrar a tela
Console mostrando a tela do visitante
Consentimento no widget e a tela do visitante no console.
Rede que bloqueia. Algumas redes corporativas não deixam a conexão direta. Nesse caso o console avisa e o botão Sala de vídeo manda ao visitante o link de uma sala Jitsi, com vídeo e compartilhamento de tela. O endereço do Jitsi é configurável, mas só com https e num domínio liberado pela Brasmobi (o padrão é meet.jit.si; servidor próprio do órgão: peça ao suporte para liberar o domínio).

Sem agente: recado

Quando não há agente on-line no departamento, o widget pede um recado com o e-mail. O recado vira chamado com protocolo e a resposta do agente chega por e-mail. Quem espera muito tempo na fila também pode deixar recado.

Widget pedindo o recado e o e-mail
Recado: nome, e-mail para a resposta e a mensagem.

Configurações do chat

Aba Chat ao vivo com distribuição, limites, mensagens, tela e anti-robô
Aba Chat ao vivo.
CampoO que controla
Chat ao vivo ligado essencialSem ele, o widget atende só com a conversa guiada e o recado.
Distribuição da filaAutomática (o agente livre com menos conversas recebe) ou manual (o agente pega na fila).
Conversas ao mesmo tempoLimite por agente. Cada agente pode ter um limite próprio na aba Agentes.
Minutos sem uso para ficar off-lineTempo ocioso que tira o agente do ar.
Sem agente disponívelPedir recado ou esperar na fila (com a opção de recado depois de alguns minutos).
Minutos sem mensagem para encerrarConversa parada é encerrada e a transcrição vai ao chamado.
Transcrição públicaLigado: o solicitante recebe a transcrição no portal e por e-mail. Desligado: vira nota interna.
Ver a tela / STUN / JitsiCompartilhamento de tela pelo navegador e a sala de vídeo alternativa.
Dificuldade anti-robôTrabalho que o navegador faz antes de abrir a conversa (16 = cerca de meio segundo).
Conversas novas por rede por horaLimite por endereço de internet contra abuso.
Resposta com IA: por conversa, por rede por hora, por diaTetos de respostas escritas pela IA nos widgets com a IA ligada (0 = sem limite próprio; o limite de IA do plano continua valendo).

O limite de conversas ao mesmo tempo vale também quando o agente aceita duas conversas no mesmo instante, quando a fila distribui e quando alguém transfere: a conferência e a troca de dono acontecem juntas, então o limite nunca é passado.

Chamados para quem está on-line

No cadastro do departamento (Help Desk › Configurações › Departamentos), a atribuição Disponibilidade (agentes on-line no chat, menos chamados abertos) entrega cada chamado novo ao agente do departamento que está on-line no chat e com menos chamados abertos ou pendentes (empate: o cadastrado primeiro). Sem ninguém on-line, o chamado fica com a equipe, sem responsável.

Nenhum departamento muda sozinho: escolha esse modo só onde fizer sentido.

Segurança

  • O chat roda numa janela do Brasmobi isolada do site; só os sites cadastrados conseguem mostrá-la.
  • Cada conversa tem uma chave própria com validade; ninguém lê a conversa de outra pessoa.
  • Contra robôs: uma conferência automática no navegador e limite de conversas por rede.
  • A janela do chat só aceita mensagens do site que a mostra, conferido pelo navegador; sem essa origem, a conversa não começa.
  • O recado só é aceito quando o próprio widget o oferece (sem agente, ou depois da espera configurada).
  • Configurações de widget, conversas guiadas, valores globais e transferências ficam na trilha de auditoria.
  • O compartilhamento de tela só acontece com o aceite do visitante e não é gravado.

Perguntas frequentes

Sim. No celular o chat ocupa a tela inteira; o console do agente também funciona no celular.
Widget em tela cheia no celular
Console do agente no celular

Quando um agente assume a conversa, quando o visitante deixa recado e quando a conversa guiada usa o bloco "Abrir chamado". Quem desistiu na fila e deixou e-mail também ganha um chamado, para alguém retornar. Conversa resolvida só pelo assistente não abre chamado.

Sim. Escolha a mesma conversa guiada em quantos widgets quiser.

O site usa a versão publicada. Clique em Publicar no construtor para pôr o rascunho no ar.