# Trigger

Trigger sind dazu da, dass Ihre [Story](https://help.aiaibot.com/chatbot/stories-and-story-builder/was-ist-eine-story) beginnen kann. Sie lösen Ihre Story an einer von Ihnen festgelegten Stelle auf Ihrer Website aus.

Wie viele Trigger <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FYT8RSIMgSr0iYB8hkgRN%2Ftrigger-02.png?alt=media&#x26;token=9b8d59bc-5c2f-4e2a-a0ac-0ed86a6ed8ce" alt="" data-size="line">es jeweils für eine Story gibt sehen Sie in Ihrer Story-Übersicht im Chatbot-Modul:

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F1hWL5eJkEtSacD0505yW%2Ftrigger-01.png?alt=media&#x26;token=b17bcdbc-fdca-4ece-9644-3035624d139d" alt=""><figcaption></figcaption></figure>

Wenn keine Zahl neben dem Trigger Icon steht, wurde noch kein Trigger für diese Story definiert.

## Trigger erstellen

Um einen neuen Trigger für eine Story zu erstellen, klicken Sie auf das Trigger <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FYT8RSIMgSr0iYB8hkgRN%2Ftrigger-02.png?alt=media&#x26;token=9b8d59bc-5c2f-4e2a-a0ac-0ed86a6ed8ce" alt="" data-size="line"> Symbol in der entsprechenden Zeile. Im dann zu sehenden Fenster klicken Sie auf *Trigger hinzufügen:*

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FL0nworNcjQAXAimWFKTD%2Ftrigger-03.png?alt=media&#x26;token=6b84a8e8-3017-4835-a5f6-22d22c9cfef2" alt="" width="563"><figcaption></figcaption></figure>

Anschliessend öffnet sich ein Fenster in dem Sie die Einstellungen für Ihren Trigger vornehmen können:

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FunbNH9EW4fEhSm3CwC8h%2Ftrigger-04.png?alt=media&#x26;token=2974c8f3-42ca-4eec-b70a-a5160d94e28f" alt="" width="563"><figcaption></figcaption></figure>

### Domain-Einstellungen

Im linken Bereich *Domain-Einstellungen* können Sie einen Pfad angeben, unter dem dieser Tirgger ausgelöst werden soll. Dadurch können Sie steuern, auf welcher (Unter-)Seite Ihrer Webseite welche Story ausgespielt wird. Es ist wichtig, dass die [Domain in den Chatbot-Einstellungen](https://help.aiaibot.com/chatbot/integration/domains-konfigurieren) konfiguriert und die richtige [Integration](https://help.aiaibot.com/chatbot/integration) vorgenommen worden ist.

{% hint style="warning" %}
Der Pfad muss immer mit einem Schrägstrich (/) beginnen.
{% endhint %}

Möchten Sie den Trigger nicht auf einen Pfad beschränken sondern auf allen Seiten auslösen, dann aktivieren Sie *Auf allen Seiten anzeigen*. Es wird dann automatisch ein `*` in das *Pfad* Feld eingetragen.

#### + Event hinzufügen

Voraussetzung für den Einsatz dieses Triggers sind **JavaScript-Kenntnisse**. Zusätzlich wird der Zugang zum "Source Code" der Webseite benötigt. Der Event-Name, der im Trigger definiert wird, muss via JavaScript abgesendet werden.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FyCCd4Iy2TJbtbWSVACPG%2Ftrigger-05.png?alt=media&#x26;token=d8b30cd4-fe5e-4885-af0a-4690328dcba3" alt="" width="386"><figcaption></figcaption></figure>

Hier ein Beispiel für den JavaScript Code zum Auslösen eines Custom Events mit dem Namen *custom-event*:

```javascript
const event = new Event('custom-event');
document.dispatchEvent(event);
```

#### + Domain hinzufügen

Wenn der Trigger nur unter einer bestimmten Domain ausgelöst werden soll, dann kann diese unter *+ Domain hinzufügen* angegeben werden.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F6miLs6UEc3qhIKT0rx97%2Ftrigger-06.png?alt=media&#x26;token=42af581f-d33f-4a19-88fb-afb0508eeb67" alt="" width="392"><figcaption></figcaption></figure>

#### + Query hinzufügen

Ein Trigger kann so eingestellt werden, dass er nur dann ausgelöst wird, wenn in der URL gewisse Query-Parameter vorhanden sind. Es können mehrere Query-Parameter definiert werden.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F7AF5hEWW7KerOraZrb10%2Ftrigger-07.png?alt=media&#x26;token=23e3d7b6-2609-4cd5-9328-03697968b90a" alt="" width="398"><figcaption></figcaption></figure>

Ein Query-Parameter besteht aus einem Namen und einen Wert. Es stehen folgende Operatoren zur Verfügung:

* ist gleich
* ist nicht gleich
* ist leer
* ist nicht leer

### Verhalten

Auf der rechten Seite kann das Verhalten des Chatbots angepasst werden, nachdem der Trigger ausgelöst wurde und eine Story startet.

#### Automatisch öffnen

Wenn die Option *Automatisch öffnen* aktiviert wird, startet der Chatbot mit einer einstellbaren Zeitverzögerung automatisch. Wird ein Wert von 0 Sekunden eingestellt, öffnet sich der Chatbot unmittelbar beim Aufruf der Webseite.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FeXo7MhZxq0cOd3LWZuRL%2Ftrigger-09.png?alt=media&#x26;token=aad0fb08-0e03-4e09-96e6-4e42ffe288c2" alt="" width="394"><figcaption></figcaption></figure>

{% hint style="info" %}
Geisternachrichten sind beim automatischen Öffnen nicht möglich.
{% endhint %}

#### Geisternachrichten

Bei geschlossenem Chatbot können nach einer gewissen Zeitverzögerung Geisternachrichten angezeigt werden. Diese sollen den Benutzer animieren, mit dem Chatbot zu interagieren.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FsBlLokCxBUkzCw3MFCTJ%2Ftrigger-10.png?alt=media&#x26;token=08299fb9-0064-4a2b-a2f5-e896f344524e" alt="" width="398"><figcaption></figcaption></figure>

Wird die Webseite mehrmals vom selben Benutzer besucht, kann das Anzeigen von Geisternachrichten nicht immer erwünscht sein. Unter *Zeitspanne* kann eine Dauer festgelegt werden, nach deren Ablauf der Benutzer erneut die Geisternachricht angezeigt bekommt.

Ein Wert von 0 Stunden bedeutet, dass die Geisternachrichten bei jedem Besuch der Webseite angezeigt werden. Wird beispielsweise ein Wert von einem Tag eingestellt, bekommt der selbe Benutzer erst nach 24 Stunden die Geisternachricht erneut zu sehen.

#### Gerätetyp

Ein Trigger kann unabhängig vom Gerätetyp ausgelöst werden. Es ist aber auch möglich, das Auslösen nur bei mobilen oder Desktop-Geräten zu erlauben

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FVWjoPyWEIOt4T37UgDzu%2Ftrigger-11.png?alt=media&#x26;token=11c263b5-9149-4d64-ae09-15164e11ead2" alt="" width="350"><figcaption></figcaption></figure>

#### Nutzungsbedingungen

Ist eine Zustimmung zu Nutzungsbedingungen **nicht** erwünscht, so kann dies mit der Option *Zustimmung zu Nutzungsbedingungen ist nicht erforderlich* aktiviert werden. Die Story beginnt sofort nach dem Öffnen des Chatbots, ohne zusätzliche Zustimmung des Benutzers.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F6rD5aTBOuzRkKeOuoEUV%2Ftrigger-12.png?alt=media&#x26;token=9e1c6c1d-9a18-46ba-91fc-7c80e9160a80" alt="" width="350"><figcaption></figcaption></figure>

#### Vollbild Optionen

Mit der Option *Im Vollbild-Modus öffnen* wird der Chatbot automatisch so geöffnet, dass er den ganzen Bildschirm einnimmt. Dies ist auf mobilen Geräten empfohlen.

Soll es dem Benutzer gestattet sein, zwischen Fenster und Vollbild-Modus zu wechseln, kann dies mit der Option *Wechsel zwischen Fenster und Vollbild-Modus erlauben* erreicht werden.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2F9gTVgTXgkqWhfCLY5SVg%2Ftrigger-13.png?alt=media&#x26;token=90d0642d-95ee-4c9d-89bd-ed9b9b92568b" alt="" width="350"><figcaption></figcaption></figure>

## Trigger verwalten

Gibt es für eine Story einen oder mehrere Trigger, so erscheinen dies nach dem Klick auf das Trigger <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FYT8RSIMgSr0iYB8hkgRN%2Ftrigger-02.png?alt=media&#x26;token=9b8d59bc-5c2f-4e2a-a0ac-0ed86a6ed8ce" alt="" data-size="line"> Symbol in der entsprechenden Zeile.

<figure><img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FgEN28fA5pcBqu1lb9cIM%2Ftrigger-14.png?alt=media&#x26;token=43a7d155-b253-4da0-ac58-d5da08a09523" alt="" width="563"><figcaption></figcaption></figure>

#### Trigger Reihenfolge

Besucht ein Benutzer ihre Webseite, wird die Liste der Trigger von oben nach unten durchsucht bis ein Treffer gefunden wird. Daher kann es notwendig sein, die Reihenfolge zu verändern. Dies kann mit dem <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FM3zECkdMQCmug0ax5TWO%2Ftrigger-15.png?alt=media&#x26;token=4710735d-422b-48a7-9f53-969dcd0bd3fa" alt="" data-size="line"> Symbol durchgeführt werden.

#### Löschen und Aktivieren/Deaktivieren

Mit dem Schalter <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2Fgl4eSgGKKly1pFeUq0xs%2Fswitch.png?alt=media&#x26;token=31656e4f-6d4f-407e-8f17-b1f3a5fb136d" alt="" data-size="line">kann ein Trigger aktiviert bzw. deaktiviert werden. Hinter dem <img src="https://2388870224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8dtLKppxVG0mxVBzNFs6%2Fuploads%2FSTfk7NmPH9qDY9m6PxL9%2FScreenshot%202024-09-27%20at%2009.07.04.png?alt=media&#x26;token=6a8fb1af-ac2d-4e18-a3b7-a8d4d142a186" alt="" data-size="line"> Menü befinden sich Optionen um einen Trigger zu bearbeiten oder gänzlich zu löschen.