Doku
Alles, was du brauchst, um Ontara auf deine Website zu bringen und Besuchern in jeder Sprache zu antworten.
Widget installieren
Melde dich an, erstelle einen Workspace und öffne im Dashboard Chat-Widget. Kopiere dein Snippet und füge es auf jeder Seite vor </body> ein:
<script src="https://YOUR-LINGLY-HOST/w.js" data-site="pk_your_site_key" async></script>Das Widget funktioniert nur auf der registrierten Domain und ihren Subdomains (zum Beispiel deckt example.com auch shop.example.com ab). Öffne vor der Installation die Testseite im Dashboard, um es auszuprobieren.
WordPress
Installiere das Ontara-Plugin für WordPress, oder füge dasselbe Snippet mit einem beliebigen Plugin für Header- und Footer-Scripts ein.
Single-Page-Apps
Füge das Script einmal in dein HTML-Template ein. Es funktioniert auch bei Routenwechseln im Client weiter.
JavaScript-API
Sobald das Script geladen ist, steht ein kleines globales Objekt bereit:
| Aufruf | Was er tut |
|---|---|
lingly.open() | Öffnet das Chatfenster, zum Beispiel über deinen eigenen „Kontakt“-Button. |
lingly.close() | Schließt das Chatfenster. |
lingly.identify({ userId, email, name, hash }) | Teilt Ontara mit, wer der Besucher ist. Siehe Identitätsprüfung. |
lingly.reset() | Vergisst den Besucher, zum Beispiel wenn sich ein Nutzer abmeldet. |
lingly.shutdown() | Entfernt das Widget von der Seite. |
Übersetzung
Lege die Teamsprache unter Team fest. Schreibt ein Besucher in einer anderen Sprache, wird die Nachricht für dein Team übersetzt, und das Original ist einen Klick entfernt. Deine Antworten werden vor der Zustellung in die Sprache des Besuchers übersetzt. Auch die Willkommensnachricht und automatische Antworten werden übersetzt.
Die Übersetzung schaltest du unter Automatisierung ein oder aus. Die Buttons des Widgets folgen der Browsersprache des Besuchers (Englisch, Chinesisch, Spanisch, Portugiesisch, Französisch, Deutsch, Japanisch, Koreanisch und Italienisch) oder einer Sprache, die du festlegst.
KI-Antworten
- Füge Inhalte unter Wissensdatenbank hinzu: Fragen und Antworten, die URL einer Webseite oder freien Text.
- Prüfe mit KI ausprobieren auf derselben Seite, wie sie antworten würde.
- Wähle unter Automatisierung, wann die KI antwortet: nur wenn niemand online ist, oder immer zuerst.
Die KI antwortet nur aus deiner Wissensdatenbank und in der Sprache des Besuchers. Kann sie nicht antworten oder möchte der Besucher mit einem Menschen sprechen, übergibt sie das Gespräch an dein Team und antwortet in diesem Gespräch nicht mehr. Sie hört auch auf, sobald jemand aus dem Team antwortet.
Wenn du nicht da bist
- Abwesenheitsnachricht: wird automatisch gesendet, wenn niemand aus deinem Team online ist.
- E-Mail-Abfrage: Das Widget fragt den Besucher nach seiner E-Mail (nie, wenn du nicht da bist, oder immer).
- E-Mail-Follow-up: Ist der Besucher gegangen und hat eine E-Mail hinterlassen, wird ihm deine Antwort etwa zwei Minuten später per E-Mail geschickt.
- Team-Benachrichtigungen: Wartet ein Besucher einige Minuten und niemand ist online, bekommen Teammitglieder mit aktivierten E-Mail-Benachrichtigungen eine Nachricht.
Team und Rollen
| Rolle | Darf |
|---|---|
| Inhaber | Alles, auch die Abrechnung. |
| Admin | Einstellungen, Wissensdatenbank, Websites, Einladungen und Abrechnung. |
| Agent | Gespräche beantworten und die Wissensdatenbank lesen. |
Lade Personen unter Team ein. Sie treten bei, indem sie sich mit der eingeladenen E-Mail-Adresse anmelden. Jeder Tarif hat unbegrenzt viele Agents.
Tarife und Limits
Was jeder Tarif enthält, siehst du unter Preise. Ist ein Monatslimit erreicht, läuft der Live-Chat weiter; KI-Antworten und Übersetzung pausieren bis zum nächsten Monat oder bis du upgradest. Gespräche, die älter sind als der Verlaufszeitraum deines Tarifs, werden automatisch gelöscht.
Identitätsprüfung
Ist ein Besucher auf deiner Website angemeldet, kannst du Ontara mitteilen, wer er ist, und es nachweisen. So kann sich niemand als einer deiner Nutzer ausgeben.
- Schalte sie unter Chat-Widget → Identitätsprüfung ein und kopiere das Secret. Bewahre es nur auf deinem Server auf.
- Berechne auf deinem Server
hex(HMAC-SHA256(secret, userId)). - Rufe auf der Seite
lingly.identify({ userId, email, name, hash })auf.
// Node.js
import { createHmac } from "node:crypto";
const hash = createHmac("sha256", process.env.LINGLY_IDENTITY_SECRET).update(user.id).digest("hex");
// PHP
$hash = hash_hmac('sha256', $userId, getenv('LINGLY_IDENTITY_SECRET'));Agents sehen neben dem Besucher ein Verifiziert-Abzeichen. Ein Aufruf mit falschem Hash wird abgelehnt. Besucher, die nur ihre E-Mail im Chat eintippen, gelten nicht als verifiziert.
Antworten per E-Mail
Wird deine Antwort einem Besucher geschickt, der schon gegangen ist, kann er einfach auf diese E-Mail antworten. Seine Antwort erscheint im selben Gespräch, zitierter Text und Signaturen werden entfernt.
Dafür brauchst du eine Empfangsdomain. Leite in Cloudflare Email Routing r-*@reply.your-domain.com an den Ontara-Worker weiter und setze INBOUND_EMAIL_DOMAIN=reply.your-domain.com. Nur die eigene Adresse des Besuchers kann in sein Gespräch schreiben; automatische Antworten und Bounces werden ignoriert.
Benachrichtigungen
Unter Konto → Browser-Benachrichtigungen kann jedes Teammitglied Benachrichtigungen für das Gerät einschalten, das es gerade nutzt. Schreibt ein Besucher, während der Posteingang nicht geöffnet ist, erscheint eine Benachrichtigung; ein Klick öffnet das Gespräch. E-Mail-Benachrichtigungen (unter Team) bleiben als Rückfallebene aktiv.
React
Installiere @lingly/react, setze <LinglyChat siteKey="pk_..." user={...} /> in deine Root-Komponente und hole dir mit useLingly() open, close, identify und reset. Meldet sich der Nutzer ab (user wird null), vergisst das Widget den Besucher. Das Paket ist noch nicht auf npm veröffentlicht; bis dahin erledigt die JavaScript-API dasselbe in jeder React-App.
WordPress
- Lade das Plugin herunter und gehe in WordPress zu Plugins → Neues Plugin hinzufügen → Plugin hochladen.
- Aktiviere es und öffne Einstellungen → Ontara Chat.
- Füge deinen Site-Key ein. Optional fügst du auch das Secret der Identitätsprüfung ein, damit angemeldete WordPress-Nutzer als verifiziert erscheinen.
REST-API
Erstelle unter Entwickler einen Schlüssel und sende ihn bei jeder Anfrage mit Authorization: Bearer lk_.... Es gibt Endpunkte für deine Websites, Gesprächslisten und -details, Nachrichten lesen, als Team antworten (die Antwort wird für den Besucher übersetzt), schließen und wieder öffnen, Gespräche löschen und Besucherdetails. Jeder Schlüssel erlaubt 120 Anfragen pro Minute. Die vollständige Referenz steht in der englischen Version.
Webhooks
Füge unter Entwickler einen https-Endpunkt hinzu und wähle die gewünschten Ereignisse. Jedes Ereignis kommt als JSON-POST mit dem Header Lingly-Signature: t=Zeitstempel,v1=Signatur; die Signatur ist hex(HMAC-SHA256(secret, t + "." + rawBody)). Antworte mit einem beliebigen 2xx-Status. Fehlgeschlagene Zustellungen werden etwa 20 Minuten lang wiederholt, und ein Endpunkt, der dauerhaft fehlschlägt, wird pausiert. Ein Ereignis kann gelegentlich doppelt ankommen, nutze also id, um Duplikate zu überspringen.