Wie veröffentliche ich einen Agenten und teile ihn mit Kunden?

Entwurf und veröffentlicht

Jeder Agent ist entweder „Entwurf“ oder „Veröffentlicht“. Neue Agenten, aus Vorlagen hinzugefügte Agenten und mit „Agent duplizieren“ erstellte Kopien beginnen als Entwurf. Der Shop-Agent, der beim Verbinden Ihres Shops automatisch erstellt wird, beginnt veröffentlicht, als erste Version (v1).

Entwürfe sind für Besucher nicht zugänglich: Der öffentliche Link, der in Ihre Website eingebettete Chat und der Shop-Agent funktionieren nicht. Nur Mitglieder Ihres Arbeitsbereichs können den Link eines Entwurfs öffnen; einen Entwurf können Sie auch mit „Vorschau“ testen.

Bei einem veröffentlichten Agenten ist das, woran Sie im Editor arbeiten, der Entwurf; Besucher sehen die zuletzt veröffentlichte Version. „Speichern“ sichert Ihre Änderung nur im Entwurf, und in der Kopfzeile erscheint das Abzeichen „Unveröffentlichte Änderungen“; Besucher erreicht die Änderung, wenn Sie auf „Veröffentlichen“ klicken.

„Veröffentlichung zurücknehmen“ macht den Agenten wieder zum Entwurf und stoppt all das; Sie werden zuerst um Bestätigung gebeten. Der Knopf steht im Menü des Pfeils neben „Veröffentlichen“ in der Kopfzeile des Editors und unten im Fenster „Versionen“ (geöffnet über das Drei-Punkte-Menü).

Testen und veröffentlichen

1. Klicken Sie im Editor auf „Vorschau“. Der Agent wird gespeichert, und der Entwurf öffnet sich frisch in einem neuen Tab.
2. Gehen Sie den Agenten wie ein Besucher von Anfang bis Ende durch; prüfen Sie verschiedene Sprachen und Geräte.
3. Finden Sie ein Problem, gehen Sie zurück in den Editor und beheben Sie es. Am besten beseitigen Sie die Warnungen auf der Arbeitsfläche („Probleme in {n} Schritten“) vor dem Veröffentlichen.
4. Wenn er fertig ist, klicken Sie oben rechts im Editor auf „Veröffentlichen“. Im Fenster können Sie einen „Versionshinweis“ hinzufügen (zum Beispiel Preisfrage korrigiert; bis zu 500 Zeichen); der Hinweis erscheint in der Liste „Versionen“.
5. Bestätigen Sie. Der Agent wird zuerst gespeichert, dann geht der gespeicherte Entwurf als neue nummerierte Version live (v1, v2, …). Ist der Entwurf identisch mit der Live-Version, wird keine neue Version erstellt.

Auf der Seite „Agenten“ können Sie einen Entwurf auch über das Drei-Punkte-Menü der Zeile mit „Veröffentlichen“ veröffentlichen; das veröffentlicht den zuletzt gespeicherten Stand.

Wenn Sie einen Agenten zum ersten Mal veröffentlichen, öffnet sich ein Fenster mit seinem Link und dem Code zum Hinzufügen zu Ihrer Website. In Arbeitsbereichen mit verbundenem Shop erscheint dieses Fenster nicht.

Die Vorschau zeigt den Entwurf und ändert den veröffentlichten Agenten nicht; bei einem veröffentlichten Agenten können Sie also auch eine große Änderung testen, bevor Besucher sie sehen. Schritte „Sub-Flow“ laufen in der Vorschau mit den Live-Versionen dieser Agenten.

Versionen und Rückkehr zu einer früheren

„Versionen“, geöffnet über das Drei-Punkte-Menü oben rechts im Editor, listet alle Versionen des Agenten auf: Nummer, wer sie wann veröffentlicht hat und den Versionshinweis. Die Version, die Besucher gerade sehen, ist mit „Live“ markiert; ist der Agent nicht veröffentlicht, trägt die zuletzt veröffentlichte Version die Markierung „Zuletzt veröffentlicht“. Jede Version hat:

