Ihren Assistant testen, bevor er live geht
Testen Sie Ihren echten Assistant – verankert in Ihren echten Inhalten – direkt in Ihrer lokalen oder Staging-App, ohne auch nur eine einzige abgerechnete Konversation zu verbrauchen. Wenn er so antwortet, wie Sie es wollen, aktivieren Sie ihn und veröffentlichen das normale Snippet.
Sandbox-Testing ist ein Preview-Feature. Wenn die unten beschriebenen Schritte noch nicht funktionieren, ist es in Ihrer Umgebung einfach noch nicht aktiviert – fragen Sie uns, dann schalten wir es frei.
So funktioniert es
Die Sandbox richtet Ihren Assistant mit einem kurzlebigen Preview-Token auf Ihre eigene Dev- oder Staging-Seite aus. Traffic, der über dieses Token läuft,
- nutzt die echte Antwort-Pipeline – Retrieval, Grounding, CTA, Spracherkennung – also genau das, was auch Ihre Besucher bekommen;
- wird niemals abgerechnet und fließt nie in Ihre Live-Analytics, CSAT oder Leads ein;
- erreicht Ihren Assistant noch bevor Sie ihn live schalten, sodass Sie den End-to-End-Flow vorab testen können.
Schritte
1. Ein Preview-Token erzeugen
Öffnen Sie im Dashboard den Installation-Schritt Ihres Assistants und klicken Sie unter Test in your own app auf Generate sandbox snippet. Sie erhalten ein Embed-Snippet, das data-olotalk-sandbox-token enthält. Das Token ist auf genau diesen Assistant beschränkt, läuft nach 7 Tagen ab und kann jederzeit neu erzeugt werden.
2. In Ihre lokale oder Staging-App einfügen
Fügen Sie das Sandbox-Snippet in eine Seite ein, die Sie gerade entwickeln – localhost, ein Preview-Build oder ein Staging-Hostname:
<script
src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
data-olotalk-sandbox-token="…"
async
></script>
Sie müssen Ihren Dev- oder Staging-Hostnamen nicht zu Installationsdomains hinzufügen. Der Token ist es, der den Zugriff gewährt; darum funktioniert es auf localhost und Staging direkt ohne weitere Konfiguration.
3. Realistisch testen
Öffnen Sie die Seite und chatten Sie mit dem Assistant. Stellen Sie die Fragen, die auch Ihre Besucher stellen werden; prüfen Sie, ob die Antworten in Ihren Inhalten verankert sind, ob CTAs an den richtigen Stellen erscheinen und ob sich die Spracherkennung korrekt verhält. Nichts davon wird abgerechnet.
4. Live schalten
Wenn alles passt, veröffentlichen Sie den Assistant. Wenn Ihr Dashboard einen Go live-Button zeigt, klicken Sie ihn an. Danach binden Sie auf Ihrer Produktionsseite das normale Snippet – ohne Sandbox-Token – ein:
<script
src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
async
></script>
Gut zu wissen
- Nicht abgerechnet, aber begrenzt. Sandbox-Konversationen zählen nicht auf Ihren Plan. Sie werden pro Assistant rate-limitiert, damit ein geteiltes oder geleaktes Token keine Kosten hochtreibt; wenn Sie beim Testen an das Limit stoßen, warten Sie einfach ein paar Minuten.
- Isoliert. Sandbox-Chats erscheinen nie in Ihren Live-Konversationen, Analytics oder Leads. Sobald Sie einige ausgeführt haben, taucht auf Ihrer Billing-Seite ein separater Zähler sandbox test conversations auf.
- Das Token ist ein Geheimnis. Verwenden Sie es nur in Ihrem Dev- oder Staging-Embed, niemals auf Ihrer Produktionsseite. Es läuft von selbst ab; erzeugen Sie jederzeit ein neues.
- Auf Ihrer Live-Seite funktioniert es absichtlich nicht. Sobald der Assistant active ist, wird das Sandbox-Token von jeder Origin abgelehnt, die Sie unter Installationsdomains registriert haben. Diese Besucher erhalten dann normale Live-Konversationen. Wenn also ein Sandbox-Snippet versehentlich in Produktion landet, bekommt Ihr echter Traffic trotzdem normale Antworten, wird normal abgerechnet und erscheint im Dashboard – er wird nicht stillschweigend als Test-Traffic verschluckt.
- Bewusst begrenzt. An allen anderen Orten funktioniert das Token von jeder Origin aus, was es auf
localhostund Preview-Builds ohne Allowlisting praktisch macht. Es bleibt begrenzt, weil es auf einen einzelnen Assistant beschränkt ist, von selbst abläuft, nie abgerechnet wird und zusätzlich rate-limitiert ist.
Sie möchten lieber ohne Token testen? Sie können den live Assistant auch auf einer Staging- oder Preview-Seite laden, die Sie bereits allowlistet haben. Siehe Troubleshooting → Auf einer Preview-Seite testen. Diese Konversationen zählen wie jeder andere Traffic zu Ihrem Plan; die Sandbox oben ist der nicht abgerechnete Pfad.