Das Widget

Das Widget ist der schnellste Weg, den Assistenten in Ihr Produkt zu bringen. Es ist ein einzelnes Script, das einen Chat-Starter einbindet, von Ihrer Seite isoliert, sodass nichts kollidiert.

Einbetten

Fügen Sie ein Script-Tag mit Ihrem veröffentlichbaren Schlüssel hinzu. Sie können es auch aus npm installieren oder das Script selbst hosten, wenn Sie möchten.

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
  data-position="bottom-right"
></script>

Das Script muss als type="module" geladen werden. Das ist die einzige Voraussetzung.

Wie es lädt

Das Script startet sofort einen winzigen Starter und lädt den Chat selbst erst, wenn ein Nutzer ihn öffnet, sodass es Ihre Seite anfangs fast nichts kostet. Der Chat läuft in einem Shadow DOM, sodass Ihre und die Styles des Widgets sich nie beeinflussen.

Standardmäßig sicher

Ist der Schlüssel oder ein Attribut falsch, wirft das Widget nie einen Fehler in Ihre Seite — es protokolliert eine Warnung und stellt nichts dar, und Ihr Schlüssel wird in jeder Meldung maskiert. Eine kaputte Einbettung kann Ihre App nicht beschädigen.

Was das Widget berühren kann und was nicht

Das Widget ist bewusst von der Seite abgeschottet, auf der es lebt. Praktisch heißt das:

• Es läuft innerhalb eines Shadow DOM, sodass seine Stile und die Stile Ihrer Seite sich niemals gegenseitig beeinflussen können.
• Es liest weder die Inhalte, Cookies, den lokalen Speicher noch andere Skripte Ihrer Seite — es arbeitet nur mit dem, was Sie ihm ausdrücklich übergeben.
• Es verwendet einen veröffentlichbaren Schlüssel, der sicher im Quelltext Ihrer Seite mitgeliefert werden kann: er kann einen Chat für Ihren Arbeitsbereich starten und nichts weiter.
• Es kann niemals etwas tun, das der angemeldete Nutzer nicht selbst tun könnte — jede Aktion läuft mit dessen Identität und Berechtigungen.

Nächste Schritte