Aller au contenu principal

Premiers Pas

Cette page vous guide \u00e0 travers l'installation, l'activation et la premi\u00e8re ouverture de PulseChat.

1. Pr\u00e9requis​

  • Perfex CRM >= 3.0.0
  • Version PHP compatible avec votre installation Perfex (PulseChat ne n\u00e9cessite pas d'extensions sp\u00e9ciales au-del\u00e0 de celles d\u00e9j\u00e0 utilis\u00e9es par Perfex)

2. Installation​

  1. T\u00e9l\u00e9chargez le module

    • Copiez le dossier du module pulsechat dans votre installation Perfex sous :
      • modules/pulsechat
    • Assurez-vous que tous les sous-dossiers sont pr\u00e9sents :
      • controllers, models, views, assets, migrations, language, libraries, core, third_party, vendor, etc.

  2. V\u00e9rifiez les permissions des fichiers

    • L'utilisateur du serveur web/PHP doit pouvoir lire les fichiers du module.
    • Le r\u00e9pertoire d'upload doit \u00eatre accessible en \u00e9criture :
      • modules/pulsechat/uploads/

  3. Connectez-vous en tant qu'administrateur

    • Connectez-vous \u00e0 votre Perfex CRM en tant que membre du personnel avec des privil\u00e8ges administrateur.

3. Assistant de Configuration Initiale​

Lors de la premi\u00e8re utilisation en tant qu'administrateur :

  1. Allez dans PulseChat depuis la barre lat\u00e9rale gauche :

    • Vous verrez une ic\u00f4ne de chat (fa-comments) ajout\u00e9e par le module.
    • Cliquez dessus pour ouvrir la page compl\u00e8te de PulseChat (admin/pulsechat/chat).

  2. Si la configuration initiale n'est pas termin\u00e9e, vous verrez un assistant :

    • Il vous guide pour s\u00e9lectionner le mode de transport :
      • Pusher WebSockets --- messagerie instantan\u00e9e en temps r\u00e9el (n\u00e9cessite des identifiants Pusher).
      • Interrogation Int\u00e9gr\u00e9e --- aucun service externe, les messages se rafra\u00eechissent toutes les ~3 secondes.
    • Pour Pusher, on vous demandera :
      • App ID, Key, Secret, Cluster

  3. Apr\u00e8s la sauvegarde, l'assistant marque la configuration comme termin\u00e9e et vous redirige vers l'interface principale du chat.

Vous pouvez toujours changer le transport plus tard depuis les Param\u00e8tres PulseChat, l'assistant n'est donc qu'une commodit\u00e9 pour les premi\u00e8res installations.

4. O\u00f9 Trouver PulseChat dans Perfex​

  • Zone d'administration

    • Barre lat\u00e9rale gauche : une entr\u00e9e \u00ab Chat \u00bb (PulseChat) sous la navigation principale.
    • Ouvre l'interface de chat \u00e0 trois panneaux (chat_view.php).

  • Zone client (optionnel)

    • Si le chat client est activ\u00e9 dans les param\u00e8tres, un widget de chat flottant appara\u00eet dans le portail client, permettant les conversations entre le personnel et les clients.

  • Page des modules

    • Configuration -> Modules -> PulseChat
      • Liens :
        • Param\u00e8tres --- ouvre admin/pulsechat/settings (configuration compl\u00e8te de PulseChat).
        • Ouvrir le Chat --- raccourci vers admin/pulsechat/chat.

5. Mod\u00e8le de Donn\u00e9es de Base (Haut Niveau)​

PulseChat stocke ses donn\u00e9es dans des tables d\u00e9di\u00e9es (toutes pr\u00e9fix\u00e9es via db_prefix()) :

  • pc_conversations --- toutes les conversations (MD du personnel, groupes, clients, omnicanal)
  • pc_participants --- participants de chaque conversation
  • pc_messages --- messages individuels (entrants/sortants, m\u00e9dias, messages syst\u00e8me)
  • pc_channels --- connexions omnicanales (WhatsApp, Telegram, Email, etc.)
  • pc_external_contacts, pc_contact_identities --- mapping des contacts externes pour les canaux
  • pc_ai_logs --- suivi de l'utilisation et des co\u00fbts de l'IA
  • pc_analytics_cache, pc_assignments_log --- analytiques et historique des affectations

Vous n'avez pas besoin de g\u00e9rer ces tables manuellement --- les migrations Perfex s'occupent de la cr\u00e9ation et des mises \u00e0 jour --- mais les comprendre aide lors du d\u00e9pannage ou de la cr\u00e9ation d'int\u00e9grations.

6. \u00c9tapes Suivantes​

Une fois PulseChat install\u00e9 et activ\u00e9 :