• „Was sich geändert hat“: vergleicht die Version mit der vorherigen und zeigt hinzugefügte, geänderte und entfernte Schritte sowie andere Änderungen (Startschritt, Agenten-Sprache, Übersetzungen, Avatar, Aussehen, Bewertung, Schrittpositionen auf der Arbeitsfläche).
• „Live schalten“: zum Zurückrollen. Neue Besucher sehen diese Version; Ihr Entwurf ändert sich nicht. Bei einem nicht veröffentlichten Agenten veröffentlicht das den Agenten auch wieder mit dieser Version.
• „In den Entwurf laden“: Der Inhalt der Version ersetzt den Entwurf; ungespeicherte und unveröffentlichte Änderungen gehen verloren. Die Live-Version ändert sich nicht; klicken Sie danach auf „Veröffentlichen“, um ihn Besuchern zu zeigen.

Hat der Entwurf unveröffentlichte Änderungen, weist ein Feld oben im Fenster darauf hin: „Was sich geändert hat“ zeigt den Unterschied zur Live-Version, und „Änderungen verwerfen“ setzt den Entwurf auf die Live-Version zurück.

Eine Version enthält Schritte, Startschritt, Hauptsprache, Übersetzungen, Avatar, Aussehen, Bewertung und die Einstellung der Stimmungsanalyse des Agenten. Name, Beschreibung und Symbol des Agenten sowie die „Messeinstellungen“ gehören nicht zu einer Version; sie wirken sofort nach dem Speichern.

Wenn Sie eine neue Version veröffentlichen oder eine frühere live schalten, enden bereits laufende Gespräche auf der Version, mit der sie begonnen haben; neue Besucher bekommen die neue Version.

Veröffentlichen, „Live schalten“, „In den Entwurf laden“, „Änderungen verwerfen“ und „Veröffentlichung zurücknehmen“ stehen dem Inhaber und Administratoren offen; alle können die Versionen und die Änderungen sehen. Veröffentlichungen und Rücknahmen erscheinen auch im Protokoll als „Neue Agenten-Version veröffentlicht“ und „Live-Version des Agenten geändert“.

Der öffentliche Link

Jeder Agent hat einen öffentlichen Link. Öffnen Sie auf der Seite „Agenten“ das Drei-Punkte-Menü in der Zeile des Agenten und wählen Sie „Öffentlichen Link kopieren“; der Link wird in die Zwischenablage kopiert. Der Link funktioniert nur bei einem veröffentlichten Agenten; bei einem Entwurf ist die Option deaktiviert. Setzen Sie ihn hinter einen Knopf auf Ihrer Website, in eine E-Mail, einen QR-Code oder einen Social-Media-Beitrag.

• Öffnet ein Besucher den Link, startet das Gespräch im Browser, ohne App; der Avatar spricht, und der Besucher antwortet per Tippen oder Mikrofon.
• Legen Sie die Sprache mit einem Präfix nach der Domain fest: /en/ oder /ar/ (zum Beispiel …/en/<Agenten-ID>). Ohne Präfix wird die Sprache in dieser Reihenfolge gewählt: die zuvor vom Besucher gewählte Sprache; die Browsersprache, wenn sie eine Sprache des Agenten ist; Englisch, wenn der Agent es hat; sonst die Hauptsprache des Agenten. Siehe Sprachen und Übersetzung.
• Fügen Sie UTM-Tags hinzu, um Kampagnen zu unterscheiden (zum Beispiel ?utm_source=instagram&utm_campaign=spring). Die Ergebnisse sehen Sie im Tab „Analyse“.

Nehmen Sie die Veröffentlichung zurück oder löschen Sie den Agenten, funktioniert der Link nicht mehr. Der Link ist öffentlich; denken Sie daran bei Agenten, die sensible Informationen verarbeiten. Agenten-Seiten sind für Suchmaschinen verborgen.

Zu Ihrer Website hinzufügen

Um den Agenten als Knopf, der sich in der Ecke öffnet, zu Ihrer eigenen Website hinzuzufügen, wählen Sie „Zur Website hinzufügen“ über den Pfeil neben „Veröffentlichen“ im Flow-Editor oder im Drei-Punkte-Menü in der Zeile des Agenten auf der Seite „Agenten“. Das ist in jedem Plan verfügbar. Ist der Agent ein Entwurf, bekommen Sie den Code trotzdem, aber der Agent erscheint auf Ihrer Website als geschlossen, bis Sie den Agenten veröffentlichen.

