Principais características

Estrutura de Arquivos

modules/livechat/
├── LiveChat.php          (Main class - 128 methods)
├── admin-livechat.php    (Admin panel - this file)
├── livechat.tpl          (Widget template)
├── livechat.js           (Widget JS - visitor facing)
├── config.php            (Configuration)
└── assets/
    ├── notification.mp3
    └── widget.css

Fluxo de solicitação

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Widget JS   │────▶│  AJAX Handler │────▶│  LiveChat   │
│  (Browser)   │◀────│  (PHP)       │◀────│  Class      │
└─────────────┘     └──────────────┘     └──────┬──────┘
                                                 │
┌─────────────┐     ┌──────────────┐            │
│  Admin Panel │────▶│  SSE Stream  │◀───────────┘
│  (This page) │◀────│  (Real-time) │     ┌──────┴──────┐
└─────────────┘     └──────────────┘     │  Database    │
                                          │  (12 tables) │
                                          └─────────────┘

Comunicação em tempo real

Utiliza Eventos Enviados pelo Servidor (SSE) para atualizações em tempo real. O painel de administração mantém uma conexão SSE persistente para:

• Atualizações em tempo real sobre o número de visitantes e o status da visita.
• Novas notificações de mensagens
• Alterações na fila
• Indicadores de digitação via fallback de pesquisa

Autenticação

Autenticação administrativa via autenticação PHP baseada em sessão. O widget utiliza a impressão digital do visitante (hash do navegador + IP + cookie) para garantir a continuidade da sessão.

Ações voltadas para widgets (18)

Ações voltadas para o administrador (37)

Código de integração

<script src="/modules/livechat/livechat.js"></script>
<script>
  WeSellMachines.LiveChat.init({
    position: 'bottom-right',
    primaryColor: '#3498db',
    greeting: 'Need help? Chat with us!',
    offlineMessage: 'We are offline. Leave a message!'
  });
</script>

Idiomas suportados (35)

en, de, fr, es, it, nl, pl, pt, ja, zh, ko, ru, ar, tr, sv, não, fi, da, cs, hu, ro, bg, el, hr, sk, sl, lt, lv, et, reino unido, sr, ele, th, vi, id

API JavaScript

// Open chat programmatically
WeSellMachines.LiveChat.open();

// Send automatic message  
WeSellMachines.LiveChat.sendMessage('How can I help?');

// Track custom event
WeSellMachines.LiveChat.trackEvent('viewed_listing', {id: 1234});

// Set visitor info
WeSellMachines.LiveChat.setVisitor({name: 'John', email: 'john@example.com'});

Intervalos de datas

Suporta intervalos de dados de hoje, 7/30/90 dias. Todos os dados são agregados no servidor com armazenamento em cache.

Subguias

• Visão geral: 6 KPIs, linha de tendência, barras horárias, canais, qualidade, fontes de referência, funil, novos/recorrentes, métricas de chat
• Conversas: Alerta de chats perdidos, distribuição do tempo de resposta, duração, tendência de CSAT, fontes de chat, tópicos das mensagens
• Visitantes: Tipos de dispositivos, idiomas, países, mapa de calor de horários de pico (grade 7×24)
• Desempenho: Navegadores, sistemas operacionais e resoluções de tela com gráficos de barras.
• Contente: Tipos de página, páginas de entrada/saída, páginas geradoras de chat, tabela de página inteira com classificação/filtro/busca

Filtros de dados

Tráfego de bots excluído por padrão. IPs internos configuráveis em Configurações. Todos os gráficos utilizam Chart.js com canvas responsivo.

1. Carregar arquivos para modules/livechat/
2. Configurar config.php com credenciais de banco de dados
3. Executar configuração — tabelas criadas automaticamente no primeiro carregamento
4. Adicionar widget — incluir livechat.js em seu modelo
5. Configurar SSE — garantir que o servidor suporte EventSource
6. Teste — Abra o painel de administração e verifique a conexão.

Configurações do arquivo config.php

V5 — Atual

• Análises avançadas com 5 subguias e mapas de calor.
• Tradução em tempo real (35 idiomas)
• Sistema de gerenciamento de bots
• cadeia de escalonamento por inatividade
• Programação de feriados
• Widget chamativo

V4

• Painel de contexto da conversa
• Respostas predefinidas com pesquisa
• Suporte para compartilhamento de arquivos
• Gerenciamento de filas
• Sistema de retorno de chamada

V3

• mecanismo de regras de acionamento automático
• Perfil e linha do tempo do visitante
• Sistema avançado de banimento (IP + tempo)
• Perfis de administrador com avatares

V2

• Atualizações em tempo real da SSE
• notificações da área de trabalho
• Alertas sonoros
• Indicadores de digitação

V1

• Funcionalidade básica de bate-papo
• Rastreamento de visitantes
• Interface de resposta do administrador