Aller au contenu principal

Configuration Administrateur

Cette page explique comment configurer PulseChat en tant qu'administrateur : transport, permissions, limites, canaux omnicanaux, IA et autres options expos\u00e9es dans views/admin/settings.php.

Toutes les options ci-dessous se trouvent dans Configuration -> Modules -> PulseChat -> Param\u00e8tres (qui ouvre admin/pulsechat/settings).

1. G\u00e9n\u00e9ral​

Ces options contr\u00f4lent le comportement global du module.

  • Activer PulseChat

    • Option : pulsechat_enabled
    • Lorsque Oui, PulseChat est actif et l'\u00e9l\u00e9ment de menu chat appara\u00eet pour le personnel autoris\u00e9.

  • Activer le Chat Client

    • Option : pulsechat_clients_enabled
    • Lorsque Oui, un widget de chat est inject\u00e9 dans le portail client, permettant les conversations entre personnel et clients.

  • Statut Utilisateur Par D\u00e9faut \u00e0 la Connexion

    • Option : pulsechat_default_status
    • Valeurs : online, away, busy, offline
    • D\u00e9termine le statut de pr\u00e9sence initial lorsque le personnel ouvre la zone d'administration.

2. Notifications​

  • Notifications Bureau

    • Option : pulsechat_desktop_notifications
    • Active les notifications bureau du navigateur pour les nouveaux messages (le personnel doit autoriser les notifications dans le navigateur).

  • Notifications Sonores

    • Option : pulsechat_sound_notifications
    • Joue un son (assets/audio/notification.mp3) lorsque de nouveaux messages arrivent.

  • Notifications Toast

    • Option : pulsechat_toast_notifications
    • Affiche de petites notifications contextuelles dans l'interface d'administration pour les \u00e9v\u00e9nements cl\u00e9s.

3. Permissions et Acc\u00e8s​

Ces options et capacit\u00e9s du personnel contr\u00f4lent qui peut utiliser quoi.

3.1 Capacit\u00e9s du Personnel (bas\u00e9es sur les r\u00f4les)​

D\u00e9finies dans pulsechat.php via pulsechat_register_permissions() :

  • view --- peut voir l'interface PulseChat.
  • send --- peut envoyer des messages.
  • delete --- peut supprimer des messages (sous r\u00e9serve de param\u00e8tres suppl\u00e9mentaires).
  • create_groups --- peut cr\u00e9er des conversations de groupe.
  • manage_channels --- peut configurer les connexions omnicanales.
  • manage_automation --- peut g\u00e9rer les r\u00e8gles d'automatisation.
  • view_analytics --- peut voir les analytiques et rapports.
  • use_ai --- peut acc\u00e9der aux outils IA (brouillon, suggestions, r\u00e9\u00e9criture, traduction, etc.).
  • assign --- peut assigner / r\u00e9assigner des conversations.
  • view_all_channels --- peut voir toutes les conversations omnicanales, pas seulement celles assign\u00e9es/propres.

Assignez ces capacit\u00e9s aux r\u00f4les dans Configuration -> Personnel -> R\u00f4les.

3.2 Permissions de l'Onglet Param\u00e8tres​

  • Autoriser le Personnel \u00e0 Supprimer des Messages

    • Option : pulsechat_staff_can_delete

  • Autoriser le Personnel \u00e0 Cr\u00e9er des Groupes

    • Option : pulsechat_staff_can_create_groups

  • Autoriser \u00e0 Quitter les Groupes

    • Option : pulsechat_allow_leave_groups
    • Si Non, seuls les administrateurs peuvent retirer des membres ou dissoudre des groupes.

  • Les Nouveaux Membres Voient l'Historique

    • Option : pulsechat_new_members_see_history
    • Lorsque Oui, les membres nouvellement ajout\u00e9s voient l'historique complet du groupe.
    • Lorsque Non, ils ne voient que les messages envoy\u00e9s apr\u00e8s leur arriv\u00e9e.

  • Uniquement les Utilisateurs Autoris\u00e9s

    • Option : pulsechat_only_permitted_users
    • Lorsque Oui, seul le personnel avec la capacit\u00e9 view (ou les administrateurs) appara\u00eet dans les listes du personnel et peut utiliser PulseChat.

