GetMyBot-Wissensdatenbank

Personen (CRM)

Kunden finden, Nachrichten lesen, Labels vergeben und Telefonnummern oder andere Angaben speichern. Karten, Filter und Export.

Auf dieser Seite

Im Bereich Personen finden Sie Kunden, die dem Bot geschrieben haben. Öffnen Sie eine Kundenkarte, um Nachrichten, Dateien und gespeicherte Angaben zu sehen, etwa Telefonnummer, gewünschter Kurs oder Zahlungsstatus. Karten werden anhand von Ereignissen automatisch erstellt und aktualisiert.

Eine solche Kundendatenbank heißt CRM. Labels helfen, Gruppen wie „Bezahlt“ hervorzuheben. Parameter speichern konkrete Werte wie phone oder order_id.

Benutzerliste

Die Tabelle zeigt Name, Telegram-ID, Labels und Aktivität: wann sich jemand zuletzt gemeldet oder den Bot blockiert hat. Sie können nach Name oder ID suchen und die Filter Alle, VIP, Bezahlt, Neu und Abgemeldet wählen. Neben jedem Filter steht die Anzahl der Personen. Öffnen Sie einen Dialog mit einem Klick auf die Zeile.

Der Filter Blockiert zeigt nur Personen, die den Bot blockiert haben; das Datum der Blockierung steht in der Karte. CSV exportieren lädt die durch Suche und Filter ausgewählte Liste mit höchstens 10.000 Zeilen herunter. Die CSV lässt sich in einem Tabellenprogramm öffnen. Technisch enthält sie tg_user_id, name, username, platform, is_blocked, blocked_at, first_seen, last_seen, labels; Labels sind durch ; getrennt, Datumswerte haben das RFC3339-Format. Textzellen sind dagegen geschützt, als Tabellenformeln ausgeführt zu werden. Bei Erreichen der Zeilengrenze gibt die API den Header X-Export-Truncated: true zurück. API-Endpunkt: GET /api/bots/{botID}/users?is_blocked=true&format=csv. Der Parameter is_blocked=true|false funktioniert auch für die normale JSON-Liste; blockierende Personen haben dort das Feld blocked_at.

Was über eine Person gespeichert wird

Die Kundenkarte enthält Avatar, Name, @username, den Link In Telegram öffnen, Zähler für Nachrichten sowie ersten und letzten Dialog, Labels und globale Parameter. Sie zeigt auch an, ob die Person den Bot blockiert hat oder auf eine Antwort eines Operators wartet.

Die Abonnentenquelle zeigt, über welchen Link eine Person zuerst zum Bot gekommen ist. Ein eigener Link für eine Frühlingskampagne unterscheidet beispielsweise deren Besucher von anderen. Angaben zur Werbequelle heißen UTM-Parameter. In Telegram wird der Zusatz nach start= im Link Payload oder Startkennung genannt.

Beispielformate:

  • Telegram: t.me/<bot>?start=utm_source-vk__utm_medium-cpc__utm_campaign-spring. Telegram erlaubt im Payload nur Buchstaben, Ziffern, _ und -: __ trennt Paare, das erste - trennt Schlüssel und Wert.
  • VK: vk.me/<group>?ref=utm_source=vk&utm_medium=post.
  • Empfehlungslink: t.me/<bot>?start=ref_<seine ID>. Die Karte und die Einfügung {{referrals.count}} zeigen, wie viele Personen der Abonnent eingeladen hat. Die Formen ref=<ID> und ref_<ID> werden getrennt von UTM ausgewertet.

Gespeichert werden fünf Felder: utm_source, utm_medium, utm_campaign, utm_content, utm_term. Für jedes gilt der erste nicht leere Wert. In Einfügungen und Segmenten stehen sie als attribution.utm_source … utm_term bereit.

Die Quelle wird mit dem ersten Startlink mit nicht leerer Kennung festgelegt. Dieses Prinzip heißt First Touch. Ein erneutes /start ändert die Quelle nicht und ergänzt keine UTM-Werte aus dem neuen Link. War die erste Kennung beliebig oder ein Empfehlungslink, bleiben die UTM-Felder leer. Ein Link ohne Kennung legt keine Quelle fest.

In Segmenten haben UTM-Werte aus dem Startlink Vorrang vor gleichnamigen Angaben eines Websitebesuchs. Fehlende Felder aus dem Link werden mit Webdaten ergänzt. Ein Link ganz ohne UTM löscht diese Daten nicht. Die Quelle gehört zum Kanal des ersten Starts und fließt nach einer Neuberechnung nur für Abonnenten mit derselben Kennung in diesem Kanal in das Segment ein.

Labels

Ein Label kennzeichnet eine Abonnentengruppe, etwa VIP, Bezahlt, Neu oder Abgemeldet. Sie können eigene Labels erstellen und Farben auswählen. Vergeben Sie ein Label von Hand oder mit der Aktion „Labels ändern“. Nutzen Sie es anschließend in Bedingungen („Mit Labels“) und zur Auswahl einer Broadcast-Zielgruppe.

