# Listen und Tabellen

Die Blöcke dieser Gruppe arbeiten mit Daten, die getrennt vom Kontakt gespeichert sind: Produktkatalog, Zeitplan, Anfragen, Promocodes. Der Bot kann solche Daten der Person zeigen, einen neuen Eintrag hinzufügen, prüfen, ob es ihn gibt, oder ihn löschen.

Die Daten liegen an einem von drei Orten:

- **Listen** — der Bereich „Listen“ des Projekts. Eine Liste hat Felder mit Namen und Typen: Text, Zahl, Datum, Geld, Bild, Datei und andere. Der Bot kann darin alles: Einträge lesen, hinzufügen, aktualisieren, prüfen und löschen. Für Daten, die das Szenario selbst schreibt und selbst liest, ist das die einfachste Variante.
- **Tabellen** — der Bereich „Tabellen“ des Projekts. Das ist eine Tabellenkalkulation mit Blättern, Zeilen und den Spalten A, B, C… Der Bot kann ihre Zeilen nur lesen.
- **Google Sheets** — eine Tabelle in Ihrem Google-Konto. Der Bot liest, ergänzt, aktualisiert und löscht Zeilen, zuvor muss aber ein Google-Konto mit dem Bot verbunden werden. Geeignet, wenn mit den Daten auch außerhalb der Plattform gearbeitet wird.

