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 sehen | Daten der Schaltfläche |
|---|---|
| Mantel, 12.000 ₽ · Kaufen | product_id=101, price=12000 |
| Kleid, 8.000 ₽ · Kaufen | product_id=102, price=8000 |
| Turnschuhe, 6.000 ₽ · Kaufen | product_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:
| Feld | Beispiel | Wirkung |
|---|---|---|
Liste (over) | ctx.products | Produktliste 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.
- Wählen Sie
ctx.products, Elementaliasitemund eine Schaltfläche pro Zeile. - Schreiben Sie als Beschriftung
{{item.name}} · {{item.price}} ₽. - Wählen Sie den Typ Reaktion aufrufen und die Bestellreaktion.
- Fügen Sie unter Carry den Schlüssel
product_idmit Wert{{item.id}}hinzu. - 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_idwird 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_secondsoder TTL): Sekunden, die die Daten aufbewahrt werden.3600ist eine Stunde.0wä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
| Aufgabe | Einstellung | Ergebnis lesen |
|---|---|---|
| Gewähltes Produkt an die nächste Reaktion geben | Carry | {{ctx.product_id}} |
| Stadt nach der Auswahl behalten | set_params an der Schaltfläche | {{param.city}} |
| Wert schon beim Senden speichern | set_params am Nachrichtenblock | {{param.schlüssel}} |
Weiterführende Artikel
- Nachrichten und Schaltflächen: Nachrichtenblöcke und Klickverhalten.
- Ersetzungen und Formeln:
{{item.*}},{{ctx.*}},{{param.*}}. - Reaktionsverknüpfungen: Ziele der Schaltflächen.
- Sammlungen und Daten: Listenquellen.