Ein Label kann dauerhaft oder für eine begrenzte Anzahl von Tagen gelten. Nach Ablauf wird es automatisch entfernt und der Bot erhält das Ereignis „Label abgelaufen“. Über die API verwenden Sie POST /api/bots/{botID}/users/{tgUserID}/labels mit einer kanonischen UUID als label_id und optional ttl_days zwischen 0 und 106751. ttl_days: 0 bedeutet dauerhaft; das Ablaufdatum eines befristeten Labels steht in der Personenliste unter label_expires_at.

Parameter

Parameter speichern beliebige Werte zu einer Person, etwa Name, E-Mail, Betrag, Bestellstatus oder Punkte. Sie werden durch „Parameter ändern“, „Nachricht speichern“ und Dialogschritte gefüllt. Danach können Sie sie in Einfügungen ({{param.schlüssel}}) und Bedingungen („Mit Parametern“) verwenden. So führt der Bot für jeden Kunden ein kleines Profil ohne externe Datenbank.

Dialoge

Im Dialog sehen Sie Nachrichten, Fotos, Videos, Sprachnachrichten, Dokumente, Schaltflächen und Zustellungsmarkierungen. Gesendete Reaktionen erscheinen als eigene Karten. Unten können Sie eine Antwort schreiben, eine Datei anhängen oder eine Reaktion senden, die Sie aus der Liste wählen.

Anhänge

Die Schaltfläche Anhänge öffnet eine Galerie aller Dateien des Dialogs mit den Filtern Fotos, Dateien, Sprachnachrichten und Links sowie Alles herunterladen.

Dialogverlauf und Import

Im Dialog bleibt der gesamte Nachrichtenverlauf einer Person erhalten. Ältere Nachrichten werden beim Hochscrollen nachgeladen, damit auch lange Verläufe ohne Wartezeit für den vollständigen Download geöffnet werden können. Neue Nachrichten erscheinen sofort im offenen Dialog, genau wie in der Operator-Warteschlange.

Wenn Sie einen Bot von sambot übertragen, wird der Verlauf zusammen mit den Personen importiert. Danach sehen Sie frühere Nachrichten und Anhänge direkt in der Karte. Siehe Import aus sambot.

Kundenkarte und Massenaktionen

Die Karte vereint Profil, Ereignisverlauf (Timeline), Segmente, Dialog und Operatornotizen. Der Verlauf wird portionsweise geladen und lässt sich nach Typ, Quelle und Zeitraum filtern. Speichern Sie Änderungen an Eigenschaften und Labels: Sie werden im Aktionsprotokoll erfasst und lösen eine Aktualisierung der Segmente aus.

In der Liste können Sie mehrere Kunden auswählen und eine Eigenschaft gleichzeitig anwenden. Die Operation verwendet eine gespeicherte Momentaufnahme der ausgewählten Zielgruppe, ist auf 5.000 Personen begrenzt und lässt sich ohne doppelte Wirkung erneut senden. Ein CSV-Export erstellt eine separate gespeicherte Operation, die Sie vor dem Herunterladen abbrechen können. Eine bereits angewendete Massenänderung lässt sich nicht teilweise rückgängig machen.

Profile zusammenführen

Der Projekteigentümer kann zwei Personen auf derselben Listenseite auswählen und Profile zusammenführen wählen. Prüfe Kontakte und Kanäle, wähle das Hauptprofil und bestätige. Verlauf und Daten werden zusammengeführt; bei Konflikten gelten die Werte des Hauptprofils. Die Zusammenführung kann nicht rückgängig gemacht werden.

Eine laufende CRM-Synchronisierung oder ein ungeklärter Ozma-Vorgang muss zuerst abgeschlossen oder geprüft werden. Widersprüchliche Kontakte und Verknüpfungen zu verschiedenen CRM-Datensätzen müssen vorher geklärt werden.

Gleiche E-Mail-Adressen führen Profile nicht automatisch zusammen. Für angemeldete Website-Nutzer verwende ein signiertes identify; eine bestätigte Telegram-Verknüpfung ist nur verfügbar, wenn die Funktion in der Region aktiviert ist; das Verbinden des Kanals allein reicht nicht.

Nächste Schritte

Dynamische Segmente

Unter Segmente definieren Sie eine Zielgruppe mit Bedingungen, die Sie durch UND oder ODER verknüpfen. Prüfen Sie die Definition vor dem Speichern in der Vorschau. Berechnen Sie nach Änderungen die Teilnehmer neu und prüfen Sie vor der Verwendung in einem Broadcast, ob das Segment bereit ist. Das bloße Speichern einer Definition bestätigt nicht, dass die Teilnehmerzahl aktuell ist.