Wie Sie Blöcke hinzufügen und ihre Ausgänge verbinden, steht in der [Übersicht des Bereichs](https://support.watbot.org/de/chatbots/blocks).

## Gemeinsame Einstellungen der Listenblöcke

Diese Einstellungen wiederholen sich in den Listenblöcken. Auf den Seiten der Blöcke sind nur die Unterschiede beschrieben.

### Liste

Wählen Sie im Feld „Liste“, mit welcher Liste der Block arbeitet. Listen gehören zum Projekt und stehen jedem seiner Bots zur Verfügung. Gibt es viele Listen, stehen zuerst „In diesem Bot erstellt“, dann „Weitere Listen des Projekts“ — mit dem Hinweis, wo die Liste angelegt wurde.

Der Button „Listen öffnen“ neben dem Feld öffnet das Fenster der Listen: Darin können Sie eine Liste anlegen, ihre Felder ändern und die Einträge ansehen, ohne das Schema zu verlassen.

![Listenfenster aus dem Block geöffnet: Einträge der Liste „Sträuße“](https://support.watbot.org/_media/de/01-chatbots/03-blocks/07-lists/_images/lists-window.webp?v=1791781229)

Die übrigen Einstellungen erscheinen, nachdem eine Liste gewählt ist. In den Leseblöcken werden Filter, Sortierung und Vorlagen zurückgesetzt, wenn Sie eine andere Liste wählen.

### Filter

Ein Filter wählt Einträge nach den Werten der Felder aus. Jede Bedingung besteht aus vier Teilen:

- **„UND“ / „ODER“** — wie die Bedingung mit den vorherigen verknüpft ist.
- **Feld** — ein Feld der Liste. Neben den eigenen Feldern gibt es „Erstellungsdatum des Eintrags“ und „Aktualisierungsdatum des Eintrags“.
- **Vergleich** — `=`, `>`, `<`, `>=`, `<=`, `!=`.
- **„Wert“** — der Wert, mit dem verglichen wird, bis zu 64 Zeichen.

Im Wert funktionieren [Platzhalter](https://support.watbot.org/de/chatbots/templates). So findet man einen Eintrag über die Daten des Kontakts: zum Beispiel das Feld „Telefon“ `=` `{{ phone }}` oder das Feld „Kunde“ `=` `{{ id }}`.

Der Wert wird in den Typ des Feldes umgewandelt: bei einer Zahl — in eine Zahl, bei Geld — in einen Betrag, bei einem Datum — in ein Datum. Schreiben Sie das Datum in der Form `2026-10-02` oder `2026-10-02 14:30`. Für ein Feld mit einem Kontakt oder Bot geben Sie dessen Nummer an.

Eine neue Bedingung fügt der Button „Feld hinzufügen“ hinzu.

![Filter eines Leseblocks: Feld „Preis“ kleiner oder gleich der Variable „budget“](https://support.watbot.org/_media/de/01-chatbots/03-blocks/07-lists/_images/lists-filters.webp?v=1791781229)

> [!WARNING]
> In den Leseblöcken wird eine Bedingung mit leerem Wert übersprungen, als gäbe es sie nicht. Als leer gilt auch eine Variable, die der Kontakt nicht hat; `0` gilt nicht als leer. Fallen so alle Bedingungen weg, zeigt der Block die gesamte Liste. Der Block „Listeneinträge löschen“ löscht bei einer leeren Bedingung nichts.

### Suche nach der Phrase des Kontakts

In den Blöcken „Listeneinträge lesen“, „Listeneintrag lesen“ und „Listeneintrag löschen“ lässt sich ein Eintrag über den Text suchen, den die Person gesendet hat:

- **„Suchfeld“** — das Feld der Liste, in dem gesucht wird. Der Bot sucht den Text, mit dem die Person in den Block gelangt ist: über den Ausgang „Jede andere Phrase“ des vorherigen Blocks oder aus dem Block „Inline-Telegram-Bot“.
- **„Suchtyp“** — wie der Text des Feldes mit der Phrase verglichen wird: „Die Suchphrase ist im Text enthalten“, „Suchphrase stimmt mit dem Text überein“, „Text beginnt mit der Suchphrase“, „Text endet mit der Suchphrase“.

![Suche nach der Phrase des Kontakts: Feld „Name“, „Suchphrase ist im Text enthalten“](https://support.watbot.org/_media/de/01-chatbots/03-blocks/07-lists/_images/lists-search.webp?v=1791781229)

### Vorlage der Nachrichtenkette

Leseblöcke speichern den Eintrag nicht in Variablen. Sie senden ihn sofort an die Person — in der Form, die im Abschnitt „Vorlage der Nachrichtenkette“ festgelegt ist. Die Vorlage wird aus Teilen zusammengesetzt, für jeden Eintrag sendet der Bot sie der Reihe nach:

- **„Vorlage“** — der Text der Nachricht. Unter dem Feld stehen die Buttons „ID“, „Erstellungsdatum“ und Buttons mit den Namen der Listenfelder. Ein Button fügt den Platzhalter des Feldes in den Text ein, zum Beispiel `{{ titel }}`. Beim Senden steht an seiner Stelle der Wert aus dem Eintrag.
- **„Foto“** — ein Bild aus einem Feld der Liste, in dem ein Bild gespeichert ist.
- **„Datei“** — eine Datei aus einem Feld der Liste, in dem eine Datei gespeichert ist.

Die Teile lassen sich durch Ziehen umsortieren. Folgt direkt auf das Bild ein Text, wird er zur Bildunterschrift. Hat der Eintrag kein Bild oder keine Datei, wird dieser Teil übersprungen.

![Vorlage der Nachrichtenkette: Text mit Feldplatzhaltern und den Buttons „Vorlage“, „Foto“, „Datei“](https://support.watbot.org/_media/de/01-chatbots/03-blocks/07-lists/_images/lists-template.webp?v=1791781229)

Ein Geldfeld wird bereits formatiert eingesetzt — mit Trennzeichen und Währungszeichen, daher brauchen Sie das Währungszeichen nicht dazuzuschreiben. Um den Betrag in einer anderen Währung zu zeigen, geben Sie deren Code nach dem senkrechten Strich an: `{{ preis | USD }}`.

Im Text der Vorlage funktionieren auch die gewöhnlichen [Platzhalter](https://support.watbot.org/de/chatbots/templates) — zum Beispiel `{{ first_name }}`.

> [!TIP]
> Einen Listeneintrag können Sie auch in jeder anderen Nachricht des Bots ausgeben — mit den Funktionen `getListRow` und `getListRows`. Sie sind in der [Funktionsreferenz](https://support.watbot.org/de/chatbots/templates/functions#listen) beschrieben.

### Sortierung

Wählen Sie im Abschnitt „Sortierung“ ein Feld (oder „ID“) und die Reihenfolge: „Aufsteigend“ oder „Absteigend“. Bis zu drei Felder sind möglich.

![Sortierung: nach Preis, dann nach Name, aufsteigend](https://support.watbot.org/_media/de/01-chatbots/03-blocks/07-lists/_images/lists-sort.webp?v=1791781229)

## Gemeinsame Einstellungen der Google-Sheets-Blöcke

### Google-Konto verbinden

Die Blöcke greifen im Namen des Google-Kontos auf die Tabelle zu, das mit dem Bot verbunden ist. Verbinden Sie es einmal:

1. Öffnen Sie die Einstellungen des Bots und wechseln Sie zum Tab „Integrationen“.
2. Wählen Sie „Google Sheets“ — es öffnet sich das Fenster „Integration mit Google Sheets“.
3. Klicken Sie auf den Button zur Anmeldung über Google und erlauben Sie den Zugriff.
4. Wählen Sie das verknüpfte Konto im Feld „Konto“ und speichern Sie.

Die Tabelle muss für dieses Konto zugänglich sein. Ohne Verbindung sendet der Block der Person „Fügen Sie die Google Sheets-Integration im Bereich ‚Integrationen‘ hinzu.“ und bleibt stehen.

### Tabelle und Blatt

- **„Link zur Tabelle“** — die Adresse der Tabelle aus dem Browser, in der Form `https://docs.google.com/spreadsheets/d/...`.
- **„Blatt“** — ein Blatt der Tabelle. Die Liste der Blätter wird geladen, nachdem Sie den Link eingefügt haben.

> [!IMPORTANT]
> Geeignet sind nur Tabellen im Format von Google Sheets. In Google geöffnete Dateien von Microsoft Excel (`.xlsx`) werden nicht unterstützt.

### Zu verarbeitender Zeilenbereich

Die Felder „Von“ und „bis“ legen fest, von welcher bis zu welcher Zeile des Blattes der Block die Daten liest. Standard ist von der 2. bis zur 100000. Zeile: Die erste Zeile gilt als Überschrift. Je kleiner der Bereich, desto schneller arbeitet der Block. Filter und Sortierung wirken nur innerhalb des Bereichs.

### Spaltenfilter

Eine Bedingung besteht aus Spalte (Buchstabe: A, B, C…), Vergleich und Wert. Den Wert fügt einer der Buttons hinzu:

- „Variable hinzufügen“ — eine Kontaktvariable;
- „Konstante hinzufügen“ — Daten des Kontakts: „ID“, „Messenger-ID“, „Bot ID“, „Username“, „Name“, „Telefon“, „E-Mail“, „Adresse“, „Erstelldatum“, „Referrer ID“;
- „Globale Variable hinzufügen“ — eine globale Variable des Bots;
- „Text hinzufügen“ — beliebiger Text, darin funktionieren [Platzhalter](https://support.watbot.org/de/chatbots/templates) mit einfachen Funktionen.

Vergleiche:

| Vergleich | Wann die Zeile passt |
|---|---|
| `=` | Die Zelle ist gleich dem Wert |
| `!=` | Die Zelle ist ungleich dem Wert |
| `>`, `>=`, `<`, `<=` | Die Zelle ist größer oder kleiner als der Wert. Eine leere Zelle passt nie |
| `in` | Die Zelle enthält den Wert |
| `not in` | Die Zelle enthält den Wert nicht |

Eine Zeile muss zu allen Bedingungen gleichzeitig passen. Groß- und Kleinschreibung wird bei `=`, `!=`, `in` und `not in` nicht beachtet. Zahlen werden als Zahlen verglichen — mit Punkt wie mit Komma.

### Grenzen

- Die Zahl der Zugriffe auf Google pro Minute ist begrenzt. Bei vielen Kontakten wartet der Block, bis er an der Reihe ist, und der Bot antwortet mit Verzögerung.
- Meldet Google einen Fehler, sendet der Bot der Person eine Fehlermeldung und geht nicht weiter. Einzelheiten stehen im „Ausführungsprotokoll“ des Blocks.