Wo der Assistant erscheint
Olotalk bleibt ein einziger Assistant: Er antwortet aus Ihren Inhalten, zitiert seine Quellen und lehnt ehrlich ab, wenn Ihre Inhalte die Frage nicht abdecken. Das ändert sich nie.
Was sich ändert, ist die Form, die er auf Ihrer Seite annimmt. Derselbe Assistant kann ein Launcher in der Ecke oder ein Panel in Ihrem eigenen Layout sein. Sie wählen die Form über die Art, wie Sie das Snippet einfügen; Sie konfigurieren kein anderes Produkt.
Die heute verfügbaren Formen
Drei Formen werden neuen Installationen angeboten, Corner bubble, Drawer und Select to ask. Alles Weitere in dieser Tabelle funktioniert weiterhin und bleibt für Assistants unterstützt, die bereits so installiert sind; es wird lediglich nicht mehr aus dem Dashboard heraus angeboten, solange das Angebot fokussiert bleibt. Launcher with starters ist ohnehin keine eigene Form, es ist das, was der Eck-Launcher beim Hover zeigt.
| Form | Sieht aus wie | Gut für |
|---|---|---|
| Corner bubble | Ein schwebender Launcher in der unteren Ecke, der ein Chat-Panel öffnet | Alle Seiten, ohne Layout-Entscheidungen |
| Launcher with starters | Der Eck-Launcher, der beim Hover vorgeschlagene Fragen anbietet | Sites, deren Besucher nicht wissen, was sie fragen sollen, Teil der Corner bubble |
| Inline | Ein Chat-Panel in einem Container in Ihrem eigenen Markup | Eine Seite mit hoher Intent-Signatur – Pricing, Kontakt, Doku, nur für bestehende Installationen |
| Drawer | Volle Höhe, bündig am Rand, schiebt die Seite zur Seite, wenn Platz dafür ist | Ein bewusst platzierter „Ask AI“-Button von Ihnen |
| ⌘K panel | Zentriert über einer abgedunkelten Seite, per Tastenkürzel geöffnet | Technisches Publikum, das ⌘K schon im Reflex hat, nur für bestehende Installationen |
| Corner panel | Das Panel der Corner bubble, im Ruhezustand ohne alles auf der Seite | Websites, die den Assistant erreichbar, aber unsichtbar halten wollen, nur für bestehende Installationen |
| Centred panel | Das ⌘K-Panel, geöffnet durch Ihr eigenes Steuerelement statt durch die Taste | Dieselbe zentrierte Erfahrung, ohne ein Tastenkürzel zu beanspruchen, nur für bestehende Installationen |
| Expand in place | Eine Zeile in Ihrem Text, die sich an Ort und Stelle entfaltet und den Inhalt nach unten schiebt | Eine FAQ oder Doku, wo ein Panel zu viel wäre, nur für bestehende Installationen |
| Anchored | Neben genau einem Element, ohne es je zu verdecken | Ein Tarif oder eine Spezifikationszeile, mit dem Kontext dieses Elements, nur für bestehende Installationen |
| Full page | Der Assistant ist die Seite | Eine dedizierte /ask-Route, nur für bestehende Installationen |
| Docked sidebar | Eine feste Leiste an einer Kante, immer offen | Dokumentation, wo er begleitet statt zu unterbrechen, nur für bestehende Installationen |
| Nav ask field | Ihr eigenes Navigationsfeld, mit dem Assistant verdrahtet | Auffindbar machen, ohne Chrome hinzuzufügen, nur für bestehende Installationen |
| Bottom ask bar | Ihre eigene Leiste am Fuß der Seite | Lange Dokumente, nur für bestehende Installationen |
| Select to ask | Nichts im Ruhezustand, ein Angebot erscheint, wo Besucher Text markieren | Referenzmaterial, wo die Frage diese Passage betrifft |
Alle verwenden dasselbe Bundle, nur eine Konfigurationszeile auseinander (~266 KB gzippt), dieselbe Konversation, dieselbe Verankerung, dieselben Quellenangaben. Nur der Mount unterscheidet sich.
Die meisten installieren Sie aus dem Dashboard; sechs verdrahten Sie in Code. Der Schritt Installation erzeugt ein vollständiges Snippet für jede Form, die von Ihnen nichts außer einem Script-Tag braucht: corner bubble, launcher with starters, inline, expand in place, docked sidebar, full page, ⌘K und select to ask.
Die anderen sechs hängen an etwas, das nur Sie benennen können, darunter die beiden schlichten Panels corner und center, die im Ruhezustand nichts zeichnen und keinen eigenen Trigger haben: ein Drawer öffnet sich von einem Button, den Sie platzieren, anchored muss wissen, um welches Element es geht, und nav ask field wie bottom ask bar sind Ihr eigenes Markup, das an den Assistant übergibt. Ein generiertes Einzeilen-Snippet wäre eine Installation, die nichts tut, das Dashboard sagt das ehrlich und verweist stattdessen auf die Referenz. Setzen Sie mode und rufen Sie open() selbst auf: siehe Assistant API → Shapes.
Eine Mobil-Form wählen Sie nie. Bei Telefonbreite werden Eck-, Drawer-, ⌘K- und Anchored-Mounts zum selben Bottom-Sheet; inline bleibt im Fluss, wo Sie es platziert haben. Ein Embed deckt beides ab. Die Ausnahme ist Select to ask, das auf Touch-Geräten bewusst nichts anbietet: Text markieren öffnet dort das Kopieren-Menü des Systems, und damit konkurrieren wir nicht.
Was eine Form entscheidet
Die Tabelle oben listet die Formen auf. Es lohnt sich, die Regel dahinter zu kennen: Sie erklärt die ganze Familie und beantwortet die meisten „Kann ich …?“-Fragen von allein.
Jede Form beantwortet drei Fragen auf einmal, und mode ist die Art, alle drei mit einem einzigen Wort zu klären:
- Wo das Panel sitzt, wenn es offen ist, eine Ecke, ein Rand, zentriert, neben einem Element, in Ihrem eigenen Layout oder die ganze Seite.
- Was es öffnet, ein Button, den wir zeichnen, ein Tastenkürzel, eine Markierung, Ihr eigener Code, oder gar nichts, weil es bereits offen ist.
- Was auf der Seite steht, bevor irgendetwas davon passiert.
Die dritte erwartet man nicht, deshalb hier vollständig.
Nur zwei Formen setzen einen Button auf Ihre Seite
| Was ein Besucher sieht, bevor irgendetwas passiert | Formen |
|---|---|
| Ein schwebender Launcher in der Ecke | Corner bubble · Launcher with starters |
| Der Assistant selbst, immer sichtbar | Inline · Full page · Docked sidebar |
| Eine Zeile in Ihrem eigenen Text | Expand in place |
| Nichts von uns | Corner panel · Centred panel · Drawer · ⌘K panel · Nav ask field · Bottom ask bar · Anchored · Select to ask |
Die Hälfte der Familie fügt Ihrer Seite nichts hinzu, solange niemand danach fragt. Wenn „keine Chat-Bubble in der Ecke“ eine Anforderung ist, und für viele Websites ist sie das, wählen Sie also unter acht Formen, nicht unter keiner, zwei davon, Corner panel und Centred panel, sind genau das Eck- und das zentrierte Panel ohne den Button.
Die drei Entscheidungen gehören zusammen
Einen mode zu wählen heißt, alle drei gemeinsam zu nehmen. Genau das ist der Sinn, ein Wort statt eines Konfigurationsbildschirms, und zugleich die Grenze: Wie eine Form sich öffnet, zu wählen, heißt zu akzeptieren, wo sie sitzt und was sie auf der Seite hinterlässt.
Zwei Konsequenzen, die man kennen sollte, bevor man darauf plant:
reachfügt Wege hinein hinzu; nichts nimmt einen weg. Sie können einer Corner Bubble ein ⌘K-Kürzel und Markieren-und-fragen zusätzlich zu ihrem Launcher geben, siehe Formen kombinieren, aber Sie können nicht das Eck-Panel der Bubble behalten und ihren Button weglassen.- Markieren-und-fragen ist eine Form, keine Einstellung.
mode="selection"heißt: Die Markierung ist der Assistant, im Ruhezustand steht nichts auf der Seite.reach="selection"heißt: Eine andere Form bekommt einen Markierungs-Trigger und behält, was sie ohnehin zeigte. Der Abschnitt mode gegen reach erklärt den Unterschied, es ist das, was hier am leichtesten verwechselt wird.
Besucher können es in der Größe ändern: und verschieben
Fast jedes Panel, das über der Seite schwebt, lässt sich an seinen Kanten und Ecken in der Größe ändern, und das Panel von Markieren-und-fragen lässt sich zusätzlich an seiner Kopfzeile verschieben. Nichts davon wird konfiguriert: Kein Attribut schaltet es ein, keines schaltet es aus.
Der Drawer ist die Ausnahme: Seine Breite ist genau der Teil der Seite, den er wegnimmt, sein Öffnen verschiebt das Layout der Website ohnehin schon, und diese Breite ziehen zu lassen würde die Seite unter dem umbrechen, was der Besucher gerade liest.
In einem schmalen Fenster legt sich der Drawer über die Seite, statt sie zu
schieben. Das Schieben verschiebt Ihr <body> um die Breite des Drawers, doch
die Breakpoints Ihres Layouts reagieren nur auf das Fenster und sehen nicht,
dass ihr Kasten gerade schmaler geworden ist. Ein Desktop-Layout zeichnet sich
dann in eine tabletbreite Spalte und überlappt sich, eine Navigationsleiste, die
in ihr eigenes Logo läuft, ist das erste Anzeichen. Bliebe der Seite durch das
Schieben weniger als 1024 px, tut der Drawer daher das, was das Sheet auf dem
Telefon ohnehin tut, und legt sich über den Rand. Es gibt nichts zu
konfigurieren, der Wechsel folgt dem Fenster, während der Drawer geöffnet ist,
und die Seite bleibt in beiden Fällen darunter lebendig und scrollbar.
| Form | Größe ändern | Verschieben |
|---|---|---|
| Corner bubble · Launcher with starters · Corner panel · ⌘K panel · Centred panel | ✅ | — |
| Drawer | — | , |
| Select to ask · Anchored | ✅ | ✅ |
| Inline · Expand in place · Full page · Docked sidebar | — | , |
| Jede Form bei Telefonbreite | — | , |
Dass sich weniger verschieben als skalieren lässt, ist Absicht. Eine Corner Bubble behält ihren Launcher auf dem Bildschirm, solange sie offen ist, würde ein Besucher das Panel wegziehen, bliebe der Schließen-Button allein in der Ecke zurück. Markieren-und-fragen hat keinen Launcher daneben und verdeckt bewusst die Passage, um die es geht; es zu verschieben ist der einzige Weg, den ursprünglichen Text wieder zu lesen.
Die gewählte Größe hält bis zum Schließen; die Position wird nie übernommen. Ein Klick auf den Launcher bringt den Assistant zurück in seine Ecke, in der Größe, die der Besucher gewählt hat. Beide Gesten sind Maus-Gesten, ohne Tastatur- Entsprechung.
Die Formen im Fluss sind Ihr Layout; die lassen wir unangetastet.
Markieren-und-fragen funktioniert weiter, während das Panel offen ist. Eine zweite markierte Passage lässt das Angebot erneut erscheinen und fügt sie der laufenden Konversation hinzu, das Panel bewegt sich nicht, und bereits Getipptes bleibt erhalten.
Welche Form soll ich wählen?
Starten Sie mit der Corner bubble. Ein einziges Script-Tag, funktioniert auf jeder Seite, keine Layout-Entscheidungen. Die meisten Websites brauchen nie etwas anderes.
Gehen Sie zu Inline, wenn die Platzierung der Punkt ist. Auf einer Pricing-Seite ist eine Bubble in der Ecke leicht zu ignorieren; ein Chat-Panel unter der Preis-Tabelle wird Teil der Entscheidung. Es ist derselbe Assistant, nur in einem Container gerendert, den Sie kontrollieren.
Und Sie müssen sich nicht auf einen Weg hinein festlegen. Eine Seite mountet eine Form, dort lebt die Konversation, aber darüber lassen sich weitere Trigger legen: Ergänzen Sie das Snippet um data-olotalk-reach="selection,commandk", und Ihre Corner bubble öffnet sich auch, wenn ein Besucher Text markiert oder ⌘K drückt. Ihre eigenen Buttons und Felder können sie ebenfalls öffnen. Wie viele Türen Sie auch hinzufügen: Es bleibt ein Panel und eine Konversation, siehe Formen kombinieren.
Installation auf einer Plattform
Wenn Sie Webflow, Shopify, Ghost, Squarespace, WordPress oder eine andere gehostete Plattform nutzen, gibt es Schritt-für-Schritt-Anleitungen, die berücksichtigen, an welcher Stelle jede Plattform das Einfügen von Scripts erlaubt:
→ Auf Ihrer Plattform installieren
Und wenn Sie die Website gar nicht anfassen können: Die Vollseiten-Form gibt es auch ganz ohne Installation, als gehostete Seite Ihres Assistant:
Was jede Form braucht
Egal, welche Form Sie wählen:
- Eine Assistant-ID. Öffnen Sie im Dashboard Ihren Assistant über Assistants, die ID steht auf seinem Schritt Installation (und in der Seiten-URL).
- Ingestierte Inhalte. Der Assistant kann nur aus Seiten antworten, die Olotalk gecrawlt hat. Ein leerer Korpus führt zu einer ehrlichen, aber nutzlosen „Ich habe dazu nichts“-Antwort.
- Ihre Domain in der Allowlist. Anfragen werden gegen die erlaubten Domains des Assistants geprüft, damit ein kopiertes Snippet nicht auf der Website einer anderen Person benutzt werden kann. Fügen Sie jede Origin hinzu, von der aus Sie Ihre Website ausliefern, sonst erhalten Sie
403 Domain not allowed. Während der Entwicklung ist ein Sandbox-Token dem Allowlisten Ihres Dev-Hosts vorzuziehen (Preview-Feature), Testverkehr bleibt unberechnet und außerhalb Ihrer Analytics.
Wenn der Assistant optisch zu Ihrer Website passen soll – Schrift, Farben, Ecken – sehen Sie sich Theming an. Es sind nur ein paar CSS-Variablen, und sie funktionieren für jede Form gleich.
Bedienung über die Tastatur
Jede Form lässt sich ohne Maus bedienen. Von Ihrer Seite wird nichts beansprucht, solange der Besucher nicht im Assistant ist, mit einer unten genannten Ausnahme.
| Taste | Wirkung |
|---|---|
Enter | Nachricht senden; Shift + Enter fügt einen Zeilenumbruch ein. |
Esc | Während eine Antwort eintrifft: sie stoppen. Sonst: Panel schließen. |
↑ | Im leeren Eingabefeld die letzte Frage zurückholen, bereit zum Bearbeiten. |
⌘K / Ctrl+K | Assistant öffnen, nur bei der ⌘K-Panel-Form oder wenn Sie commandk als Ergänzung hinzugefügt haben. Eine Eckblase beansprucht die Tastenkombination nie. |
Die Reihenfolge von Esc ist Absicht: Während eine Antwort läuft, bricht die
Taste die Antwort ab, nicht das Panel, den ganzen Assistant zu schließen
würde das Gespräch mitnehmen. Nach dem Stoppen schließt dieselbe Taste das Panel
wie gewohnt.
Beim Stoppen wandert Ihre Frage zurück ins Eingabefeld, mit dem Cursor am Ende: Umformulieren wird zur Korrektur statt zum Neutippen. Es ist dieselbe Geste wie die Stopp-Schaltfläche, Tastatur und Maus enden an derselben Stelle.
Stoppen stoppt wirklich. Die Anfrage an das Sprachmodell wird abgebrochen, nicht nur ausgeblendet, und die Teilantwort bleibt sichtbar und als gestoppt gekennzeichnet, damit sie nie für eine vollständige Antwort gehalten wird.