Sammlungen und Daten

Sammlungen sind eigene Datentabellen Ihres Bots. Darin lassen sich bequem Anfragen, Bestellungen, Antworten aus Dialogen, Spielpunkte, Buchungen — alles, was der Bot von Nutzern sammelt oder aus Integrationen erhält — ablegen. Der Bereich befindet sich im linken Menü: Daten → Sammlungen.

Was ist eine Sammlung

Eine Sammlung besteht aus Feldern (Schema, das die Spalten beschreibt) und Datensätzen (Zeilen mit Daten). Jeder Datensatz ist ein Satz von Werten nach den Feldern der Sammlung; intern wird er als flexibles JSON-Dokument gespeichert, sodass die Sammlung das Hinzufügen neuer Felder problemlos verträgt.

Der Name der Sammlung ist innerhalb eines Bots eindeutig und wird als Bezeichner in Reaktionsaktionen verwendet (z. B. leads, orders, scores).

Feldtypen

Beim Erstellen einer Sammlung legen Sie die Feldliste und den Typ jedes Feldes fest:

  • text — Zeichenkette (Name, E-Mail, Kommentar).
  • number — Zahl (Betrag, Menge, Punkte).
  • bool — Ja/Nein (true / false).
  • datetime — Datum und Uhrzeit.
  • json — verschachteltes Objekt oder Array für komplexe Werte.

Der Typ beeinflusst, wie das Feld in der Oberfläche bearbeitet wird und wie der Wert beim Speichern umgewandelt wird. Das Schema ist nicht starr: Enthält ein Datensatz ein Feld außerhalb des Schemas, wird es gespeichert und als separate Spalte angezeigt.

Sammlung erstellen

  1. Öffnen Sie Daten → Sammlungen und klicken Sie auf Hinzufügen.
  2. Geben Sie einen Namen an (lateinische Buchstaben, ohne Leerzeichen — so ist es einfacher, in Reaktionen darauf zu verweisen).
  3. Fügen Sie mit der Schaltfläche Feld die gewünschten Spalten hinzu und wählen Sie den jeweiligen Typ.
  4. Legen Sie bei Bedarf Speicherregeln fest (siehe unten) und speichern Sie.

Datensätze: Ansicht und Bearbeitung

Auf der Sammlungskarte gibt es eine Schaltfläche mit Tabellen-Symbol — sie öffnet das Fenster Daten mit den Datensätzen dieser Sammlung:

  • Ansicht — alle Zeilen werden als Liste angezeigt, ein Feld pro Zelle, beginnend mit den neuesten.
  • Datensatz hinzufügen — öffnet ein Formular nach dem Sammlungsschema; jedes Feld wird nach seinem Typ bearbeitet (Umschalter für bool, JSON-Eingabefeld für json usw.).
  • Ändern (Bleistift) — bearbeitet eine vorhandene Zeile.
  • Löschen (Papierkorb) — löscht eine Zeile.

Datensätze werden auch automatisch befüllt — durch Reaktionsaktionen des Bots (siehe unten). Manuelle Bearbeitung und automatische Einträge arbeiten mit derselben Sammlung.

Speicherung (Retention)

Damit die Sammlung nicht unbegrenzt wächst, legen Sie Regeln für die automatische Bereinigung fest:

  • Maximal gespeicherte Datensätze — bei Überschreitung des Limits werden die ältesten Datensätze gelöscht.
  • Nicht länger speichern (Tage) — Datensätze, die älter als der angegebene Zeitraum sind, werden gelöscht.

Die Bereinigung erfolgt durch einen Hintergrundprozess periodisch; Regeln können kombiniert werden.

Arbeit mit Daten aus Reaktionen

Sammlungen sind direkt mit dem Reaktions-Builder verknüpft. In Reaktionsaktionen stehen zur Verfügung:

  • Datensatz erstellen — fügt eine Zeile hinzu; die Werte werden aus Vorlagen entnommen (z. B. {{user.id}}, {{message.text}}). Es kann ein Deduplizierungsschlüssel angegeben werden, damit ein wiederholter Aufruf dieselbe Zeile aktualisiert statt Duplikate zu erzeugen.
  • Datensätze aktualisieren — ändert Zeilen, die einer Bedingung entsprechen.
  • Datensätze abfragen — liest Zeilen als Array in den Ausführungskontext, um sie anschließend zu durchlaufen.
  • Datensätze löschen — löscht Zeilen nach Bedingung.
  • Schleife (for-each) — durchläuft ein Array aus dem Kontext und führt für jedes Element verschachtelte Aktionen aus (z. B. eine Nachricht an eine Liste aus der Sammlung senden).

So kann der Bot ein CRM führen, Anfragen sammeln, Punkte vergeben und Berichte erstellen — ohne externe Datenbank.

Zugriff aus der Mini App

Datensätze der Sammlung können aus der Telegram Mini App Ihres Bots gelesen werden: Das Frontend fragt Sammlungsdaten nach Name mit Filtern und Limit ab. So können dem Nutzer seine Bestellungen, der Verlauf oder eine Bestenliste direkt innerhalb von Telegram angezeigt werden.

Tipps

  • Geben Sie Feldern kurze, maschinenfreundliche Namen (email, total, paid) — sie lassen sich bequemer in Reaktionsvorlagen einfügen.
  • Verwenden Sie für idempotente Einträge (z. B. „eine Anfrage pro Nutzer") den Deduplizierungsschlüssel.
  • Aktivieren Sie Retention für Logs und temporäre Daten, damit die Sammlung nicht unkontrolliert wächst.
  • Der Typ json eignet sich, wenn die Struktur des Wertes nicht im Voraus festgelegt ist.