Sammlungen und Daten
Anfragen, Bestellungen und Anmeldungen direkt in GetMyBot speichern: Tabellen anlegen, Daten hinzufügen und in Reaktionen verwenden.
Auf dieser Seite
Eine Sammlung ähnelt einer Tabelle. Eine Zeile steht für eine Anfrage, eine Bestellung oder eine Kursanmeldung. Der Bot kann Zeilen aus Nutzerantworten anlegen; Sie können sie unter Daten → Sammlungen ansehen und bearbeiten.
Für Beratungsanfragen erstellen Sie beispielsweise leads mit den Feldern name, phone und topic. Nach den Fragen speichert der Bot Name, Telefon und Thema in einer Zeile. Diese Einträge können später in Reaktionen gesucht und verwendet werden.
Was ist eine Sammlung?
Felder sind die Spalten, etwa „Telefon“ und „Thema“. Ein Datensatz enthält die Werte einer Zeile. Die Liste der Felder und Typen heißt Schema. Technisch wird jeder Datensatz als JSON-Dokument gespeichert; neue Felder erfordern keine Neuanlage der bisherigen Zeilen.
Der Sammlungsname muss innerhalb eines Bots eindeutig sein. Reaktionsaktionen verwenden ihn als Kennung, zum Beispiel leads, orders oder scores.
Feldtypen
Beim Anlegen bestimmen Sie die Felder und deren Typen:
| Typ | Inhalt | Beispiel |
|---|---|---|
text | Zeichenfolge | Name, E-Mail oder Kommentar |
number | Zahl | Betrag, Menge oder Punkte |
bool | Ja oder Nein: true / false | Bestellung bezahlt? |
datetime | Datum und Uhrzeit | Termin eines Kurses |
json | Verschachteltes Objekt oder Liste | Bestellpositionen mit Produkteigenschaften |
Der Typ beeinflusst die Eingabe im Editor und die Umwandlung beim Speichern. Das Schema ist nicht strikt: Ein Feld außerhalb des Schemas bleibt erhalten und erscheint als eigene Spalte.
Sammlung erstellen
- Öffnen Sie Daten → Sammlungen und klicken Sie auf Hinzufügen.
- Geben Sie einen Namen mit lateinischen Zeichen ohne Leerzeichen ein, damit Sie ihn leicht in Reaktionen verwenden können.
- Fügen Sie über Feld die Spalten hinzu und wählen Sie deren Typen.
- Legen Sie bei Bedarf Aufbewahrungsregeln fest und speichern Sie die Sammlung.
Datensätze ansehen und bearbeiten
Auf der Sammlungskarte öffnet das Tabellensymbol das Fenster Daten mit den Einträgen:
- Ansicht: Alle Zeilen erscheinen vom neuesten Eintrag an, mit einer Zelle pro Feld.
- Eintrag hinzufügen: Öffnet ein Formular nach dem Sammlungsschema. Jedes Feld erhält die Eingabe passend zum Typ, etwa einen Schalter für
booloder JSON-Eingabe fürjson. - Bearbeiten (Stift): Ändert eine vorhandene Zeile.
- Löschen (Papierkorb): Entfernt eine Zeile.
Auch Bot-Reaktionen können Datensätze automatisch anlegen. Manuelle Bearbeitung und Aktionen arbeiten mit derselben Sammlung.
Aufbewahrung (retention)
Legen Sie Regeln für die automatische Bereinigung fest, damit die Sammlung nicht unbegrenzt wächst:
- Maximale Anzahl gespeicherter Einträge: Bei Überschreitung werden die ältesten gelöscht.
- Aufbewahrungsdauer (Tage): Ältere Datensätze werden entfernt.
Für ein vorübergehendes Protokoll können 30 Tage genügen. Die Bereinigung läuft regelmäßig, nicht exakt zum Ablaufzeitpunkt. Beide Grenzen lassen sich kombinieren. Für Bestellungen, die noch benötigt werden, sollten Sie keine zu kurze Frist einstellen.
Daten in Reaktionen verwenden
Im Reaktionseditor stehen diese Aktionen bereit:
- Datensatz erstellen: Fügt eine Zeile mit Werten aus Ersetzungen wie
{{user_id}}und{{text}}hinzu. Ein Deduplizierungsschlüssel verhindert doppelte Zeilen: Dieselbe Kennung aktualisiert beim Wiederholen den bestehenden Datensatz. Über die Nutzer-ID können Sie beispielsweise genau eine aktuelle Anfrage pro Person führen. - Datensätze aktualisieren: Ändert Zeilen, die einer Bedingung entsprechen.
- Datensätze suchen: Liest Zeilen als Array in den Ausführungskontext, damit weitere Aktionen sie durchlaufen können.
- Read collection page (
record_page): Liest Einträge portionsweise, etwa zwei Produktkarten und danach eine Schaltfläche für die nächste Seite. - Aggregate whole collection (
record_aggregate): Berechnet Anzahl und Summen über alle passenden Datensätze innerhalb der Aufbewahrungsregeln. Die Berechnung ist nicht auf die erste geladene Seite begrenzt. - Atomic collection transaction (
collection_transaction): Prüft Bedingungen und speichert mehrere Änderungen gemeinsam, etwa einen Platz reservieren und eine Anmeldung anlegen. Bei einem Konflikt werden auch frühere Änderungen dieser Transaktion zurückgenommen. - Datensätze löschen: Entfernt Zeilen nach einer Bedingung.
- Schleife (for-each): Durchläuft ein Array aus dem Kontext und führt für jedes Element Aktionen aus: eine Zeile ändern, eine Summe bilden oder einen Datensatz an einen externen Dienst senden.
Damit lassen sich CRM, Anfragen, Punktestände und Berichte ohne externe Datenbank führen.
Praktische Übungen zeigen das Fortsetzen eines Katalogs, Summen über alle passenden Bestellungen und die Reservierung des letzten Platzes. Eine Seite einer geladenen Liste, eine Sammlungsseite und ein Gesamtergebnis beantworten unterschiedliche Fragen. In den Übungen sehen Sie, welche Daten der nächste Schritt erhält.
Eine Schleife ist keine Rundsendung. Sie verarbeitet höchstens 500 Elemente pro Durchlauf, während ein Ereignis insgesamt höchstens 50 Nachrichten senden darf. Mit einer Nachricht pro Element erreichen die ersten 50 Empfänger eine Nachricht; bei den übrigen scheitert der Versand am Limit. Erstellen Sie für Menschen aus einer Sammlung ein Segment und nutzen Sie eine Rundsendung, die Versandtempo, Pause und Zähler bietet. Siehe Aktionen → Budget eines Ereignisses.
Katalog: Suche, Auswahl und Karte
Beginnen Sie mit der Übung zur Kurssuche. Sie zeigt die benötigten Sammlungen, die Reihenfolge der Aktionen und die Prüfung von leeren und mehrfachen Treffern sowie alten Schaltflächen.
Für einen Katalog speichern Sie Daten getrennt von Reaktionen. products enthält zum Beispiel name und aliases, variants enthält product_id, name und card. Aktivieren Sie für variants.product_id Verknüpfung mit anderer Sammlung, wählen Sie products, den Schlüssel _record_id und das Beschriftungsfeld name. Die Verbindung beschreibt die Bedeutung des Feldes; Datensätze werden dabei nicht automatisch gemeinsam geändert oder gelöscht.
- Fügen Sie in einer Reaktion auf eingehenden Text Sammlung durchsuchen (
record_search) hinzu. Wählen Sieproducts, den Suchtext{{text}}, das Suchfeldname, das Synonymfeldaliasesund den Ergebnisnamensearch. Synonyme dürfen eine Zeichenfolge oder ein JSON-Array von Zeichenfolgen sein. Die Suche ignoriert Groß-/Kleinschreibung, behandelt russisches е und ё gleich und ersetzt Satzzeichen durch Leerzeichen. - Fügen Sie Nächsten Schritt wählen (
branch_result) mitsearchals Quelle hinzu. Der erste passende Zweig gewinnt. Behandeln Sie zuerst Unvollständiges Ergebnis mit der Bitte, die Anfrage einzugrenzen; danach Kein Treffer, Unscharfer Treffer, Ein Datensatz und Mehrere Datensätze. Bei einem unscharfen Treffer lassen Sie die Auswahl bestätigen. Ein leerer oder einzelner Treffer ist nur bei vollständigem Ergebnis sicher. - Öffnen Sie für mehrere Treffer im Nachrichtenblock Schaltflächen aus gefundenen Datensätzen. Wählen Sie
search, das Beschriftungsfeldnameund die nächste Reaktion. Die Hilfe setztbuttons_from.over = search.rows, die Beschriftungsvorlage undcarry.selected_id = {{item._record_id}}. Das Beschriftungsfeld muss in den Ergebnisfeldern enthalten sein. Die erweiterte Schaltflächenbearbeitung bleibt verfügbar. - Fügen Sie in der nächsten Reaktion Verknüpfte Datensätze finden (
record_related) hinzu: Sammlungvariants, Schlüsselproduct_id, Wert{{ctx.selected_id}}, Ergebnisvariants. Für den gewählten Datensatz selbst verwenden Sieproductsmit_record_id. Liegt die Verbindung in einem Geschäftsschlüssel, wählen Sie diesen sowohl in der Schaltflächenhilfe als auch beim Lesen. - Wählen Sie erneut einen Zweig nach Ergebnis. Einen einzelnen Datensatz zeigen Sie mit
{{ctx.variants.first.card}}als Karte; bei mehreren Varianten zeigen Sie Schaltflächen. Jede Schaltfläche übergibt eine ID; die aktuellen Daten werden erst nach dem Drücken geladen. Legen Sie die Karte oder andere veränderliche Felder nicht incarryab.
Ergebnis einer Leseaktion
search.rows enthält die geladenen Zeilen, search.count ihre Anzahl, search.first die erste Zeile und search.first.name ein bestimmtes Feld. Jede Zeile erhält _record_id, _score und _match_type. Diese Namen sind reserviert. Gibt es keine Zeilen, werden eine zuvor gespeicherte erste Zeile und ihre Felder geleert.
search.total zählt Treffer unter den geprüften Kandidaten. total_exact = false bedeutet, dass nicht die ganze Sammlung geprüft wurde; truncated = true zeigt eine begrenzte Ausgabe an. Betrachten Sie das nicht als vollständige Suche und nehmen Sie nicht an, der beste Treffertyp der gesamten Sammlung sei gefunden. Eine Anfrage prüft bis zu 10 000 Datensätze und 16 MiB Daten; die Antwort enthält die tatsächlich erreichten Grenzen. Standardmäßig kommen bis zu 100 Zeilen zurück, maximal 10 000.
Suche prüfen und erklären
Klicken Sie im Sucheditor auf Suche testen und geben Sie einen konkreten Testtext oder eine ID ein. Die Prüfung liest nur Daten: nachfolgende Reaktionen, Nachrichten und Aktionen laufen nicht. Ersetzen Sie Variablen in zusätzlichen Filtern zunächst durch konkrete Werte. Das Ergebnis zeigt Zeilen, Treffertyp, geprüfte Datensätze und Grenzen. Nach einem Wechsel von Projekt, Sammlung, Einstellungen oder Rechten werden alte Ergebnisse verborgen.
Das Ausführungsprotokoll zeigt Suchfelder, Treffertyp, Anzahl geprüfter und zurückgegebener Zeilen, Ausgabelimit und gewählten Zweig. Im Reaktionsdiagramm sind alle Bedingungen beschriftet, die zu einer Reaktion führen. Beim erneuten Öffnen einer Ausführung sehen Sie die Sucherklärung nach Auswahl des zugehörigen Ereignisses, sofern Sie die Berechtigung für dessen Inhalt haben.
Die Schaltflächenhilfe legt standardmäßig höchstens 20 Schaltflächen an. Maximale Schaltflächen lässt sich zwischen 1 und 100 einstellen; sie begrenzt die Ausgabe, blättert aber nicht durch Seiten. Eine leere Liste erzeugt keine Schaltfläche. Für größere Ergebnisse ergänzen Sie einen Zweig, der zur Präzisierung der Suche auffordert.
In der Aktion Berechnung erstellt die Hilfe Operation über eine geladene Liste Formeln für die Anzahl der Zeilen, die erste Zeile, die Summe eines Feldes und eine Liste von Beschriftungen. Diese Berechnung verwendet nur die geladenen Zeilen und ist bei unvollständiger Ausgabe kein Ergebnis für die ganze Sammlung.
API und MCP
Dieselben Operationen stehen unter POST /api/bots/{botID}/collections/{name}/search und /related sowie über die MCP-Werkzeuge search_records und related_records mit collections:read zur Verfügung. Aufrufe sind auf das aktuelle Projekt und die Region begrenzt. Bei REST geben Sie konkrete Werte an; Vorlagen werden erst in Reaktionsaktionen ersetzt.
Ergebnisse verarbeiten und bedingt ändern
Sie können ein Sammlungsergebnis an list_transform weitergeben, um Zeilen zu filtern, sortieren, Duplikate zu entfernen oder eine Seite auszuwählen. list_aggregate berechnet benannte Summen über geladene Zeilen, bei Bedarf gruppiert. Die Aktionen funktionieren ebenso mit gewöhnlichen Listen aus HTTP-Antworten, ganz ohne Sammlung.
Mit record_update_if verhindern Sie, dass zwei gleichzeitige Ausführungen denselben Zustandswechsel zweimal durchführen. Geben Sie ID, erwartete Feldwerte und neue Werte an. Prüfung und Änderung erfolgen atomar für einen Datensatz. Den gespeicherten Status updated, conflict oder not_found können Sie mit branch_value behandeln. Das unterscheidet sich vom bedingungslosen Ändern aller Zeilen, die einem Filter entsprechen.
Einstellungen, Grenzen und Beispiele.
Die Übung: Antrag genau einmal bestätigen zeigt die Prüfung von Status und Eigentümer sowie eigene Antworten auf updated, conflict und not_found.
Zugriff aus einer Mini App
Die Telegram Mini App Ihres Bots kann Sammlungsdatensätze anhand des Namens, von Filtern und eines Limits lesen. So sehen Nutzer Bestellungen, Verlauf oder eine Rangliste direkt in Telegram.
Hinweise
- Verwenden Sie kurze technische Feldnamen wie
email,totalundpaid, damit sie sich leicht in Reaktionsvorlagen einsetzen lassen. - Gegen doppelte Zeilen nach einer Wiederholung nutzen Sie einen Deduplizierungsschlüssel. Dieses Verhalten heißt Idempotenz.
- Stellen Sie
retentionfür Protokolle und vorübergehende Daten ein, die Sie später nicht mehr benötigen. jsoneignet sich für Werte, deren Struktur nicht von Anfang an feststeht.