Widget-Einbettungscode | Respeak Expert Platform

Einbettungscode kopieren

Nach dem Erstellen finden Sie Ihr Widget in der Widget-Übersicht. Um es in Ihre Website einzubauen, öffnen Sie das Widget und kopieren Sie das Code-Snippet aus dem Bereich Widget-Integrationsskript. Fügen Sie dieses Skript in den HTML-Code Ihrer Website ein - das Widget erscheint dann auf der Zielseite und Besucher können es sofort nutzen.

Das generierte <script>-Tag enthält Attribute für Ihre gespeicherten Einstellungen. Bei Bedarf können Sie diese direkt im HTML überschreiben. Alle Attribute haben das data--Präfix, damit sie HTML-Sanitisierer von CMS-Systemen (TYPO3, WordPress usw.) unverändert passieren. Die früheren Attributnamen ohne Präfix (z. B. token, lang) werden weiterhin akzeptiert, sodass bestehende Einbettungen ohne Anpassung weiter funktionieren.

Attribut	Beschreibung	Beispiel
`data-token`	Widget-Zugriffstoken (erforderlich)	`data-token="abc123"`
`data-lang`	Sprache der Oberfläche (`en` oder `de`)	`data-lang="de"`
`data-hide-activator-button`	Schwebenden Button ausblenden (Widget per JS-API öffnen)	`data-hide-activator-button="true"`
`data-button-position`	Ecke der Platzierung: `bottom-right` oder `bottom-left`	`data-button-position="bottom-left"`
`data-button-offset`	Pixel-Abstände als JSON	`data-button-offset='{"bottom":40,"right":24}'`

💡

Über die Schaltfläche Widget testen bzw. Widget-Vorschau öffnen können Sie eine Vorschau aufrufen, ohne das Widget auf einer externen Seite einbetten zu müssen.

JS-API

Wenn Sie data-hide-activator-button="true" setzen, können Sie das Widget per JavaScript steuern - zum Beispiel über einen eigenen Button oder Trigger auf Ihrer Website.

Widget öffnen:

window.RespeakWidget.open(callback)

Die optionale callback-Funktion wird aufgerufen, sobald das Widget geöffnet ist.

Widget schließen:

window.RespeakWidget.close()