4. Fonctionnalit\u00e9s​

Activez ou d\u00e9sactivez les fonctionnalit\u00e9s optionnelles :

  • Partage de Fichiers

    • pulsechat_allow_file_sharing
    • Active le t\u00e9l\u00e9chargement de pi\u00e8ces jointes via le bouton trombone.

  • Messages Audio

    • pulsechat_allow_audio_messages
    • Active l'enregistrement et l'envoi de messages vocaux.

  • R\u00e9actions

    • pulsechat_allow_reactions
    • Active les r\u00e9actions emoji sur les messages.

  • Transfert

    • pulsechat_allow_message_forwarding

  • \u00c9pinglage

    • pulsechat_allow_message_pinning

  • Conversion en Ticket

    • pulsechat_allow_ticket_conversion
    • Active le bouton \u00ab Convertir en Ticket \u00bb dans l'en-t\u00eate du chat.

  • Indicateurs de Saisie

    • pulsechat_show_typing_indicators

  • Accus\u00e9s de R\u00e9ception

    • pulsechat_show_read_receipts

  • Statut en Ligne

    • pulsechat_show_online_status

5. Limites et Gestion des Donn\u00e9es​

5.1 Limites​

  • Taille Maximale de Fichier

    • pulsechat_max_file_size_mb
    • Taille maximale d'upload pour les pi\u00e8ces jointes (en Mo).

  • Fen\u00eatre de Modification des Messages

    • pulsechat_edit_window_minutes
    • Combien de temps apr\u00e8s l'envoi un message peut \u00eatre modifi\u00e9 (0 = jamais autoris\u00e9).

  • Maximum de Membres par Groupe

    • pulsechat_max_group_members

  • Types de Fichiers Autoris\u00e9s

    • pulsechat_allowed_file_types
    • Liste d'extensions s\u00e9par\u00e9es par des virgules (ex. .jpg,.png,.pdf,.docx).

5.2 R\u00e9tention des Donn\u00e9es​

D\u00e9finie dans la m\u00eame page de Param\u00e8tres :

  • Purge Automatique Apr\u00e8s (mois)
    • pulsechat_auto_purge_months
    • 0 = ne jamais purger.
    • Sinon, les messages plus anciens que le nombre de mois sp\u00e9cifi\u00e9 peuvent \u00eatre purg\u00e9s par la logique de nettoyage.

6. Apparence​

PulseChat h\u00e9rite des styles de Perfex et ajoute les siens.

Options cl\u00e9s :

  • Couleur de Marque

    • pulsechat_brand_color
    • Utilis\u00e9e pour les accents principaux dans l'interface de chat.

  • Arri\u00e8re-plan du Chat

    • pulsechat_chat_bg
    • S\u00e9lectionnez parmi les arri\u00e8re-plans/th\u00e8mes pr\u00e9d\u00e9finis.

Il y a aussi des pr\u00e9f\u00e9rences au niveau utilisateur (th\u00e8me sombre/clair) stock\u00e9es par personnel et appliqu\u00e9es via les attributs data-theme dans chat_view.php.

7. Transport (Temps R\u00e9el)​

PulseChat supporte :

  • Interrogation Int\u00e9gr\u00e9e --- Appels AJAX p\u00e9riodiques pour r\u00e9cup\u00e9rer les nouveaux messages (aucun service externe).
  • Pusher WebSockets --- Livraison en temps r\u00e9el via Pusher Channels.
  • Auto --- Utilise Pusher quand correctement configur\u00e9 ; sinon revient \u00e0 l'interrogation.

