Pular para o conteúdo principal

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​

  1. Acesse Configurações › Chat › Canais e clique em Conectar.
  2. Selecione Web Chat.
  3. 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.
  4. 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çãoO que faz
Nome do canalO nome do canal no MonoChat. A janela o exibe como cabeçalho quando o Título do widget está vazio.
Título do widgetO cabeçalho da janela de chat.
SubtítuloUma linha abaixo do título, por exemplo em quanto tempo você costuma responder. Limpe o campo para ocultar a linha.
LogotipoUma imagem exibida ao lado do título: um arquivo PNG, JPEG, GIF, SVG ou WebP.
CorA 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çãoCanto inferior direito ou inferior esquerdo da página.
AnexosPermite que os visitantes enviem imagens, vídeos, áudios e documentos de até 10 MB.
Botão de emojiMostra ao lado da caixa de mensagem um botão com os emojis mais comuns. Ativado por padrão.
Ocultar o botãoOculta o botão de chat; você abre a janela pelo seu próprio botão com a API JavaScript.
Visualização no celularComo a janela abre nos celulares: Tela cheia ou Compacta, um painel sobre os três quartos inferiores da página.
Domínios permitidosOs 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:

CampoOpções
NomeDesativado, opcional ou obrigatório
E-mailDesativado, opcional ou obrigatório
TelefoneDesativado, 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.

Migrar do WebChat antigo

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​

  1. No seu contêiner, adicione uma tag Custom HTML e cole nela o snippet como está.
  2. Escolha o acionador All Pages, ou um que dispare só nas páginas que devem exibir o chat.
  3. 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é:

PlataformaOnde o snippet entra
WordPressInstale o plugin WPCode e cole o snippet na caixa Footer dele. No WordPress.com, poder adicionar código depende do seu plano.
ShopifyOnline Store › Edit code: abra theme.liquid e cole o snippet logo antes de </body>.
WixSettings › Custom Code › Add Custom Code: escolha todas as páginas e Body – end. O site precisa estar publicado e ter um domínio conectado.
SquarespaceO campo Footer de Code Injection, nos planos Core, Plus e Advanced.
WebflowSite settings › Custom code › Footer code e, depois, publique o site.
ikasSales 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​

ChamadaO 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​

EventoQuandocallback recebe
readyA janela carregou.Nada
openA janela abre, pelo botão de chat ou por uma chamada.Nada
closeA janela fecha.Nada
unreadO 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).

TipoComo a janela o mostra
Imagem, vídeo, áudio, figurinhaDentro do balão.
DocumentoUm cartão com o tipo e o nome do arquivo, que baixa o arquivo.
Respostas rápidasBotões abaixo da última mensagem. Um clique envia o título do botão como resposta do visitante.
BotãoUma 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 CTAUma mensagem com um botão que abre um endereço web.
ListaAs linhas dentro do balão, agrupadas por seção. Um clique em uma linha a envia como resposta do visitante.
CarrosselCartõ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çãoUm marcador com o nome e o endereço do local, que abre o local no Google Maps.
Solicitação de localizaçãoUm 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.
ContatosO 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.