Pular para o conteúdo principal

Primeiros Passos

Esta p\u00e1gina orienta voc\u00ea na instala\u00e7\u00e3o, ativa\u00e7\u00e3o e primeira abertura do PulseChat.

1. Requisitos​

  • Perfex CRM >= 3.0.0
  • Vers\u00e3o do PHP compat\u00edvel com sua instala\u00e7\u00e3o do Perfex (o PulseChat n\u00e3o requer extens\u00f5es especiais al\u00e9m das que o Perfex j\u00e1 utiliza)

2. Instala\u00e7\u00e3o​

  1. Fa\u00e7a upload do m\u00f3dulo

    • Copie a pasta do m\u00f3dulo pulsechat para sua instala\u00e7\u00e3o do Perfex em:
      • modules/pulsechat
    • Certifique-se de que todas as subpastas est\u00e3o presentes:
      • controllers, models, views, assets, migrations, language, libraries, core, third_party, vendor, etc.

  2. Verifique as permiss\u00f5es de arquivo

    • O usu\u00e1rio do servidor web/PHP deve poder ler os arquivos do m\u00f3dulo.
    • O diret\u00f3rio de upload deve ser grav\u00e1vel:
      • modules/pulsechat/uploads/

  3. Fa\u00e7a login como administrador

    • Fa\u00e7a login no seu Perfex CRM como membro da equipe com privil\u00e9gios de administrador.

3. Assistente de Configura\u00e7\u00e3o Inicial​

No primeiro uso como administrador:

  1. V\u00e1 at\u00e9 PulseChat na barra lateral esquerda:

    • Voc\u00ea ver\u00e1 um \u00edcone de chat (fa-comments) adicionado pelo m\u00f3dulo.
    • Clique para abrir a p\u00e1gina completa do PulseChat (admin/pulsechat/chat).

  2. Se a configura\u00e7\u00e3o inicial n\u00e3o estiver conclu\u00edda, voc\u00ea ver\u00e1 um assistente:

    • Ele o guia na sele\u00e7\u00e3o do modo de transporte:
      • Pusher WebSockets --- mensagens instant\u00e2neas em tempo real (requer credenciais do Pusher).
      • Polling Integrado --- sem servi\u00e7o externo, as mensagens atualizam a cada ~3 segundos.
    • Para o Pusher, ser\u00e1 solicitado:
      • App ID, Key, Secret, Cluster

  3. Ap\u00f3s salvar, o assistente marca a configura\u00e7\u00e3o como conclu\u00edda e redireciona voc\u00ea para a interface principal do chat.

Voc\u00ea sempre pode alterar o transporte depois em Configura\u00e7\u00f5es do PulseChat, ent\u00e3o o assistente \u00e9 apenas uma conveni\u00eancia para primeiras instala\u00e7\u00f5es.

4. Onde Encontrar o PulseChat no Perfex​

  • \u00c1rea de administra\u00e7\u00e3o

    • Barra lateral esquerda: uma entrada "Chat" (PulseChat) sob a navega\u00e7\u00e3o principal.
    • Abre a interface de chat de tr\u00eas pain\u00e9is (chat_view.php).

  • \u00c1rea do cliente (opcional)

    • Se o chat do cliente estiver habilitado nas configura\u00e7\u00f5es, um widget de chat flutuante aparece no portal do cliente, permitindo conversas entre equipe e clientes.

  • P\u00e1gina de m\u00f3dulos

    • Configura\u00e7\u00e3o -> M\u00f3dulos -> PulseChat
      • Links:
        • Configura\u00e7\u00f5es --- abre admin/pulsechat/settings (configura\u00e7\u00e3o completa do PulseChat).
        • Abrir Chat --- atalho para admin/pulsechat/chat.

5. Modelo de Dados B\u00e1sico (Alto N\u00edvel)​

O PulseChat armazena seus dados em tabelas dedicadas (todas prefixadas via db_prefix()):

  • pc_conversations --- todas as conversas (MD da equipe, grupos, clientes, omnicanal)
  • pc_participants --- participantes de cada conversa
  • pc_messages --- mensagens individuais (entrada/sa\u00edda, m\u00eddia, mensagens do sistema)
  • pc_channels --- conex\u00f5es omnicanal (WhatsApp, Telegram, Email, etc.)
  • pc_external_contacts, pc_contact_identities --- mapeamento de contatos externos para canais
  • pc_ai_logs --- rastreamento de uso e custos de IA
  • pc_analytics_cache, pc_assignments_log --- an\u00e1lises e hist\u00f3rico de atribui\u00e7\u00f5es

Voc\u00ea n\u00e3o precisa gerenciar essas tabelas manualmente --- as migra\u00e7\u00f5es do Perfex cuidam da cria\u00e7\u00e3o e atualiza\u00e7\u00e3o --- mas entend\u00ea-las ajuda na resolu\u00e7\u00e3o de problemas ou cria\u00e7\u00e3o de integra\u00e7\u00f5es.

6. Pr\u00f3ximos Passos​

Assim que o PulseChat estiver instalado e ativado: