O widget de chat no site

O widget de chat no site

O widget de chat no site é um balãozinho de chat que você coloca em qualquer página da web com uma única tag <script>. Os visitantes conversam com a sua IA; quando uma pessoa assume, as respostas dela aparecem no mesmo balãozinho — ao vivo.

Adicionando ao seu site

Cole o trecho de código logo antes da sua tag </body> de fechamento:

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here"></script>

O widget carrega no próprio frame, então não entra em conflito com os estilos nem com os scripts do seu site.

Opções

Atributo O que faz
data-key Obrigatório. A widget key do seu desk, que está nas Settings.
data-position right (padrão) ou left — em que canto o balãozinho fica.
data-offset Pixels a partir do canto (padrão 20).
data-lang Fixa o idioma do widget, por exemplo ja. Deixe de fora e cada visitante vê o idioma do próprio navegador.

Se a sua página mostra um selo do reCAPTCHA no mesmo canto, o widget sobe automaticamente acima dele para que os dois não se sobreponham.

Em que idioma o widget fala

Se você não mexer, o widget segue o idioma do navegador de cada visitante. Um visitante japonês num site em inglês recebe o balãozinho em japonês; não há nada para configurar, e visitantes diferentes numa mesma página podem ver idiomas diferentes.

Para fixar um único idioma — o caso de um site que atende um mercado só, não importa quem esteja lendo — acrescente o data-lang:

<script src="https://blz.actionbridge.io/support/widget.js" data-key="wk_your_key_here" data-lang="ja"></script>

Traduzidos hoje: inglês e japonês. Qualquer outro valor cai para o inglês em vez de mostrar um balãozinho traduzido pela metade, então data-lang="de" te dá inglês até que o alemão seja acrescentado.

O mesmo vale para o formulário web hospedado por nós: acrescente ?lang=ja ao endereço dele para fixar o idioma, ou deixe de fora para seguir o visitante.

Usando o seu próprio ícone de balão

Por padrão, o botão no seu site é o nosso balãozinho azul-petróleo com um ícone de balão de fala (💬). Você pode substituí-lo por um PNG seu para que o widget pareça parte do seu site. A imagem que você envia vira o botão inteiro: ela preenche todo o botão de 56 pixels, e a nossa bolinha azul-petróleo deixa de ser desenhada atrás dela.

  1. Abra as Settings do seu desk. Vá até a seção Web chat e encontre Chat bubble icon.
  2. Clique em Upload PNG e escolha o seu arquivo. O balãozinho de pré-visualização ao lado do botão mostra exatamente como ele vai ficar.
  3. Mudou de ideia? O Reset to default devolve o nosso ícone de balão de fala.
Imagem O que funciona
Formato de arquivo PNG
Tamanho recomendado Quadrada, de no mínimo 112×112 pixels
Tamanho exibido Preenche o botão inteiro, 56×56 pixels
Forma Definida pela própria imagem — um fundo transparente é fortemente recomendado
Tamanho do arquivo 256 KB no máximo

O botão é desenhado a 56×56 pixels, então um original de 112×112 (ou maior) mantém a sua marca nítida em telas de alta resolução. Uma sombra sutil é acrescentada por nós e acompanha o contorno da sua arte, então não é preciso embutir uma no PNG.

O ícone é a única parte do botão que você pode mudar — a cor do nosso balãozinho padrão não é configurável. Na prática isso pesa menos do que parece: como a nossa bolinha não é mais desenhada atrás da sua imagem, um PNG transparente faz com que a cor que os visitantes veem seja a cor da sua própria arte.

O que o visitante vê

  1. Ele abre o balãozinho e deixa nome, e-mail e uma primeira mensagem.
  2. A IA responde a partir do seu conhecimento, com as fontes, ali mesmo no chat — sem esperar por ninguém da sua equipe.
  3. Uma pessoa pode assumir — a resposta dela aparece no mesmo chat em poucos segundos.

O e-mail que ele deixa é por onde ele é reconhecido na próxima vez — veja seu cadastro de clientes.

O chat no site é um dos cinco caminhos de entrada — veja como os clientes falam com você e como um ticket funciona depois que uma conversa começa.

Publicado em 2026-09-22
Versão 2