Einführung

Der WP Chat Spezialist ist ein fortschrittliches WordPress-Plugin, das ein intelligentes, KI-gestütztes Chat-Widget bereitstellt. Es nutzt die Google Gemini API, um natürliche und kontextbezogene Antworten zu generieren, während es den Gesprächsfluss und die Erfassung potenzieller Leads automatisch verwaltet.

Das Plugin wurde entwickelt, um die Benutzererfahrung auf Ihrer Website zu verbessern, indem es sofortige Unterstützung bietet und während der Gespräche auf organische Weise wertvolle Kontaktinformationen erfasst.

Hauptmerkmale:

• KI-gestütztes Chat-Widget powered by Google Gemini
• Automatische Verwaltung des Konversationsstatus
• Intelligente Lead-Erfassung
• Umfassende Mehrsprachigkeitsunterstützung
• Anti-Spam- und Bann-Schutzsystem
• Umfassender Administrationsbereich
• Erweiterbare Hooks für Entwickler

Installation und Konfiguration

Plugin-Installation

1. Laden Sie die .zip-Datei des Plugins WP Chat Spezialist herunter.

2. Gehen Sie in Ihrem WordPress-Administrationsbereich zu Plugins > Neu hinzufügen.

3. Klicken Sie oben auf der Seite auf die Schaltfläche Plugin hochladen.

4. Wählen Sie die heruntergeladene .zip-Datei aus und klicken Sie auf Jetzt installieren.

5. Nach der Installation klicken Sie auf Plugin aktivieren.

Erstkonfiguration

Nach der Aktivierung des Plugins erscheint ein neues Menü “WP Chat Experte” in Ihrem Administrationsbereich.

1. Gehen Sie zu WP Chat Experte > Einstellungen.

2. Füllen Sie die grundlegenden Felder aus:

• Name des Unternehmens: Der Name Ihres Unternehmens oder Ihrer Website
• Name des Agenten: Wie sich der Bot identifizieren wird (z.B. “Virtueller Assistent”)
• Basisinformationen: Informationen über Ihr Unternehmen, Ihre Dienstleistungen und Produkte, die die KI zur Beantwortung verwenden wird

Google Gemini API-Konfiguration

Damit der Chat mit KI funktioniert, müssen Sie Ihren Google Gemini API-Schlüssel konfigurieren:

1. Holen Sie sich Ihren API-Schlüssel von Google AI Studio.

2. Fügen Sie unter Einstellungen Ihren Schlüssel in das Feld “Google Gemini API-Schlüssel” ein.

3. Wählen Sie das Gemini-Modell aus (Standard: gemini-2.0-pro-exp-02-05).

4. Speichern Sie die Änderungen. Das Chat-Widget wird automatisch auf Ihrer Website erscheinen.

Chat-Widget

Funktionsweise des Chats

Das Chat-Widget erscheint als schwebende Schaltfläche in der unteren rechten Ecke Ihrer Website. Besucher können darauf klicken, um eine Konversation zu starten.

Merkmale des Widgets:

• Responsives Design, das auf Mobilgeräten und Desktops funktioniert
• Echtzeit-Tippindikatoren
• Persistenz von Konversationen über Seiten hinweg
• Unterstützung für RTL (Rechts-nach-Links-Sprachen)
• Optionaler Debug-Modus für die Entwicklung

Konversationsstatus

Das Plugin verwaltet automatisch verschiedene Status während der Konversation:

• Start: Begrüßung und allgemeine Anfragen
• Information: Bereitstellung von Informationen über Produkte/Dienstleistungen
• Lead-Erfassung: Sammeln von Kontaktdaten des Benutzers
• Verabschiedung: Beendigung der Konversation

Die KI entscheidet automatisch, wann zwischen den Status gewechselt wird, basierend auf dem Konversationskontext.

Lead-Erfassung

Wenn die KI geschäftliches Interesse erkennt, wird automatisch der Lead-Erfassungsmodus aktiviert:

1. Es werden auf natürliche Weise der Name und die E-Mail-Adresse des Benutzers angefordert.

2. Optional kann die Telefonnummer abgefragt werden.

3. Die Daten werden automatisch in der Datenbank gespeichert.

4. Konfigurierbare Benachrichtigungen werden an Administratoren gesendet.

Benutzer können den Lead-Erfassungsmodus “verlassen”, wenn sie noch Fragen haben, und zum Informationsfluss zurückkehren.

Administrationsbereich

