Skip to main content

Visão Geral

O Widget de Chat do Kinbox permite que você adicione um chat ao vivo no seu site, permitindo que visitantes iniciem conversas diretamente com sua equipe de atendimento. O widget é totalmente customizável e funciona em qualquer site.

Características

Totalmente Customizável

Personalize cores, textos e aparência

Responsivo

Funciona perfeitamente em desktop e mobile

Rastreamento de Origem

Integra com Google Ads e Meta Ads

Horário Comercial

Indica disponibilidade da equipe

Balão WhatsApp

Opção de redirecionar para WhatsApp

Fácil Instalação

Basta adicionar um script no site

Configuração Inicial

1

Acesse configurações do widget

No Kinbox, vá em Configurações > Widget.
2

Configure aparência

Personalize:
  • Cor principal
  • Cor de fundo
  • Mensagem de boas-vindas
  • Nome de exibição da empresa
  • Imagem/logo (opcional)
3

Configure comportamento

Defina:
  • Posição do widget (direita/esquerda)
  • Mensagem inicial automática
  • Horário de disponibilidade
  • Campos obrigatórios (nome, e-mail, telefone)
4

Copie o código de instalação

O Kinbox gerará um código JavaScript único para seu widget.
5

Instale no seu site

Cole o código antes da tag </body> do seu site:
<script>
  (function(w,d,s,o,f,js,fjs){
    w['KinboxWidget']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  }(window,document,'script','kw','https://widget.kinbox.com.br/widget.js'));
  kw('init', { workspaceId: 'SEU_WORKSPACE_ID' });
</script>
6

Teste o widget

Acesse seu site e teste o funcionamento do chat.

Personalização

Ajustes Visuais

Cores

Personalize as cores do widget para combinar com sua marca:
kw('init', {
  workspaceId: 'SEU_WORKSPACE_ID',
  primaryColor: '#367fee',
  backgroundColor: '#ffffff',
  textColor: '#333333'
});

Logo e Imagem

Adicione o logo da sua empresa no cabeçalho do widget:
  1. Faça upload da imagem em Configurações > Widget > Aparência
  2. A imagem aparecerá no topo do chat
  3. Recomendado: 200x200px, PNG com fundo transparente

Chamada para Ação (CTA)

Personalize a mensagem que aparece antes do visitante abrir o chat:
kw('init', {
  workspaceId: 'SEU_WORKSPACE_ID',
  welcomeMessage: '👋 Olá! Como podemos ajudar?',
  ctaText: 'Iniciar conversa'
});

Nome de Exibição

Defina o nome que aparece no cabeçalho do widget:
  • Nome da empresa
  • Nome do atendente
  • Nome do departamento
Este nome ajuda os visitantes a identificarem com quem estão conversando.

Balão de WhatsApp

Habilite a opção de abrir conversa diretamente no WhatsApp:
1

Ative o recurso

Em Configurações > Widget > Ajustes, marque “Habilitar balão de WhatsApp”.
2

Configure o número

Informe o número de WhatsApp para onde as conversas serão direcionadas.
3

Personalize mensagem

Defina a mensagem pré-preenchida que o visitante verá ao abrir o WhatsApp.
Quando habilitado, visitantes podem escolher entre conversar pelo widget ou WhatsApp.

Horário Comercial

O widget pode indicar se sua equipe está disponível ou não:
1

Configure horários

Vá em Configurações > Horários Comerciais e defina seus horários de atendimento.
2

Ative no widget

Em Configurações > Widget > Ajustes, marque “Considerar horário comercial”.
3

Personalize mensagens

Configure mensagens diferentes para:
  • Horário de atendimento
  • Fora do horário
  • Finais de semana
  • Feriados

Indicador de Disponibilidade

O widget mostra visualmente se o time está disponível:
  • 🟢 Online: “Nosso time está disponível”
  • 🔴 Offline: “Envie uma mensagem, responderemos em breve”

Campos de Formulário

Campos Obrigatórios

Antes de iniciar a conversa, colete informações do visitante:
kw('config', {
  requiredFields: ['name']
});