1. Wählen Sie unter „Darstellung wählen“ „Untere Ecke“ oder „Großes Fenster“: „Untere Ecke“ fügt eine Schaltfläche hinzu, die ein Chatfeld öffnet, und „Großes Fenster“ öffnet sich in der Bildschirmmitte.
2. Tragen Sie unter „Ihre Websites freigeben“ Ihre Domain ein (z. B. example.com) und klicken Sie auf „Hinzufügen“. Die Versionen mit und ohne www werden beide hinzugefügt; für alle Subdomains tragen Sie *.example.com ein. Websites gelten für alle Ihre Agenten, Sie fügen sie also nur einmal hinzu.
3. Der Code erscheint, sobald Sie mindestens eine Website hinzugefügt haben. Klicken Sie auf „Code kopieren“ und fügen Sie ihn einmal in Ihre Website-Vorlage ein, direkt vor dem Tag </body>. Der Agent erscheint auf jeder Seite, und das Gespräch läuft weiter, wenn der Besucher zwischen Seiten wechselt.

Wo Sie den Code einfügen, hängt davon ab, womit Ihre Website erstellt wurde. Schritt-für-Schritt-Anleitungen: WordPress, Wix, Squarespace, Webflow, Weebly, Joomla, Google Tag Manager.

Der Agent öffnet sich nur auf den freigegebenen Websites; wer den Code auf eine andere Website kopiert, sieht dort nicht einmal den Agenten-Knopf. Hat Ihre Website eine weitere Domain, fügen Sie auch diese hinzu. Ihre Websites sehen und entfernen Sie im Menü unter „Konto“ › „Unternehmen“ › „Ihre Websites“; auf einer entfernten Website öffnet sich der Agent innerhalb einer halben Minute nicht mehr. „Zur Website hinzufügen“ und das Entfernen von Websites stehen nur dem Inhaber und Administratoren offen.

Wenn Sie einen Shop haben, sind die Integrationen einfacher: Verbinden Sie einen Shop mit Shopify, WooCommerce oder Magento, wird der Agent zur Storefront hinzugefügt und läuft mit dem eigenen Agenten des Shops. Bei Shopify schalten Sie den Agenten zum Beispiel unter App embeds im Theme-Editor ein, und „Shop-Agenten bearbeiten“ auf der Shop-Seite öffnet diesen Agenten im Editor.

Details finden Sie in den Shop-Artikeln: Shopify verbinden, WooCommerce verbinden, Magento verbinden.

Häufige Fragen

• Warum sehe ich meine Änderung nicht über den Link? Vielleicht haben Sie sie gespeichert, aber nicht veröffentlicht. Zeigt die Kopfzeile des Editors das Abzeichen „Unveröffentlichte Änderungen“, klicken Sie auf „Veröffentlichen“ und laden Sie die Seite neu.
• Warum können Besucher den Link nicht öffnen? Der Agent ist vielleicht ein Entwurf. Prüfen Sie das Status-Abzeichen im Editor oder in der Liste und veröffentlichen Sie den Agenten mit „Veröffentlichen“.
• Wie gehe ich zu einer früheren Version zurück? Öffnen Sie „Versionen“ im Drei-Punkte-Menü und klicken Sie bei der gewünschten Version auf „Live schalten“. Neue Besucher sehen diese Version; Ihr Entwurf bleibt, wie er ist.
• Nutzt die Vorschau meinen früheren Test wieder? Nein. Jede Vorschau startet eine neue Sitzung; nutzen Sie „Vorschau“ also jedes Mal, wenn Sie sauber testen möchten.
• Wer kann veröffentlichen? Der Inhaber und Administratoren; nur sie können auch die Veröffentlichung zurücknehmen oder eine frühere Version live schalten. Nutzer mit der Rolle Support oder Beobachter können den Link eines veröffentlichten Agenten kopieren und Vorschau sowie Versionen öffnen, aber keine Änderungen speichern.