Lead-Dashboard

Verwalten Sie alle erfassten Leads unter WP Chat Experte > Leads:

• Lead-Liste: Zeigen Sie alle erfassten Kontakte an
• Status: Neu, Kontaktiert, Abgeschlossen
• Massenaktionen: Ändern Sie den Status mehrerer Leads
• Konversationsverlauf: Zeigen Sie die vollständige Konversation an, die zum Lead führte
• Export: Möglichkeit, Daten für externe CRMs zu exportieren

Jeder Lead enthält detaillierte Informationen wie Name, E-Mail, Telefon (optional) und den vollständigen Konversationsprotokoll.

Sperrverwaltung

Das Plugin enthält einen automatischen Schutz vor Spam und missbräuchlichem Verhalten:

1. Gehen Sie zu WP Chat Experte > Sperren, um gesperrte IPs zu verwalten.

2. Sperren werden automatisch angewendet, wenn unangemessene Inhalte erkannt werden.

3. Sie können IPs manuell entsperren oder den lokalen Speicher bereinigen.

4. Sperren sind temporär und werden nach dem festgelegten Zeitraum automatisch aufgehoben.

Erweiterte Einstellungen

Zusätzliche Optionen, die im Einstellungsbereich verfügbar sind:

• Debug-Modus: Zeigt technische Informationen für die Entwicklung an
• KI-Sprache: Sprachcode für die KI-Antworten
• Gemini-Modell: Auswahl des zu verwendenden KI-Modells
• Sitzungseinstellungen: Lebensdauer der Chat-Sitzungen

Mehrsprachige Unterstützung

Verfügbare Sprachen

Das Plugin bietet umfassende Unterstützung für mehrere Sprachen:

• Spanisch (es_ES): Standardsprache
• Englisch (en_US): Volle Unterstützung
• Weitere Sprachen: Leicht erweiterbar

Spracheinstellung

1. Wählen Sie unter Einstellungen die Standardsprache der Benutzeroberfläche aus.

2. Konfigurieren Sie die “Standard-KI-Sprache” für die Antworten der künstlichen Intelligenz.

3. Die KI kann die Sprache des Benutzers automatisch erkennen und ihre Antworten entsprechend anpassen.

4. Die Texte der Benutzeroberfläche passen sich automatisch an die ausgewählte Sprache an.

Anpassung und Hooks

Hooks für Entwickler

Das Plugin bietet mehrere Hooks, um seine Funktionalität zu erweitern:

Aktions-Hooks:

• especialista_wp_chat_lead_captured – Wird ausgeführt, wenn ein Lead erfasst wird
• especialista_wp_chat_conversation_started – Beim Start einer Konversation
• especialista_wp_chat_message_processed – Nach der Verarbeitung einer Nachricht

CRM-Integrationen

Beispiel für die Integration mit einem externen CRM:

add_action('especialista_wp_chat_lead_captured', 'enviar_lead_a_crm', 10, 3);

function enviar_lead_a_crm($lead_id, $lead_data, $conversation_history) {
    // Ihr CRM-Integrationscode hier
    // $lead_data enthält: Name, E-Mail, Telefon usw.
    // $conversation_history enthält den vollständigen Verlauf
}
      

Fehlerbehebung

Der Chat wird auf der Website nicht angezeigt:

• Stellen Sie sicher, dass der Gemini API-Schlüssel korrekt konfiguriert ist
• Vergewissern Sie sich, dass das Plugin aktiviert ist
• Überprüfen Sie die Browserkonsole auf JavaScript-Fehler

Die KI antwortet nicht oder gibt Fehler aus:

• Überprüfen Sie Ihren API-Schlüssel in Google AI Studio
• Stellen Sie sicher, dass das ausgewählte Gemini-Modell verfügbar ist
• Aktivieren Sie den Debug-Modus, um detaillierte Fehler anzuzeigen

Leads werden nicht gespeichert:

• Überprüfen Sie, ob die Datenbanktabelle korrekt erstellt wurde
• Überprüfen Sie die Datenbankberechtigungen
• Überprüfen Sie die PHP-Protokolle auf Fehler

Leistungsprobleme:

• Das Plugin verwendet Transients zur Leistungsoptimierung
• Sperren und Sitzungen werden automatisch bereinigt
• Erwägen Sie die Verwendung von Objekt-Caching für Websites mit hohem Traffic

Für zusätzlichen Support: Kontaktieren Sie EspecialistaEnWP.com