Aller au contenu principal

D\u00e9pannage et FAQ

Cette page couvre les probl\u00e8mes courants et comment les r\u00e9soudre lors de l'utilisation de PulseChat.

1. Le Chat N'Appara\u00eet Pas dans la Barre Lat\u00e9rale​

Sympt\u00f4mes :

  • Pas d'\u00e9l\u00e9ment de menu \u00ab Chat \u00bb dans la barre lat\u00e9rale d'administration.

V\u00e9rifications :

  1. Module activ\u00e9 ?

    • Allez dans Configuration > Modules.
    • Assurez-vous que PulseChat est Actif.

  2. Permissions du personnel ?

    • Votre r\u00f4le doit avoir la capacit\u00e9 view pour PulseChat.
    • V\u00e9rifiez Configuration > Personnel > R\u00f4les et confirmez :
      • view sous PulseChat est activ\u00e9 pour votre r\u00f4le.

  3. Option PulseChat activ\u00e9e ?

    • Dans les param\u00e8tres PulseChat, assurez-vous que :
      • pulsechat_enabled est d\u00e9fini sur Yes.

2. Probl\u00e8mes de Transport (Messages Lents ou Pas en Temps R\u00e9el)​

Sympt\u00f4mes :

  • Les messages n'apparaissent qu'apr\u00e8s le rafra\u00eechissement de la page ou avec des d\u00e9lais.
  • Les indicateurs de saisie / accus\u00e9s de r\u00e9ception sont incoh\u00e9rents.

V\u00e9rifications :

  1. Regardez la barre de transport en haut du chat :

    • \u00ab Pusher WebSockets -- livraison instantan\u00e9e \u00bb (bleu) ou
    • \u00ab Interrogation Int\u00e9gr\u00e9e -- les messages se rafra\u00eechissent toutes les ~3s \u00bb (vert).

  2. Si vous utilisez Pusher :

    • Confirmez les identifiants Pusher (App ID/Key/Secret/Cluster) dans les param\u00e8tres Perfex.
    • Assurez-vous que le pare-feu ne bloque pas pusher.com.
    • V\u00e9rifiez le tableau de bord Pusher pour les erreurs ou limites de connexion.

  3. Si vous utilisez l'Interrogation :

    • Un certain d\u00e9lai (quelques secondes) est normal ; c'est le comportement attendu.

  4. Pour changer de transport :

    • Allez dans Param\u00e8tres PulseChat > Transport en Temps R\u00e9el.
    • Choisissez pusher, polling ou auto.
    • Sauvegardez et rechargez la page du chat.

3. Les Fichiers Ne Se T\u00e9l\u00e9chargent Pas​

Sympt\u00f4mes :

  • L'upload \u00e9choue silencieusement ou avec une erreur.

V\u00e9rifications :

  1. Types de fichiers autoris\u00e9s

    • Assurez-vous que l'extension est autoris\u00e9e dans pulsechat_allowed_file_types.

  2. Taille maximale

    • La taille du fichier doit \u00eatre dans la limite de pulsechat_max_file_size_mb.

  3. Permissions

    • V\u00e9rifiez que modules/pulsechat/uploads/ est accessible en \u00e9criture.

  4. Journaux d'erreurs

    • V\u00e9rifiez les journaux de Perfex et les journaux d'erreurs du serveur pour les messages li\u00e9s aux uploads.

4. Les Clients Ne Peuvent Pas Voir ou Utiliser le Chat​

Sympt\u00f4mes :

  • Le personnel peut utiliser PulseChat ; les clients ne voient aucun widget de chat.

V\u00e9rifications :

  1. Chat client activ\u00e9 ?

    • Assurez-vous que pulsechat_clients_enabled est d\u00e9fini sur Yes dans les param\u00e8tres.

  2. Hooks du portail client

    • PulseChat injecte un widget dans le portail client via init_chat.php.
    • Assurez-vous qu'il n'y a pas de surcharges ou de personnalisations de mod\u00e8les qui le suppriment.

  3. Permissions

    • Seuls les contacts connect\u00e9s peuvent utiliser le chat client ; les visiteurs anonymes ne le verront pas.

5. Les Messages Omnicanaux N'Arrivent Pas​