Campos Personalizados

Colete informações adicionais:
kw('config', {
  customFields: [
    {
      name: 'empresa',
      label: 'Nome da Empresa',
      type: 'text',
      required: true
    },
    {
      name: 'interesse',
      label: 'Interesse em',
      type: 'select',
      options: ['Vendas', 'Suporte', 'Parceria'],
      required: false
    }
  ]
});

Rastreamento de Origem

O widget rastreia automaticamente quando um visitante vem do Google Ads:
  • Captura GCLID
  • Identifica campanha
  • Salva informações no contato
  • Exibe origem nos relatórios
As informações de Google Ads são salvas tanto na sessão quanto no contato permanentemente.

Meta Ads (Facebook/Instagram)

Rastreamento automático de visitantes de anúncios do Facebook/Instagram:
  • Captura FBCLID
  • Identifica campanha
  • Salva informações no contato
  • Permite filtrar relatórios por origem

UTM Parameters

Rastreie qualquer campanha usando parâmetros UTM:
https://seusite.com?utm_source=facebook&utm_medium=cpc&utm_campaign=verao2024
Parâmetros capturados:
  • utm_source
  • utm_medium
  • utm_campaign
  • utm_content
  • utm_term

Integração com Bot

Configure o bot para funcionar no widget:
1

Crie fluxo de bot

Em Configurações > Bot, crie ou edite um bot.
2

Configure gatilho

Defina que o bot deve iniciar em conversas do widget.
3

Qualifique leads

Use o bot para:
  • Coletar informações iniciais
  • Direcionar para departamento correto
  • Responder dúvidas frequentes
  • Agendar reuniões
4

Transfira para humano

Configure quando o bot deve transferir para um operador.

Exemplo de Fluxo

1. Visitante abre widget
2. Bot saúda: "Olá! Sou o assistente virtual. Como posso ajudar?"
3. Visitante escolhe opção:
   a) Vendas → Coleta dados e atribui a vendedor
   b) Suporte → Identifica problema e cria ticket
   c) Falar com humano → Atribui imediatamente a operador disponível
4. Conversa continua com operador ou bot, conforme escolha

API do Widget

Obter Configurações

Recupere as configurações do widget via API:
curl -X GET "https://api4.kinbox.com.br/v3/widget/settings" \
  -H "Authorization: Bearer SEU_TOKEN_API"

Atualizar Configurações

Atualize configurações programaticamente:
curl -X PUT "https://api4.kinbox.com.br/v3/widget/settings" \
  -H "Authorization: Bearer SEU_TOKEN_API" \
  -H "Content-Type: application/json" \
  -d '{
    "primaryColor": "#367fee",
    "welcomeMessage": "Olá! Como posso ajudar?",
    "offlineMessage": "Deixe sua mensagem, responderemos em breve"
  }'

Obter Informações do Widget

Consulte informações sobre o widget:
curl -X GET "https://api4.kinbox.com.br/v3/widget/info" \
  -H "Authorization: Bearer SEU_TOKEN_API"

Funcionalidades Avançadas

Identificar Visitantes

Se você já conhece o visitante (ex: área logada), identifique-o automaticamente:
kw('identify', {
  name: 'João Silva',
  email: '[email protected]',
  phone: '5511999999999',
  customData: {
    userId: '12345',
    plano: 'Premium'
  }
});

Abrir Widget Programaticamente

Abra o widget automaticamente:
// Abrir widget
kw('open');

// Fechar widget
kw('close');

// Toggle (alternar)
kw('toggle');

Enviar Mensagem Pré-Preenchida

Inicie conversa com mensagem específica:
kw('open', {
  message: 'Olá, gostaria de saber mais sobre o plano Premium'
});

Eventos do Widget

Escute eventos do widget:
// Quando widget é aberto
kw('on', 'open', function() {
  console.log('Widget aberto');
  // Analytics, etc
});

// Quando mensagem é enviada
kw('on', 'message', function(message) {
  console.log('Mensagem enviada:', message);
});

// Quando conversa é iniciada
kw('on', 'conversation_started', function(conversation) {
  console.log('Nova conversa:', conversation);
});

