Temas

Chat web

O que é o Chat web, onde ele abre, o que você pode personalizar, como é instalado e o que acontece ao pausá-lo ou excluí-lo.

Revisado em 24 de out. de 2026
Nesta página

O que é

O Chat web, se você o vê em Canais, é uma janela de chat no seu site, atendida pelo mesmo vendedor dos seus outros canais. Não tem prazo para responder, e as conversas contam como sessões do seu plano.

Onde ele abre

O chat só abre nos endereços da sua lista, até 20. Cada um começa com https:// e não leva caminhos, asteriscos nem endereços IP; a versão com www e a sem www são endereços diferentes.

Aparência

No Chat web você escolhe a saudação (até 500 caracteres), até 5 perguntas sugeridas de 100 caracteres, a cor, se o botão fica embaixo à esquerda ou à direita, e o idioma: espanhol, português ou inglês. As mudanças chegam ao seu site em menos de um minuto.

Se você não adiciona perguntas sugeridas próprias, o Chat web mostra três: Quais produtos vocês têm?, Quanto custa o frete? e Onde fica a loja?, no idioma do chat. Assim que você adiciona uma sua, aparecem só as suas.

Instalação

O Chat web, se você o vê em Canais, é instalado com um código que vai no seu site, antes do fechamento da página; o painel tem guias para Shopify, WordPress, Wix, Tiendanube e qualquer site HTML. No Meu site yavendió! ele é ativado com um clique, sem colar nada.

O status do Chat web é Ativo, Pausado, Ainda não instalado ou Instalado em X de Y endereços. Cada endereço passa a Detectado na primeira vez que alguém abre o chat nesse site.

Código de instalação

O código que o painel entrega carrega o chat a partir de chat.ya.onl:

<script
  async
  src="https://chat.ya.onl/v1/loader.js"
  data-widget="SUA_CHAVE"
  data-lang="pt"
></script>
Atributo Valor
data-widget A chave do seu Chat web. Muda se você trocar a chave.
data-lang Idioma do chat: es, pt ou en.
data-position Só aparece com left, se o botão fica embaixo à esquerda. Sem ele, fica à direita.

Atributos opcionais

O código do painel traz data-widget e data-lang (e data-position se você escolheu a esquerda). Estes são adicionados à mão na mesma tag:

Atributo O que faz
data-color Cor do botão, em #rgb ou #rrggbb. O ícone fica branco ou preto, o que tiver melhor contraste.
data-label Texto ao lado do ícone, até 40 caracteres. O botão passa de redondo a pílula.
data-z-index Nível de camada do botão e do chat, de 0 a 2147483647 (o máximo, padrão). Diminua se as janelas do seu site devem cobrir o chat.

Avisos no console do navegador

Mensagem O que significa
ya-webchat: the chat could not load on this page… Esse site não está nos seus Endereços.
missing data-widget on the loader <script>… Falta a chave no código.
ignoring data-color / data-z-index… O valor não é válido e é ignorado.

Sites com política de segurança (CSP)

Se o seu site define a própria política de segurança de conteúdo (Content-Security-Policy), adicione chat.ya.onl nestas duas diretivas. Não precisa de connect-src: o chat se comunica a partir da própria janela.

Content-Security-Policy:
  script-src https://chat.ya.onl;
  frame-src https://chat.ya.onl;

Tiendanube e Shopify não trazem uma política que bloqueie o chat, e Wix e WordPress não trazem nenhuma.

Quem escreve

Quem escreve pelo Chat web chega sem nome nem telefone: seu vendedor pede os dados de que precisa para o pedido. Como o visitante pode fechar a página, o vendedor responde tudo na mesma mensagem.

Pausar, excluir ou trocar a chave

Pausar o Chat web faz o botão parar de abrir em menos de um minuto, e ele volta a ligar com um clique. Excluí-lo apaga a configuração, o código instalado para de funcionar e ele também sai do Meu site. Trocar a chave faz o código instalado parar de funcionar em um minuto, até você colar o novo.

Este artigo ajudou?

Relacionados

Precisa de ajuda?