Param\u00e8tres pertinents dans la section \u00ab Transport en Temps R\u00e9el \u00bb :

  • pulsechat_transport --- auto, pusher ou polling
  • Param\u00e8tres Pusher suppl\u00e9mentaires extraits de la configuration centrale de Perfex (App ID, Key, Secret, Cluster).

Vous pouvez les modifier \u00e0 tout moment dans les param\u00e8tres PulseChat ; l'interface indique le mode actif via la barre de transport en haut du chat.

8. Canaux Omnicanaux​

Pour activer la bo\u00eete de r\u00e9ception omnicanale :

  • Activez Activer les Canaux Omnicanaux
    • Option : pulsechat_channels_enabled
    • Lorsque Oui, un onglet Canaux appara\u00eet dans la barre lat\u00e9rale gauche et le backend omnicanal est actif.

Chaque canal (WhatsApp, Telegram, Email, etc.) est configur\u00e9 dans l'interface Canaux (ic\u00f4ne d'engrenage dans l'onglet Canaux) et stock\u00e9 dans pc_channels en tant que configuration JSON chiffr\u00e9e.

Consultez Omnicanal et Canaux pour les d\u00e9tails par canal.

9. Assistant IA​

PulseChat peut utiliser OpenAI (ChatGPT) ou Anthropic (Claude) pour :

  • Brouillons de r\u00e9ponses
  • Suggestions intelligentes (chips)
  • R\u00e9\u00e9criture de messages
  • Orthographe/grammaire
  • R\u00e9sum\u00e9s
  • Traduction
  • Analyse de sentiment

Dans la section Assistant IA --- Multi-Fournisseur vous trouverez :

  • Activer les Fonctions IA

    • pulsechat_ai_enabled

  • Fournisseur IA

    • pulsechat_ai_provider --- openai ou anthropic

  • Cl\u00e9 API OpenAI

    • pulsechat_ai_api_key

  • Cl\u00e9 API Anthropic

    • pulsechat_ai_anthropic_api_key

  • Mod\u00e8le IA

    • pulsechat_ai_model --- les options incluent :
      • OpenAI : gpt-4o, gpt-4o-mini, gpt-3.5-turbo
      • Anthropic : claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022, claude-3-opus-20240229

  • Prompt Syst\u00e8me

    • pulsechat_ai_system_prompt
    • Instruction globale utilis\u00e9e par tous les appels IA (ex. \u00ab Vous \u00eates un assistant de support client utile... \u00bb).

  • Temp\u00e9rature

    • pulsechat_ai_temperature

  • Tokens Maximum

    • pulsechat_ai_max_tokens

  • Bascules de Fonctionnalit\u00e9s

    • pulsechat_ai_auto_reply --- affiche le bouton Brouillon (brouillon de r\u00e9ponse IA).
    • pulsechat_ai_suggestions --- affiche les chips de suggestions.
    • pulsechat_ai_rewrite --- active le bouton de r\u00e9\u00e9criture.
    • pulsechat_ai_translate --- active le bouton de traduction.
    • pulsechat_ai_sentiment --- aides \u00e0 l'analyse de sentiment.

Consultez Assistant IA pour voir comment ils apparaissent dans l'interface et comment ils se comportent dans les conversations.

10. Licence​

La licence de PulseChat est configur\u00e9e via :

  • pulsechat_verification_id
  • pulsechat_product_token
  • pulsechat_last_verification
  • pulsechat_heartbeat

Ceux-ci sont g\u00e9r\u00e9s automatiquement par le flux de licence et ne doivent pas \u00eatre modifi\u00e9s manuellement. Pour changer de licence :

  • D\u00e9sactivez PulseChat dans Configuration -> Modules.
  • R\u00e9activez-le ; l'\u00e9cran d'activation r\u00e9appara\u00eetra, vous permettant d'entrer une nouvelle cl\u00e9 d'achat.