Zum Inhalt springen
intoCHAT

Drupal-Integration

KI-Chatbot für deine Drupal-Website

Trainiere einen Agenten mit deinen Drupal-Inhalten und Dokumenten und lade ihn über eine Library deines Themes auf jeder Seite. Ohne Modul, und du kannst den Agenten testen, bevor er live geht.

Agent kostenlos erstellen

Zuletzt aktualisiert:

So funktioniert intoCHAT auf Drupal

Drupal lädt JavaScript über Asset-Libraries, die dein Theme deklariert. intoCHAT passt genau in dieses Modell: Eine Library, die auf ein externes Script zeigt, setzt eine Chat-Bubble in die Ecke jeder Seite, die das Theme ausgibt. Der Agent antwortet aus dem, was du ihm gibst, etwa deinen veröffentlichten Seiten, PDFs und Q&A-Paaren, und sagt offen, wenn er etwas nicht weiß. Farben, Position und Begrüßung verwaltest du in intoCHAT, die Änderung am Theme machst du also nur einmal.

intoCHAT auf Drupal installieren

  1. Agenten erstellen und trainieren

    Registriere dich bei intoCHAT, erstelle einen Agenten und gib im Tab Knowledge die Adresse deiner Drupal-Website ein. intoCHAT findet deine Seiten über Sitemap und Links, und Pfade wie /user schließt du per Muster aus.

  2. Agenten-ID kopieren

    Öffne den Tab Share und kopiere die Agenten-ID aus dem Code unter Bubble Chat. Für die Library brauchst du nur die ID.

  3. Library deklarieren

    Füge in deinem eigenen Theme oder Sub-Theme einen Eintrag chat_widget in THEME.libraries.yml hinzu, der das Script als externe Datei mit dem Attribut data-chatbot-id lädt, wie unten gezeigt.

  4. Auf jeder Seite einbinden

    Trag THEME/chat_widget in die libraries-Liste in THEME.info.yml ein. Drupal lädt JavaScript aus Libraries standardmäßig im Footer, und genau dort muss das Script laufen.

  5. Caches leeren und prüfen

    Leere alle Caches unter Configuration > Development > Performance oder mit drush cr. Lade deine Website neu: Die Chat-Bubble erscheint unten in der Ecke, mit den Farben und der Position aus dem Tab Appearance.

Die Library-Definition

# THEME.libraries.yml
chat_widget:
  js:
    https://www.intochat.ai/api/embed.js:
      type: external
      attributes:
        data-chatbot-id: 'YOUR_AGENT_ID'

# THEME.info.yml: zur bestehenden libraries-Liste hinzufügen
libraries:
  - THEME/chat_widget

Ersetze THEME durch den Maschinennamen deines Themes. Setz kein header: true: Das Script hängt die Chat-Bubble an den Body der Seite, sobald es läuft, deshalb muss es im Footer laden. Drupal schreibt data-chatbot-id in den Script-Tag, und genau dort liest das Script deine Agenten-ID.

Was der Agent auf deiner Drupal-Website macht

  • Lernt aus deinen Drupal-Seiten

    Gib deine Website-Adresse ein, und intoCHAT findet über Sitemap und Links bis zu 500 Seiten. Schließ Pfade per Muster aus, damit Admin-, Login- oder Suchseiten draußen bleiben.

  • Liest deine veröffentlichten Dateien

    Lade die PDFs, Word-Dateien und Tabellen hoch, auf die deine Website verlinkt, oder füge Textbausteine und Q&A-Paare hinzu. Q&A-Antworten haben Vorrang vor anderen Quellen.

  • Stellt wichtige Quellen nach vorn

    Markiere eine Quelle mit einem Stern, etwa deine FAQ- oder Preisseite, damit sie in Antworten höher gewichtet wird. Ohne erneutes Training.

  • Ruft deine Endpunkte auf

    Mit eigenen API-Aktionen ruft der Agent während des Chats einen HTTP-Endpunkt auf, etwa eine REST- oder JSON:API-Route, die du bereitstellst. Du wählst die Authentifizierung und welche Felder der Antwort das Modell sieht.

  • Sammelt Leads im Chat

    Ein kurzes Formular im Gespräch fragt nach E-Mail-Adresse oder Telefonnummer, nach Regeln, die du festlegst. Jeder neue Lead geht per E-Mail an dich und bis zu fünf Kolleginnen und Kollegen.

  • Antwortet in der Sprache des Besuchers

    Der Agent antwortet in der Sprache, in der Besucher schreiben, das passt gut zu mehrsprachigen Drupal-Websites.

Häufige Fragen

Gibt es ein intoCHAT-Modul für Drupal?

Nein. intoCHAT lädt über eine Library in deinem Theme, dafür reichen ein paar Zeilen YAML und kein zusätzliches Modul. Nutze dein eigenes Theme oder ein Sub-Theme, damit Updates eines fremden Themes die Änderung nicht überschreiben.

Warum muss die Library im Footer laden?

Das Script hängt die Chat-Bubble an den Body der Seite, sobald es läuft, der Body muss dann also schon existieren. Drupal lädt JavaScript aus Libraries standardmäßig im Footer, nur header: true würde es in den Head verschieben, lass diese Einstellung also weg.

Macht intoCHAT meine Drupal-Website langsamer?

Das Script ist eine einzelne externe Datei, die Drupal am Ende der Seite ausgibt, nach deinen Inhalten. Das Chatfenster läuft in einem eigenen iframe von intoCHAT, sein Code bleibt also vom JavaScript von Drupal getrennt.

Meine Website sendet eine Content Security Policy. Was muss ich erlauben?

Erlaube www.intochat.ai für script-src, connect-src und frame-src. Das Script lädt von diesem Host, holt dort die Einstellungen deines Agenten und öffnet den Chat in einem iframe von dort.

Warum erscheint die Chat-Bubble nicht, nachdem ich die Library hinzugefügt habe?

Leere zuerst alle Caches, denn Drupal speichert Library-Definitionen und Theme-Infos zwischen. Prüfe dann, ob die Library in der Info-Datei des aktiven Frontend-Themes steht und ob die Agenten-ID mit der im Tab Share übereinstimmt.

Muss ich das Theme ändern, wenn ich den Agenten anpasse?

Nein. Die Library enthält nur deine Agenten-ID. Farben, Position, Begrüßung, Vorschlagsfragen und Wissen lädt das Script bei jedem Seitenaufruf von intoCHAT, deine Änderungen erscheinen also ohne neues Deployment.

Sieh, wie er mit deiner Website antwortet

Gib die Adresse deiner Website ein und chatte mit einem Agenten, der aus deinen Seiten gebaut wird. Das dauert etwa eine Minute.

Agent kostenlos erstellen

Kostenloser Plan, keine Kreditkarte nötig.