Sympt\u00f4mes :

  • Les messages WhatsApp/Telegram/Email n'apparaissent pas dans les Canaux.

V\u00e9rifications :

  1. Omnicanal activ\u00e9 ?

    • pulsechat_channels_enabled = Yes.

  2. Configuration du canal

    • Pour chaque type de canal :
      • WhatsApp : token, ID du t\u00e9l\u00e9phone, URL du webhook configur\u00e9s chez Meta.
      • Telegram : token du bot et URL du webhook configur\u00e9s via BotFather.
      • Email : param\u00e8tres IMAP corrects, SSL/ports corrects, identifiants valides.

  3. Webhooks

    • Confirmez que les webhooks du fournisseur pointent vers votre endpoint ChannelWebhook/webhook.php.
    • V\u00e9rifiez les journaux pour les \u00e9checs de v\u00e9rification de signature.

  4. Interrogation email

    • Assurez-vous que le cron de Perfex fonctionne.
    • pulsechat_cron_email_poll ne s'ex\u00e9cutera pas sans after_cron_run.

6. Les Boutons IA Ne Fonctionnent Pas​

Sympt\u00f4mes :

  • La barre d'outils IA est visible mais :
    • Cliquer sur Brouillon/Sugg\u00e9rer/R\u00e9\u00e9crire/Traduire ne fait rien, ou
    • Les toasts affichent \u00ab AI not configured \u00bb ou des erreurs HTTP.

V\u00e9rifications :

  1. Param\u00e8tres

    • pulsechat_ai_enabled = Yes.
    • Fournisseur s\u00e9lectionn\u00e9 (openai ou anthropic).
    • Cl\u00e9 API correcte entr\u00e9e pour le fournisseur s\u00e9lectionn\u00e9.
    • Bascules de fonctions IA (R\u00e9ponse Automatique, Suggestions, R\u00e9\u00e9criture, Traduction, Sentiment) activ\u00e9es selon les besoins.

  2. R\u00e9seau

    • Assurez-vous que votre serveur peut atteindre :
      • https://api.openai.com
      • https://api.anthropic.com
    • V\u00e9rifiez les blocages pare-feu/proxy ou les probl\u00e8mes DNS.

  3. Texte d'erreur

    • De nombreuses erreurs retournent :
      • "OpenAI API key not configured."
      • "Text is required."
      • Statut HTTP avec message d'erreur du fournisseur.

  4. Journaux IA

    • Consultez pc_ai_logs pour plus de d\u00e9tails :
      • action_type, model, error (si captur\u00e9e), compteurs de tokens.

7. Erreurs de Base de Donn\u00e9es (Constantes Non D\u00e9finies)​

Sympt\u00f4mes :

  • Erreurs comme "Undefined constant TABLE_PC_MESSAGES".

V\u00e9rifications :

  1. Assurez-vous que le code PulseChat le plus r\u00e9cent est d\u00e9ploy\u00e9 :
    • pulsechat.php d\u00e9finit les constantes TABLE_PC_*.
  2. Solutions de secours dans Pulsechat_model :
    • Le mod\u00e8le d\u00e9finit les constantes de tables principales si elles ne sont pas d\u00e9j\u00e0 d\u00e9finies.
  3. Si vous voyez toujours cela :
    • Confirmez qu'il n'y a pas de copies dupliqu\u00e9es/anciennes du module dans d'autres chemins.

8. Toujours Bloqu\u00e9 ?​

Si vous avez essay\u00e9 ce qui pr\u00e9c\u00e8de et ne pouvez toujours pas r\u00e9soudre le probl\u00e8me :

  1. Collectez :
    • Messages d'erreur exacts.
    • Journaux pertinents (journaux d'erreurs PHP, journaux Perfex).
    • Captures d'\u00e9cran des \u00e9crans de param\u00e8tres concern\u00e9s.
  2. Contactez le support avec :
    • Votre version de Perfex.
    • Version de PulseChat.
    • Toute personnalisation que vous avez faite (vues surcharg\u00e9es, code modifi\u00e9, etc.).

Ces informations rendront le diagnostic et la r\u00e9solution du probl\u00e8me beaucoup plus rapides.