Zum Hauptinhalt springen

Erste Schritte

Diese Seite f\u00fchrt Sie durch die Installation, Aktivierung und das erstmalige \u00d6ffnen von PulseChat.

1. Anforderungen​

  • Perfex CRM >= 3.0.0
  • PHP-Version kompatibel mit Ihrer Perfex-Installation (PulseChat selbst ben\u00f6tigt keine speziellen Erweiterungen \u00fcber die von Perfex bereits verwendeten hinaus)

2. Installation​

  1. Laden Sie das Modul hoch

    • Kopieren Sie den pulsechat-Modulordner in Ihre Perfex-Installation unter:
      • modules/pulsechat
    • Stellen Sie sicher, dass alle Unterordner vorhanden sind:
      • controllers, models, views, assets, migrations, language, libraries, core, third_party, vendor, etc.

  2. \u00dcberpr\u00fcfen Sie die Dateiberechtigungen

    • Der Webserver-/PHP-Benutzer muss die Moduldateien lesen k\u00f6nnen.
    • Das Upload-Verzeichnis muss beschreibbar sein:
      • modules/pulsechat/uploads/

  3. Melden Sie sich als Administrator an

    • Melden Sie sich bei Ihrem Perfex CRM als Mitarbeiter mit Administrator-Rechten an.

3. Ersteinrichtungsassistent​

Bei der ersten Verwendung als Administrator:

  1. Gehen Sie zu PulseChat in der linken Seitenleiste:

    • Sie sehen ein Chat-Symbol (fa-comments), das vom Modul hinzugef\u00fcgt wurde.
    • Klicken Sie darauf, um die vollst\u00e4ndige PulseChat-Seite zu \u00f6ffnen (admin/pulsechat/chat).

  2. Wenn die Ersteinrichtung nicht abgeschlossen ist, sehen Sie einen Assistenten:

    • Dieser f\u00fchrt Sie durch die Auswahl des Transportmodus:
      • Pusher WebSockets --- sofortige Echtzeit-Nachrichtenübermittlung (erfordert Pusher-Zugangsdaten).
      • Integriertes Polling --- kein externer Dienst, Nachrichten werden alle ~3 Sekunden aktualisiert.
    • F\u00fcr Pusher werden Sie nach Folgendem gefragt:
      • App ID, Key, Secret, Cluster

  3. Nach dem Speichern markiert der Assistent die Einrichtung als abgeschlossen und leitet Sie zur Haupt-Chat-Oberfl\u00e4che weiter.

Sie k\u00f6nnen den Transport jederzeit sp\u00e4ter in den PulseChat-Einstellungen \u00e4ndern, sodass der Assistent nur eine Hilfe f\u00fcr Erstinstallationen ist.

4. Wo Sie PulseChat in Perfex finden​

  • Administrationsbereich

    • Linke Seitenleiste: ein "Chat"-Eintrag (PulseChat) unter der Hauptnavigation.
    • \u00d6ffnet die Drei-Panel-Chat-Oberfl\u00e4che (chat_view.php).

  • Kundenbereich (optional)

    • Wenn der Kunden-Chat in den Einstellungen aktiviert ist, erscheint ein schwebendes Chat-Widget im Kundenportal, das Gespr\u00e4che zwischen Mitarbeitern und Kunden erm\u00f6glicht.

  • Modulseite

    • Einstellungen -> Module -> PulseChat
      • Links:
        • Einstellungen --- \u00f6ffnet admin/pulsechat/settings (vollst\u00e4ndige PulseChat-Konfiguration).
        • Chat \u00f6ffnen --- Shortcut zu admin/pulsechat/chat.

5. Grundlegendes Datenmodell (\u00dcberblick)​

PulseChat speichert seine Daten in dedizierten Tabellen (alle mit Pr\u00e4fix \u00fcber db_prefix()):

  • pc_conversations --- alle Konversationen (Mitarbeiter-DM, Gruppen, Kunden, Omnichannel)
  • pc_participants --- Teilnehmer jeder Konversation
  • pc_messages --- einzelne Nachrichten (eingehend/ausgehend, Medien, Systemnachrichten)
  • pc_channels --- Omnichannel-Verbindungen (WhatsApp, Telegram, E-Mail, etc.)
  • pc_external_contacts, pc_contact_identities --- Zuordnung externer Kontakte f\u00fcr Kan\u00e4le
  • pc_ai_logs --- KI-Nutzungs- und Kostenverfolgung
  • pc_analytics_cache, pc_assignments_log --- Analysen und Zuweisungshistorie

Sie m\u00fcssen diese Tabellen nicht manuell verwalten --- Perfex-Migrationen \u00fcbernehmen die Erstellung und Aktualisierung --- aber das Verst\u00e4ndnis hilft bei der Fehlerbehebung oder beim Erstellen von Integrationen.

6. N\u00e4chste Schritte​

Sobald PulseChat installiert und aktiviert ist: