Dokumentation

Richte einen Agenten ein, trainiere ihn mit deinen Inhalten und binde ihn in deine Website ein.

Inhalt

Erste Schritte

Überblick
Schnellstart
So entstehen Antworten

Installation

Script-Tag
Next.js und React
WordPress
Shopify
Inline-Einbettung und direkter Link

Referenz

Attribute des Embed-Scripts
Wissensquellen
Lead-Erfassung

Überblick

intoCHAT bringt einen KI-Agenten auf deine Website, der Besucherfragen anhand der Inhalte beantwortet, die du bereitstellst: Seiten deiner Website, Dokumente und Frage-Antwort-Paare, die du selbst schreibst.

Du konfigurierst den Agenten im Dashboard und bindest ihn mit einem einzigen Script-Tag ein. Spätere Änderungen an Wissen, Anweisungen oder Aussehen erreichen deine Website, ohne dass du den Code erneut anfassen musst.

Schnellstart

Vom neuen Konto zum funktionierenden Agenten auf deiner Website.

1
Agenten erstellen
Erstelle ein Konto, öffne Agents und wähle New agent.
2
Wissen hinzufügen
Füge im Tab Knowledge deine Website hinzu, lade Dokumente hoch oder füge Text und Q&As ein. Der Agent antwortet auf Basis dessen, was dort hinterlegt ist, und seiner Anweisungen.
3
Embed-Code kopieren
Kopiere im Tab Share das Script-Tag. Es enthält bereits deine Agenten-ID.
4
In die Website einfügen
Füge das Script direkt vor dem schließenden </body>-Tag ein, auf jeder Seite, auf der der Agent erscheinen soll.
5
Prüfen
Lade deine Website neu. Der Chat-Launcher erscheint in der unteren Ecke, mit den Farben und der Position aus dem Tab Appearance.

HTML

<script
  src="https://www.intochat.ai/api/embed.js"
  data-chatbot-id="YOUR_AGENT_ID"
></script>

So entstehen Antworten

Wenn du Wissen hinzufügst, teilt intoCHAT es in Abschnitte auf und indexiert sie. Zu jeder Besucherfrage werden die passendsten Abschnitte abgerufen und zusammen mit deinen Anweisungen an das Sprachmodell übergeben, das daraus seine Antwort formuliert.

Wird nichts Passendes gefunden, sagt der Agent, dass er die Antwort nicht bestätigen kann, statt zu raten, und verweist auf einen Kontaktweg, falls du einen eingerichtet hast. Deine Wissensbasis gilt als Referenzmaterial, nie als Anweisung, daher kann Text auf einer Seite das Verhalten des Agenten nicht ändern.

Begriffe im Dashboard

Anweisungen: Rolle, Ton und Grenzen des Agenten in einfacher Sprache. Zum Beispiel: in der Sprache des Besuchers antworten, kurz bleiben, Rechnungsfragen an die Support-Adresse verweisen.
Aktionen: Aufrufe einer HTTP-API, die du konfigurierst, etwa um eine Bestellung nachzuschlagen, oder Funktionen, die auf deiner eigenen Seite laufen. Der Agent nutzt jede nur für die Anfragen, für die sie gedacht ist.
Lead-Erfassung: Ein Formular im Gespräch, das nach E-Mail-Adresse oder Telefonnummer fragt. Wann es erscheint, steht unter Lead-Erfassung.

Script-Tag

Funktioniert auf jeder Website, deren HTML du bearbeiten kannst, auch in den Custom-Code-Einstellungen von Webflow, Squarespace und Wix. Füge es einmal in einen globalen Footer oder ein Layout ein, damit es auf jeder Seite lädt.

HTML

<script
  src="https://www.intochat.ai/api/embed.js"
  data-chatbot-id="YOUR_AGENT_ID"
></script>

Next.js und React

Lade das Script in einem Next.js-Projekt mit App Router einmal im Root-Layout über next/script. Die Strategie lazyOnload hält es aus dem kritischen Rendering-Pfad heraus.

app/layout.tsx

