Umfangreiche Einbindung

Neben der beschriebenen Methode, den Chatbot vorkonfiguriert auf der Webseite einzubinden, ist es auch möglich, die Konfiguration selbst zu übernehmen. viind stellt den Webchat selbst als Open-Source-Komponente zur Verfügung, die eigenständig auf der Webseite genutzt werden kann. Die Vorgehensweise sowie Vor- und Nachteile werden hier beschrieben.

Wann lohnt sich die umfangreiche Einbindung?

Über die einfache Einbindung wird der Webchat von viind vorkonfiguriert. Der viind Support kann dadurch folgende Sachen am Webchat verändern:

• Inhalte: Navigationsmenü, unterstützte Sprachen, weitere Kanäle, Kontaktinformationen

• Gestaltung: Icon, Farbe, Position

• Modus: Overlay, eingebettet in die Webseite, Vollbild

Durch die umfangreiche Einbindung müssen diese Punkte selbst konfiguriert werden. Zusätzlich können allerdings folgende Funktionen genutzt werden:

• Customizing: Vollständiges Individualisieren aller Elemente des Webchats

• Interaktion per JavaScript: Steuerung des Webchats durch andere Bestandteile der Webseite

• Dynamischer Start: Konversation kann direkt mit einer gestellten Frage statt der Willkommensnachricht beginnen

Ressourcen

Code

Der Webchat steht als Open-Source-Komponente auf GitLab zur Verfügung. Dort findet sich auch eine ausführliche Dokumentation aller möglichen Parameter: https://gitlab.com/viind/sdp-webchat

Skript

Das Webchat-Skript selbst kann aus dem Git-Repository selbst erstellt und gehostet werden. Alternativ stellt viind alle als Tags gekennzeichneten Versionen zur Verfügung:

https://assets.viind.com/webchat/TAG_VERSION/viind-sdp-webchat.min.js

Als TAG_VERSION kann entweder die volle Versionsnummer angegeben werden (z.B. v3.2.1) oder lediglich die Major-Version (z.B. v3). Für den neuesten Entwicklungsstand kann latest als Versionsnummer genutzt werden.

Konfiguration

Die umfangreiche Einbindung erfordert das eigenständige Konfigurieren des Webchats, wie in der GitLab-Dokumentation beschrieben. Die von viind bereitgestellten Parameter lassen sich allerdings separat abrufen und ggf. verwenden:

https://sdp-knowledge.cluster02.viind.io/public/CUSTOMER_ID/webchatParams.json

Die entsprechende CUSTOMER_ID kann beim viind Support erfragt werden.

Vorgehen

Skript laden

Um den Webchat zu nutzen, muss das entsprechende Skript auf der Webseite geladen werden. Hierzu kann entweder auf ein selbstgehostetes Skript oder die von viind bereitgestellte Variante zurückgegriffen werden.

Codebeispiele finden sich in der Dokumentation im Git-Repository.

Initialisierung

Sobald das Webchat-Skript geladen wurde, muss der Webchat mit den notwendigen Parametern initialisiert werden. Auch hier bietet das Git-Repository eine ausführliche Dokumentation aller Parameter inkl. Codebeispiele.

Als Mindestkonfiguration müssen folgende Parameter gesetzt werden:

• socketUrl: https://sdp-backend.cluster02.viind.io/

• customerId: Die Customer-ID kann beim viind Support erfragt werden

Weitere Parameter können direkt im Code gesetzt werden. Alternativ kann auf die vorbereitete Konfiguration von viind zurückgegriffen werden.

Interaktion

Nach der Initialisierung wird von der Initialisierungsfunktion ein Objekt zurückgegeben. Dieses kann genutzt werden zur Interaktion des Webchats mit JavaScript. Das Git-Repository bietet eine Dokumentation der verfügbaren Funktionen.

Die umfangreiche Einbindung ist ein kostenpflichtiges Zusatzangebot. Falls ihr Interesse habt, wendet euch für ein individuelles Angebot gerne an folgenden Kontakt.

Kontakt bei Fragen

Falls du Fragen zur umfangreichen Einbindung hast oder überlegst, sie einzuführen, steht dir unser Team gerne zur Verfügung.