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
Configure aparência
Personalize:
- Cor principal
- Cor de fundo
- Mensagem de boas-vindas
- Nome de exibição da empresa
- Imagem/logo (opcional)
Configure comportamento
Defina:
- Posição do widget (direita/esquerda)
- Mensagem inicial automática
- Horário de disponibilidade
- Campos obrigatórios (nome, e-mail, telefone)
Personalização
Ajustes Visuais
Cores
Personalize as cores do widget para combinar com sua marca:Logo e Imagem
Adicione o logo da sua empresa no cabeçalho do widget:- Faça upload da imagem em Configurações > Widget > Aparência
- A imagem aparecerá no topo do chat
- Recomendado: 200x200px, PNG com fundo transparente
Chamada para Ação (CTA)
Personalize a mensagem que aparece antes do visitante abrir o chat:Nome de Exibição
Defina o nome que aparece no cabeçalho do widget:- Nome da empresa
- Nome do atendente
- Nome do departamento
Balão de WhatsApp
Habilite a opção de abrir conversa diretamente no 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: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:- Nome
- E-mail
- Telefone
- Todos
Campos Personalizados
Colete informações adicionais:Rastreamento de Origem
Google Ads
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:- utm_source
- utm_medium
- utm_campaign
- utm_content
- utm_term
Integração com Bot
Configure o bot para funcionar no widget:Qualifique leads
Use o bot para:
- Coletar informações iniciais
- Direcionar para departamento correto
- Responder dúvidas frequentes
- Agendar reuniões
Exemplo de Fluxo
API do Widget
Obter Configurações
Recupere as configurações do widget via API:Atualizar Configurações
Atualize configurações programaticamente:Obter Informações do Widget
Consulte informações sobre o widget:Funcionalidades Avançadas
Identificar Visitantes
Se você já conhece o visitante (ex: área logada), identifique-o automaticamente:Abrir Widget Programaticamente
Abra o widget automaticamente:Enviar Mensagem Pré-Preenchida
Inicie conversa com mensagem específica:Eventos do Widget
Escute eventos do widget: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
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
Widget não aparece no site
Widget não aparece no site
Verifique:
- Código foi instalado corretamente antes de
</body> - workspaceId está correto
- Não há erros no console do navegador
- Site está usando HTTPS
- Widget está ativo nas configurações do Kinbox
Mensagens não chegam no Kinbox
Mensagens não chegam no Kinbox
Causas comuns:
- Webhook não está configurado
- Firewall bloqueando requisições
- Workspace ID incorreto
- Canal do widget está desativado
Rastreamento de Google/Meta Ads não funciona
Rastreamento de Google/Meta Ads não funciona
Verifique:
- URLs de campanha contêm GCLID/FBCLID
- Script está carregando antes de capturar parâmetros
- Não há bloqueadores de rastreamento ativos
?gclid=test123 à URL e verifique se é capturado.Personalização não está aplicando
Personalização não está aplicando
Soluções:
- Limpe cache do navegador
- Verifique se salvou as configurações no Kinbox
- Aguarde alguns minutos para propagação
- 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