GetMyBot-Wissensdatenbank

Dynamische Schaltflächen und Parameter

Produkte als Schaltflächen anzeigen, eine Auswahl mit Carry übertragen und dauerhafte Parameter speichern.

Auf dieser Seite

Der Bot zeigt drei Produkte mit einer „Kaufen“-Schaltfläche. Eine Person wählt das Kleid. Die folgende Reaktion muss genau dieses Kleid erkennen, auch wenn der Bot später weitere Produkte gezeigt hat.

Dafür gibt es zwei Einstellungen: Dynamische Schaltflächen erzeugen Schaltflächen aus einer Produktliste; Carry merkt sich die Daten je Schaltfläche. Beides befindet sich im Nachrichtenblock der Aktion Nachricht senden.

Was Käufer sehenDaten der Schaltfläche
Mantel, 12.000 ₽ · Kaufenproduct_id=101, price=12000
Kleid, 8.000 ₽ · Kaufenproduct_id=102, price=8000
Turnschuhe, 6.000 ₽ · Kaufenproduct_id=103, price=6000

Ein Klick auf die zweite Schaltfläche übergibt product_id=102. Der Bot muss das Produkt nicht aus dem Text „Kaufen“ erraten.

Dynamische Schaltflächen aus einer Liste

Holen Sie die Produktliste aus einer Sammlung oder einem externen Dienst, statt jedes Produkt von Hand anzulegen. Dynamische Schaltflächen aus Liste erzeugt eine Schaltfläche pro Element. Die Liste liegt in temporären Reaktionsdaten, dem Kontext (ctx). Vier Felder sind wichtig:

FeldBeispielWirkung
Liste (over)ctx.productsProduktliste aus temporären Daten; zuvor durch „Quelle abfragen“, „Web-Anfrage“ oder „Berechnung“ erstellt
Elementalias (as)item (Standard){{item.name}} ist der Name eines Produkts der Liste
Spalten (columns)1 (Standard)Jedes Produkt steht in einer eigenen Zeile
Schaltflächenvorlage{{item.name}} · {{item.price}} ₽Name und Preis werden für jedes Produkt in Text und weitere Felder eingesetzt

Beim Senden setzt der Bot jedes Produkt in die Vorlage ein. Aus drei Produkten werden drei Schaltflächen. Genauso können Sie freie Kurstermine, Bestellungen oder Menüpunkte anzeigen.

Beispiel

ctx.products enthält Produkte mit id, name und price.

  1. Wählen Sie ctx.products, Elementalias item und eine Schaltfläche pro Zeile.
  2. Schreiben Sie als Beschriftung {{item.name}} · {{item.price}} ₽.
  3. Wählen Sie den Typ Reaktion aufrufen und die Bestellreaktion.
  4. Fügen Sie unter Carry den Schlüssel product_id mit Wert {{item.id}} hinzu.
  5. Verwenden Sie in der Bestellreaktion {{ctx.product_id}}.

Klicken Sie erst die zweite, dann die erste Schaltfläche. Jede Ausführung muss die ID des tatsächlich gewählten Produkts erhalten.

Daten beim Klick übertragen (Carry)

Carry sind die Daten, die eine Schaltfläche beim Klick überträgt. Wie ein Etikett am Produkt hat jede Schaltfläche eigene Werte, auch wenn alle „Kaufen“ heißen und dieselbe Reaktion starten.

Im Editor heißt die Einstellung Daten beim Klick. Die Werte werden beim Senden der Nachricht festgelegt. Beim Klick liest der Bot sie und legt sie in ctx für den neuen Reaktionslauf.

  • Schlüssel: Name des gespeicherten Werts. Aus product_id wird beim Lesen {{ctx.product_id}}.
  • Wert: Zahl oder Ersetzung wie {{item.id}}, {{param.order_id}} oder {{ctx.x}}. Ersetzungen werden beim Senden berechnet.
  • Einmalig (single_use): Nach dem ersten Klick werden die gespeicherten Daten gelöscht und können nicht noch einmal verwendet werden.
  • Gültigkeit (ttl_seconds oder TTL): Sekunden, die die Daten aufbewahrt werden. 3600 ist eine Stunde. 0 wählt den Standard, derzeit 30 Tage, nicht unbegrenzte Zeit.

Nach Ablauf der Gültigkeit sind die alten Daten nicht mehr abrufbar. Geben Sie dem Nutzer eine Möglichkeit, den Katalog erneut zu öffnen. Jede gesendete Schaltfläche hat eigene Werte, selbst bei gleichem Text und Ziel. Technisch heißt das per-invocation.

Dauerhafte Parameter per Schaltfläche (set_params)

Manchmal soll die Auswahl nach der Reaktion erhalten bleiben, etwa eine Lieferstadt für den nächsten Auftrag. Das Feld Parameter (set_params) einer Schaltfläche speichert den Wert beim Klick im Abonnentenprofil. Danach steht die Stadt als {{param.city}} bereit.

Carry überträgt temporäre Werte in den aktuellen Lauf ({{ctx.schlüssel}}); set_params speichert sie zwischen Läufen ({{param.schlüssel}}). Auch ein Nachrichtenblock hat set_params, aber dort erfolgt das Speichern schon beim Senden, selbst wenn niemand klickt.

Eine Schaltfläche kann beim Klick auch Labels setzen oder entfernen, mit denselben Feldern wie ein Nachrichtenblock.

Drei Mechanismen im Vergleich

AufgabeEinstellungErgebnis lesen
Gewähltes Produkt an die nächste Reaktion gebenCarry{{ctx.product_id}}
Stadt nach der Auswahl behaltenset_params an der Schaltfläche{{param.city}}
Wert schon beim Senden speichernset_params am Nachrichtenblock{{param.schlüssel}}

Weiterführende Artikel