import Script from 'next/script'

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script
          src="https://www.intochat.ai/api/embed.js"
          data-chatbot-id="YOUR_AGENT_ID"
          strategy="lazyOnload"
        />
      </body>
    </html>
  )
}

In anderen React-Apps wie Vite oder Create React App fügst du das Script-Tag in index.html ein. Es lädt einmal und bleibt bei clientseitigen Seitenwechseln erhalten.

WordPress

Nutze das offizielle Plugin, das das Script auf jeder Seite für dich einfügt: intochat.ai auf WordPress.org

1
Gehe in deinem WordPress-Admin zu Plugins → Installieren.
2
Suche nach intochat.ai, installiere und aktiviere das Plugin.
3
Gehe zu Einstellungen → intochat.ai und trage die Agenten-ID aus dem Tab Share ein.

Shopify

Füge das Script-Tag in dein Theme ein, damit es auf jeder Seite deines Shops lädt.

1
Gehe im Shopify-Admin zu Onlineshop → Themes, öffne das Menü deines aktiven Themes und wähle Code bearbeiten.
2
Öffne im Ordner Layout die Datei theme.liquid.
3
Füge das Script direkt vor dem schließenden </body>-Tag ein und speichere.

layout/theme.liquid

<script
  src="https://www.intochat.ai/api/embed.js"
  data-chatbot-id="YOUR_AGENT_ID"
></script>

Inline-Einbettung und direkter Link

Um den Chat innerhalb einer Seite statt als schwebenden Launcher anzuzeigen, bette ihn in ein iframe ein. Beide Snippets findest du auch im Tab Share, mit deiner Agenten-ID ausgefüllt.

HTML

<iframe
  src="https://www.intochat.ai/agent/YOUR_AGENT_ID"
  width="100%"
  height="600px"
  frameborder="0"
></iframe>

Direkter Link

Jeder Agent hat außerdem eine eigene Seite, die du als Link oder QR-Code teilen kannst:

URL

https://www.intochat.ai/agent/YOUR_AGENT_ID

Attribute des Embed-Scripts

Das Script liest ein einziges Attribut. Alles andere, etwa Farben, Position des Launchers, Icon und Begrüßung, legst du im Tab Appearance fest. Es wird beim Öffnen der Seite geladen, Änderungen greifen also, ohne dass du deine Website bearbeitest.

Attribut	Pflicht	Beschreibung
`data-chatbot-id`	Ja	Die ID des zu ladenden Agenten, angezeigt im Tab Share.

Wissensquellen

Quellen fügst du im Tab Knowledge hinzu. Wie viel möglich ist, hängt von deinem Plan ab, siehe Preise.

Quelle	Details
Website	Gib eine URL ein und wähle aus, welche der auf der Website gefundenen Seiten gelesen werden. Pro Crawl werden bis zu 500 Seiten gefunden.
Dateien	PDF, Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, Text und Markdown.
Text	Beliebiger eingefügter Text, etwa eine Richtlinie oder eine Produktbeschreibung.
Q&A	Frage-Antwort-Paare für Antworten, deren Wortlaut genau feststehen soll.

Lead-Erfassung

Ist die Lead-Erfassung aktiv, kann der Agent im Gespräch ein Formular zeigen, das nach den aktivierten Feldern fragt: E-Mail-Adresse, Telefonnummer oder beides. Der Auslöser bestimmt, wann es erscheint.

Auslöser	Verhalten
Manuell	Nur wenn der Besucher um Kontakt bittet oder seine Daten anbietet.
KI	Der Agent entscheidet, wann er fragt, anhand deiner Beschreibung eines guten Leads.
Regeln	Nach einer festgelegten Zahl von Besuchernachrichten oder wenn der Besucher eines deiner Schlüsselwörter verwendet (bis zu 20).
Hybrid	Regeln und KI kombiniert.

Das Formular erscheint höchstens dreimal pro Gespräch, immer unter der Antwort des Agenten. Übermittelte Daten findest du im Tab Leads.

Brauchst du Hilfe?

Schreib an support@intochat.ai und gib deine Agenten-ID an.