Melhorias e Atualizações Recentes

Abril - Maio 2024

Nova funcionalidade de Chat Widget lançada (29/04/2024)
Melhorias diversas e novas funções (02/05/2024)
Opção de ajuste “Habilitar balão de WhatsApp” (03/05/2024)
Nova opção de nome de exibição (01/05/2024)
Considera horário comercial para indicar disponibilidade (01/05/2024)

Setembro 2024

Trackeamento de campanhas do Google Ads pelo WhatsApp no widget
Informações de Google Ads e Meta Ads salvam no contato além da sessão
Novas opções: Personalizar imagem e chamada para ação

Performance e Carregamento

Carregamento Assíncrono

O widget carrega de forma assíncrona, sem afetar a velocidade do seu site:
  • Não bloqueia renderização da página
  • Carrega após conteúdo principal
  • Otimizado para performance

Cache

Configurações do widget são cacheadas para carregamento rápido:
  • Menor consumo de dados
  • Experiência mais rápida
  • Updates automáticos quando necessário

Segurança e Privacidade

LGPD e Conformidade

Informe aos visitantes que você coleta dados
Adicione link para política de privacidade
Permita opt-out de rastreamento
Armazene consentimentos adequadamente

SSL/HTTPS

O widget requer que seu site use HTTPS:
  • Conexão criptografada
  • Dados seguros
  • Conformidade com padrões web

Suporte a Dispositivos

Desktop

  • Todas as funcionalidades disponíveis
  • Interface otimizada para telas grandes
  • Suporte a atalhos de teclado

Mobile

  • Interface adaptada para touch
  • Ocupa tela inteira quando aberto
  • Otimizado para conexões móveis

Tablets

  • Experiência híbrida
  • Adapta-se ao tamanho da tela
  • Suporte a orientação portrait/landscape

Troubleshooting

Verifique:
  1. Código foi instalado corretamente antes de </body>
  2. workspaceId está correto
  3. Não há erros no console do navegador
  4. Site está usando HTTPS
  5. Widget está ativo nas configurações do Kinbox
Teste: Abra o console do navegador (F12) e verifique erros.
Causas comuns:
  • Webhook não está configurado
  • Firewall bloqueando requisições
  • Workspace ID incorreto
  • Canal do widget está desativado
Solução: Verifique logs do widget nas configurações do Kinbox.
Verifique:
  1. URLs de campanha contêm GCLID/FBCLID
  2. Script está carregando antes de capturar parâmetros
  3. Não há bloqueadores de rastreamento ativos
Teste: Adicione ?gclid=test123 à URL e verifique se é capturado.
Soluções:
  1. Limpe cache do navegador
  2. Verifique se salvou as configurações no Kinbox
  3. Aguarde alguns minutos para propagação
  4. Recarregue a página com Ctrl+F5

Boas Práticas

Design

Use cores que contrastam com o fundo do site
Mantenha mensagens de boas-vindas curtas e diretas
Adicione logo para aumentar confiança
Teste em diferentes dispositivos e navegadores

Atendimento

Responda rapidamente - visitantes esperam resposta imediata
Configure bot para respostas fora do horário
Use respostas rápidas para agilizar atendimento
Monitore tempo médio de resposta

Conversão

Use CTAs claros e atrativos
Qualifique leads com bot antes de atribuir a vendedor
Colete informações essenciais no formulário inicial
Integre com CRM para não perder leads

Analytics e Métricas

Acompanhe o desempenho do widget:
  • Conversas iniciadas: Quantos visitantes abriram chat
  • Taxa de conversão: % de visitantes que iniciam conversa
  • Tempo médio de resposta: Rapidez do atendimento
  • Satisfação: Avaliações dos visitantes
  • Origem: De onde vieram os visitantes

Próximos Passos

Configure Automações

Crie bots para atender visitantes 24/7

Integre com CRM

Sincronize leads com seu CRM

Configure Webhooks

Receba eventos de novas conversas

Relatórios

Analise performance do widget

Build docs developers (and LLMs) love