Widget de chat web
O canal Web Chat coloca uma janela de chat no seu site. Os visitantes clicam no botão de chat em um canto da página e escrevem para você. As conversas chegam à caixa de entrada do MonoChat como as de qualquer outro canal, onde sua equipe, seus fluxos e seus agentes de IA respondem.
Conectar o canal
- Acesse Configurações › Chat › Canais e clique em Conectar.
- Selecione Web Chat.
- Preencha as configurações abaixo e salve. Cada campo explica para que serve, e o lado direito do formulário mostra uma prévia da janela que muda conforme você edita. Alterne a prévia entre o botão de chat fechado, a janela aberta e uma conversa de exemplo.
- Copie o snippet que o canal mostra e adicione-o ao seu site (veja Instalar o snippet).
Você pode conectar vários canais Web Chat, por exemplo um por site.
Configurações
| Configuração | O que faz |
|---|---|
| Nome do canal | O nome do canal no MonoChat. A janela o exibe como cabeçalho quando o Título do widget está vazio. |
| Título do widget | O cabeçalho da janela de chat. |
| Subtítulo | Uma linha abaixo do título, por exemplo em quanto tempo você costuma responder. Limpe o campo para ocultar a linha. |
| Logotipo | Uma imagem exibida ao lado do título: um arquivo PNG, JPEG, GIF, SVG ou WebP. |
| Cor | A cor do botão de chat, do cabeçalho e das mensagens do visitante. O texto sobre ela fica preto ou branco para continuar legível. |
| Posição | Canto inferior direito ou inferior esquerdo da página. |
| Anexos | Permite que os visitantes enviem imagens, vídeos, áudios e documentos de até 10 MB. |
| Botão de emoji | Mostra ao lado da caixa de mensagem um botão com os emojis mais comuns. Ativado por padrão. |
| Ocultar o botão | Oculta o botão de chat; você abre a janela pelo seu próprio botão com a API JavaScript. |
| Visualização no celular | Como a janela abre nos celulares: Tela cheia ou Compacta, um painel sobre os três quartos inferiores da página. |
| Domínios permitidos | Os sites em que a janela pode aparecer: um host exato (www.example.com) ou todos os subdomínios (*.example.com), com uma porta opcional (localhost:3000). Se ficar vazio, qualquer site pode exibi-la. |
Idiomas
Os botões e os rótulos da janela seguem o idioma do navegador do visitante e aparecem em inglês quando o MonoChat não tem esse idioma.
O Título do widget, o Subtítulo, a Introdução do formulário e o Texto do consentimento têm uma versão para cada idioma do seu workspace; os idiomas são definidos em Configurações › CRM › Idiomas (veja Configurações de idioma). Clique no campo para escrever cada versão. A janela exibe a versão no idioma do navegador do visitante ou, quando esse idioma não tem uma, a do seu idioma padrão.
Para exibir a janela em um só idioma, seja qual for o navegador, chame MonoChat('setLocale', 'tr-TR') pela API JavaScript.
Formulário pré-chat
Com o formulário desativado, os visitantes começam a escrever na hora. Para pedir um e-mail ou um número de telefone, use um fluxo (veja Os fluxos e o widget).
Com o formulário ativado, a janela pede estes dados antes da primeira mensagem:
| Campo | Opções |
|---|---|
| Nome | Desativado, opcional ou obrigatório |
| Desativado, opcional ou obrigatório | |
| Telefone | Desativado, opcional ou obrigatório |
Você também pode escrever o texto exibido acima dos campos e adicionar uma caixa de consentimento com seu próprio texto e um link para sua política de privacidade. Quando a caixa está ativada, os visitantes precisam marcá-la para iniciar o chat. O nome, o e-mail e o telefone são salvos no perfil do cliente.
Instalar o snippet
O canal mostra um snippet com o endereço do widget e a chave do canal já preenchidos, logo depois que você o conecta e abaixo da prévia quando você edita o canal. Cole-o antes da tag de fechamento </body> de cada página que deve exibir o chat:
<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>
A janela carrega depois da sua página, por isso não a deixa mais lenta.
Se o seu site ainda tem o snippet de um canal WebChat antigo, remova-o e cole no lugar o snippet do novo canal Web Chat.
Modo de página inteira
Para dar ao chat uma página só dele, como uma página de suporte, adicione &mode=fullpage à segunda tag do snippet:
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>
A janela passa a ocupar a página inteira e fica sempre aberta, sem cabeçalho nem botão de chat, e close e toggle não fazem nada. Ela carrega junto com a página, e não depois, e a configuração Visualização no celular não se aplica.
Google Tag Manager
- No seu contêiner, adicione uma tag Custom HTML e cole nela o snippet como está.
- Escolha o acionador All Pages, ou um que dispare só nas páginas que devem exibir o chat.
- Clique em Submit e depois em Publish.
Se os scripts da sua página chamam MonoChat, eles podem rodar antes da tag. Mantenha também na página o primeiro <script> do snippet, para que essas chamadas esperem pela janela.
Criadores de sites e lojas virtuais
Se você não consegue editar o código do seu site, cole o snippet como está no campo que sua plataforma oferece para código em todas as páginas, no fim da página ou no rodapé:
| Plataforma | Onde o snippet entra |
|---|---|
| WordPress | Instale o plugin WPCode e cole o snippet na caixa Footer dele. No WordPress.com, poder adicionar código depende do seu plano. |
| Shopify | Online Store › Edit code: abra theme.liquid e cole o snippet logo antes de </body>. |
| Wix | Settings › Custom Code › Add Custom Code: escolha todas as páginas e Body – end. O site precisa estar publicado e ter um domínio conectado. |
| Squarespace | O campo Footer de Code Injection, nos planos Core, Plus e Advanced. |
| Webflow | Site settings › Custom code › Footer code e, depois, publique o site. |
| ikas | Sales Channel › Extensions › Scripts › Add Script: cole o snippet como conteúdo do script, salve e confira se o script está ativado. |
API JavaScript
O snippet define uma função MonoChat na sua página. Chame-a nos seus próprios scripts, links e botões para controlar a janela. Chamadas feitas antes de a janela carregar aguardam até ela ficar pronta, então você pode fazê-las logo depois do snippet.
Comandos
| Chamada | O que faz |
|---|---|
MonoChat('open') | Abre a janela. |
MonoChat('close') | Fecha a janela. |
MonoChat('toggle') | Abre a janela quando está fechada e a fecha quando está aberta. |
MonoChat('hideLauncher') | Oculta o botão de chat. A janela continua abrindo com open e toggle. |
MonoChat('showLauncher') | Mostra o botão de chat novamente. |
MonoChat('setUser', { name, email, phone }) | Envia o que você já sabe sobre o visitante. Veja Visitantes logados. |
MonoChat('setLocale', 'tr-TR') | Mostra a janela neste idioma, seja qual for o idioma do navegador. Veja Idiomas. |
MonoChat('on', event, callback) | Chama callback sempre que event acontece. Veja Eventos. |
Eventos
| Evento | Quando | callback recebe |
|---|---|---|
ready | A janela carregou. | Nada |
open | A janela abre, pelo botão de chat ou por uma chamada. | Nada |
close | A janela fecha. | Nada |
unread | O número de respostas não lidas muda: chega uma resposta com a janela fechada, ou o visitante a abre. | O número de respostas não lidas |
Registre seus callbacks logo depois do snippet, para não perder o ready.
Visitantes logados
Quando o visitante estiver logado no seu site, envie os dados dele com setUser. Todos os campos são opcionais, e a janela lê apenas name, email e phone.
- O formulário pré-chat é preenchido com eles. Ele é pulado quando já tem tudo o que pede, a menos que a caixa de consentimento esteja ativada: os visitantes sempre a marcam por conta própria.
- Eles são salvos no perfil do cliente no MonoChat, para que sua equipe veja quem está escrevendo.
- Quando o e-mail ou o telefone não é válido, nenhum dos dados é salvo.
Exemplos
Abrir a janela pelo seu próprio botão e ocultar o botão de chat:
<button onclick="MonoChat('open')">Fale conosco</button>
<script>
MonoChat('hideLauncher')
</script>
Enviar um usuário logado e mostrar a janela no idioma da página:
<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>
Mostrar o número de respostas não lidas no seu próprio botão:
<button onclick="MonoChat('open')">Suporte <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>
Enviar um evento para sua ferramenta de analytics quando um visitante abre a janela:
<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>
Conversas
Cada visitante é um cliente no MonoChat, e a conversa fica guardada no navegador dele: um visitante que volta pelo mesmo navegador vê as últimas 200 mensagens, por 90 dias após a última mensagem. Outro navegador ou dispositivo inicia uma nova conversa. As respostas da sua equipe e o indicador de digitação aparecem na janela na hora.
O botão de emoji ao lado da caixa de mensagem oferece os emojis mais comuns. Os visitantes também podem digitar qualquer emoji pelo teclado.
As mensagens que o visitante envia mostram marcações, como no WhatsApp: um tique cinza quando a mensagem é enviada, dois tiques cinza quando ela chega ao MonoChat e dois tiques azuis assim que alguém da sua equipe abre a conversa. No MonoChat, suas respostas aparecem como entregues quando a janela do visitante as recebe e como lidas quando o visitante abre a janela.
Quando a janela está fechada, uma nova resposta mostra o número de mensagens não lidas no botão de chat e toca um som curto. Os navegadores só tocam o som depois que o visitante clica ou digita em algum lugar da página.
Tipos de mensagem
A janela mostra as mensagens como a tela de chat do MonoChat: o nome do agente acima das respostas dele, uma linha com a data onde começa um novo dia e a hora dentro de cada balão, com as marcações nas mensagens do visitante.
Além de texto, emoji e arquivos, suas respostas podem usar os tipos abaixo. Envie-os pelo nó de fluxo Enviar mensagem, por mensagens curtas, apps e funções (veja Tipos de mensagem).
| Tipo | Como a janela o mostra |
|---|---|
| Imagem, vídeo, áudio, figurinha | Dentro do balão. |
| Documento | Um cartão com o tipo e o nome do arquivo, que baixa o arquivo. |
| Respostas rápidas | Botões abaixo da última mensagem. Um clique envia o título do botão como resposta do visitante. |
| Botão | Uma mensagem com um cabeçalho opcional (um texto, uma imagem, um vídeo ou um documento), um rodapé e botões que enviam uma resposta, abrem um endereço web ou ligam para um número de telefone. |
| URL de CTA | Uma mensagem com um botão que abre um endereço web. |
| Lista | As linhas dentro do balão, agrupadas por seção. Um clique em uma linha a envia como resposta do visitante. |
| Carrossel | Cartões que o visitante rola para os lados, cada um com uma imagem ou um vídeo, um título, um subtítulo e botões. |
| Localização | Um marcador com o nome e o endereço do local, que abre o local no Google Maps. |
| Solicitação de localização | Um botão Enviar localização. O navegador pede permissão ao visitante e, em seguida, a localização dele chega ao MonoChat como uma mensagem de localização. |
| Contatos | O nome e a empresa de cada contato, com links que ligam para os números de telefone dele e escrevem para os endereços de e-mail dele. |
As respostas rápidas, os botões de resposta, as linhas da lista e a solicitação de localização funcionam apenas na última mensagem, para que os visitantes não possam responder a uma pergunta antiga.
Ícones dos botões
Os botões que abrem um endereço web podem mostrar um ícone: escolha-o no campo Ícone de uma mensagem URL de CTA ou de um botão URL da web. O campo aparece apenas quando você monta a mensagem para o Web Chat: os outros canais não mostram ícones. Os ícones são Link, Site, WhatsApp, Instagram, Messenger, Facebook, Telegram, TikTok, Telefone, E-mail e Localização; um botão sem ícone mostra o ícone de link.
Os fluxos e o widget
Mensagens de boas-vindas, horário de atendimento, respostas fora do horário, pedir um e-mail ou um telefone e mensagens proativas são configurados com fluxos, não com as configurações do canal.
O evento Ação do cliente recebida inicia um fluxo a partir da janela:
- Widget de chat aberto pela primeira vez: o visitante abre a janela e não tem uma conversa aberta. O MonoChat inicia a conversa, ou reabre a conversa encerrada dele, para que o fluxo possa escrever ao visitante antes que ele escreva. Abrir a janela de novo enquanto a conversa está aberta não o aciona outra vez.
- Widget de chat aberto: o visitante abre a janela, todas as vezes, inclusive a primeira. Um visitante sem uma conversa aberta ganha uma, como acima.
- Widget de chat fechado: o visitante fecha a janela durante uma conversa aberta.
Quando o formulário pré-chat está ativado, a janela conta como aberta depois que o visitante o preenche.
Ver uma página com o widget não aciona nenhum deles. Um visitante que ainda não escreveu só se torna cliente no MonoChat quando um fluxo escuta a ação.
No modo de página inteira, a janela abre com a página, então carregar a página conta como abrir a janela. Cada canal conta no máximo 60 aberturas da janela por minuto; as aberturas além disso não iniciam nenhum fluxo.
Para cumprimentar os visitantes, inicie um fluxo com Ação do cliente recebida definido como Widget de chat aberto pela primeira vez e adicione um nó Enviar mensagem com sua mensagem de boas-vindas. Monte-a com o construtor de mensagens, com botões de resposta, uma lista ou links com ícones.
Powered by MonoChat
A janela mostra uma pequena linha Powered by com o logotipo do MonoChat. Ela não é uma configuração do canal: só pode ser ocultada para uma instalação inteira do MonoChat.