So verwenden Sie Variablen

Lassen Sie uns erkunden, was Variablen sind und wie man sie effektiv beim Erstellen von Chatbots in MaviBot einsetzt.

Bitte beachten Sie die folgenden Systemgrenzen für Variablen und Konstanten innerhalb eines einzelnen Projekts:

Vorlagenvariablen:

  • Maximale Anzahl: 100 Variablen
  • Maximale Namenslänge: 100 Zeichen

Projektkonstanten:

  • Maximale Anzahl: 50 Konstanten
  • Maximale Namenslänge: 100 Zeichen
  • Maximale Wertlänge: 5.000 Zeichen

Eine Variable ist ein benannter Speicherort für Daten, der durch eine eindeutige Textbezeichnung identifiziert wird.

Abb. 1: Eine Variable namens total, die einen Zahlungsbetrag speichert.

MaviBot bietet verschiedene Arten von Variablen:

  1. Eingebaute Variablen
  2. Systemvariablen
  3. Benutzerdefinierte Variablen – diese erstellen Sie selbst innerhalb des Projekts.

Eine Variable deklarieren bedeutet, einem benannten Container einen Wert zuzuweisen. Mit anderen Worten: Eine Anweisung wie a=0 ist die Deklaration der Variablen a. Wir haben dem Builder gerade mitgeteilt (deklariert), dass wir eine Zahl in der Variablen a speichern werden, und vorerst ist dieser Wert 0.

Einer Variablen einen Wert zuweisen hat dieselbe Bedeutung.

Die Ausdrücke "einer Variablen den Wert einer Funktion zuweisen" oder "eine Variable gleich einer Funktion setzen" werden ebenfalls häufig verwendet. Das Prinzip ist dasselbe: Anstatt einen bestimmten Wert zuzuweisen, weisen Sie das Ergebnis einer Funktion zu. Beispiel: s_id = tg_send_message(platform_id, "Hallo!") In diesem Fall wird das Ergebnis der Funktion in der Variablen gespeichert.

Eine Variable zurücksetzen bedeutet, ihr den Wert 0 zuzuweisen.

Funktionen und Methoden sind vordefinierte Befehlssätze, die von MaviBot im Voraus konfiguriert werden. Die meisten Funktionen benötigen Parameter – Werte, die die Funktion oder Methode verstehen kann. Sobald der Bot die erforderlichen Parameter erhält, führt er einen bestimmten Befehl aus.

tg_send_message(platform_id, "Hallo!") — diese Funktion sendet die Nachricht "Hallo!" in Telegram.

Abb. 2. Beispiel einer Variablen namens text1, die einer Funktion zugewiesen ist.

REGELN FÜR DIE ARBEIT MIT VARIABLEN:

  1. Ein Variablenname kann nur mit einem Buchstaben beginnen; er darf nicht mit einer Zahl beginnen.

    Age1 - ✅ korrekt

    1Age - ❌ inkorrekt

    age1 - ✅ korrekt - empfohlene Option

  2. Ein Variablenname darf keine Leerzeichen oder Sonderzeichen enthalten, mit Ausnahme des Unterstrichs (_).

    Name_Nachname - ✅ korrekt

    Name Nachname - ❌ inkorrekt

    nameNachname - ✅ korrekt - empfohlene Option

    Reservierte Wörter aus Programmiersprachen können nicht als Variablennamen verwendet werden, zum Beispiel: print, true, false, count, sum und so weiter.

  3. Es ist strengstens verboten , die Namen von eingebauten und Systemvariablen für benutzerdefinierte Variablen zu verwenden. Die Liste dieser Variablen finden Sie hier. Link

  4. Wir empfehlen:

    • Verwenden Sie lateinische (englische) Namen für Variablen.
    • Verwenden Sie kurze, aber aussagekräftige Variablennamen, zum Beispiel: totalSum, pay_name, ns, name_client usw.

So erhalten Sie den Wert einer Variablen

Setzen Sie den Variablennamen in geschweifte Klammern #{}. Sie können auf diese Weise im Nachrichtentextfeld auf seinen Wert verweisen. Im Feld "Rechner" sollten Sie jedoch einfach mit dem Namen auf den Wert der Variablen verweisen, ohne zusätzliche Syntax.

Die #{} -Konstruktion ermöglicht es Ihnen, den Wert einer Variablen abzurufen. Sie wird im Feld "Nachrichtentext" verwendet, um den Wert der Variablen in den Text einzufügen.

Beispiel:

Das System unterstützt verschachtelte Variablen, bei denen der Wert einer Variablen Teil des Namens einer anderen Variablen ist. Beispiel: #{q#{test#{i}}}

Im Feld "Rechner" beziehen Sie sich auf Variablen mit ihren Namen, ohne die #{} -Notation zu verwenden.
Zum Beispiel, wenn wir zwei Variablen haben: price (summe) und quantity (anzahl).

anzahl = 10

summe = 1500

So zeigen Sie die Gesamtsumme an

Geben Sie Folgendes in den Rechner ein:

gesamt_summe = summe1 * anzahl2 ✅ korrekt

So nicht machen:

gesamt_summe = #{summe1} * #{anzahl2} - ❌ inkorrekt

So löschen Sie eine Variable aus dem Bot

Um eine Variable zu löschen (zu leeren), geben Sie einen der folgenden Befehle in das Feld "Rechner" ein:

IhrVariablenname =

oder

IhrVariablenname = ""

Nach dem Gleichheitszeichen lassen Sie entweder ein Leerzeichen oder verwenden doppelte (oder einfache) Anführungszeichen.

Bitte beachten! Es ist wichtig, das richtige Präfix zu verwenden, um anzugeben, wohin die Variable gehört.

Für Variablen auf Projektebene (gespeichert in den Projekteinstellungen) verwenden Sie das Präfix project:

Beispiel:
project.IhrVariablenname =
oder
project.IhrVariablenname = ""

Für Variablen auf Kundenebene verwenden Sie das Präfix client:

Beispiel:
client.IhrVariablenname = oder
client.IhrVariablenname = ""

Für Variablen auf Auftragsebene ist kein Präfix erforderlich.

Eingebaute Variablen

Hier ist die Liste der eingebauten Variablen:

#{none} - Nachricht ignorieren

#{api_key} - API-Token, der in Mavibot-API-Aufrufen verwendet wird

#{attachment_url} - enthält den Link zum Anhang

#{attachments} - ein JSON-Array von Anhang-URLs aus der Nachricht des Benutzers

#{avatar} - Link zum Avatar des Benutzers (angezeigt im Bereich "Kunden")

#{client_id} - Kunden-ID im Builder, auch in API-Anfragen verwendet

#{client_type} - der Typ des Messengers, von dem der Kunde kam (Werte [hier] beschrieben)

#{current_date} - aktuelles Datum im Format TT.MM.JJJJ, basierend auf der Zeitzone des Projekts

#{current_time} - aktuelle Uhrzeit im Format HH:MM, basierend auf der Zeitzone des Projekts

#{custom_answer} - die Antwort, die vom Server empfangen wurde, der im Feld "Serverantwort-URL" angegeben ist

#{message_from_outside} - Typ der eingehenden Nachricht. Mögliche Werte:
&#xNAN;normale Nachricht = 0
Nachricht über API gesendet = 1
Callback-Benachrichtigung (gelber Hintergrund im Dialog) = 3
Telefonie-Benachrichtigung (hellblauer Hintergrund im Dialog) = 5
Diese Variable wird bei jeder eingehenden Nachricht generiert, erscheint jedoch nicht in der Kundenkarte.
Sie können sie im Feld "Variable zum Vergleich" verwenden, um Bedingungen für Block-Trigger und Verbindungen festzulegen.

#{date_of_creation} - Datum, an dem der Benutzer zum Bot hinzugefügt wurde oder ihn zum ersten Mal angeschrieben hat

#{full_name} - vollständiger Name des Benutzers (Vor- und Nachname)

#{group} - Bot, mit dem der Kunde verknüpft ist (angezeigt als "Mit Bot verknüpft" in der Kundenkarte)

#{main_client_id} - ID des Hauptkunden innerhalb einer Gruppe verknüpfter Kundenkarten

#{message_id} - aktuelle Konversationsstatus-ID mit dem Kunden (Standardwert ist NONE)

#{messenger} - Name des Messengers, von dem der Kunde kam

#{name} - Vorname des Benutzers

#{next_day} - morgiges Datum im Format TT.MM.JJJJ (nützlich für die Terminierung von Nachrichten)

#{order_id} - Auftragskennung (Kunden-ID und interne Auftrags-ID, getrennt durch einen Bindestrich)

#{order} - Inhalt der vom Benutzer übermittelten Bestellung

#{platform_id} - Kunden-ID in der Messaging-Plattform

#{question} - vom Benutzer gesendete Nachricht

#{timestamp} - aktueller Zeitstempel einschließlich Millisekunden

#{time_of_creation} - Uhrzeit, zu der der Benutzer zum Bot hinzugefügt wurde oder ihn zum ersten Mal angeschrieben hat

#{wa_bot} - WhatsApp-Nummer, die der Benutzer angeschrieben hat (nützlich für die Übergabe an CRM-Felder und die Verteilung von Leads an Manager)

#{weekday} - Wochentag als Zahl (Montag = 1, Dienstag = 2 usw.)

client_type-Werte

Wert Messenger
1 für Telegram
2 für Viber
3 für Facebook
5 für Online-Chat
10 für Instagram
14 E-Mail
16 Telegram Business Account
21 Telegram-Konto
22 TikTok

Systemvariablen

Das System generiert während des Bot-Betriebs automatisch verschiedene Laufzeitvariablen. Sie können diese Variablen beim Erstellen Ihres Bots verwenden. Hier ist eine Liste derer, die für Sie nützlich sein könnten.

Zusätzliche Systemvariablen finden Sie in der Dokumentation. Sie befinden sich in den Abschnitten, die für ihre Verwendung relevant sind.

phone - Telefonnummer

notSubscribed - wenn die Variable gleich 1 ist, hat der Kunde Nachrichten abbestellt und wird keine Nachrichten mehr erhalten

clientBlocked - Kunde ist blockiert, und der Bot arbeitet nicht für ihn

story_url - Kennung der Instagram-Story, auf die der Kunde geantwortet hat

viewed_page - Seite, von der der Benutzer im Online-Chat schreibt

wa_bot - Telefonnummer des WhatsApp-Bots

Informationen darüber, welche Variablen während der Zahlung erstellt werden können, finden Sie in den Integrationsleitfäden für Zahlungsdienste im Abschnitt "Zahlungssystem".

Benutzerdefinierte Variablen

Benutzerdefinierte Variablen werden unterteilt in:

Jeder Variablentyp wird im Folgenden erläutert.

Bitte vermeiden Sie die Verwendung derselben Namen für verschiedene Variablentypen, um Verwirrung zu vermeiden, wenn der Builder einen anderen Wert als erwartet anzeigt oder verwendet.

Beim Zuweisen eines Werts zu einer Variablen ist es wichtig, ihren Typ durch die Verwendung des entsprechenden Präfixes anzugeben:

client. (für Kundenvariablen) und project. (für Projektvariablen). Für Auftragsvariablen wird kein Präfix verwendet.

Das Präfix wird beim Abrufen des Werts einer Variablen weggelassen.

Beispiel:
Stellen Sie sich vor, Sie möchten eine Projektvariable namens like erstellen, die als Zähler für Likes Ihrer Kunden dient.

project.like = 0 - Deklaration, einmalig durchgeführt

In dem Block, in dem Sie Likes zählen müssen, schreiben Sie:
project.like = like + 1

Prioritätsreihenfolge der Variablen:
Auftragsvariablen haben die höchste Priorität, gefolgt von Kundenvariablen, dann Projektvariablen.

Messenger-ID (platform_id)

Messenger-ID (platform_id) ist die Kennung des Benutzers/Chats/Kanals innerhalb des Messengers. Um sie zu finden, öffnen Sie die Konversation mit dem gewünschten Kunden im Bereich "Kunden". Navigieren Sie auf der rechten Seite des Chatfensters zum Tab "Über Kunde - Systemvariablen" oder zum Tab "Alle".

Die platform_id ist eine permanente, systemgenerierte Variable, die die eindeutige Messenger-ID des Benutzers darstellt.

  • Beständigkeit: Diese ID bleibt für einen Benutzer konstant. Selbst wenn Sie seinen Datensatz aus dem Builder löschen, bleibt seine platform_id bei einer erneuten Registrierung dieselbe.
  • Herkunft: Die ID wird von der Messenger-Plattform (z. B. Telegram, WhatsApp) zugewiesen, wenn der Benutzer zum ersten Mal mit dem Bot interagiert.

Das folgende Beispiel zeigt, wie die platform_id in einer Kundenkarte erscheint.

Die platform_id-Variable existiert sowohl für reguläre Benutzer als auch für Communities, Kanäle und Chats.

Um die platform_id (Messenger-ID) eines Telegram-Kanals zu erhalten, in dem der Bot Administrator ist, senden Sie einfach eine Nachricht von Ihrem persönlichen Konto an den Kanal. Dadurch wird automatisch ein Dialog zwischen dem Bot und dem Kanal erstellt.

Sie können den Wert platform_id des Kanals im Abschnitt „Über den Client“ kopieren.

In Telegram beginnt die Messenger-ID für Kanäle immer mit einem Minuszeichen (-). Wenn Sie Funktionen verwenden, stellen Sie sicher, dass Sie den gesamten Wert einschließlich des Minuszeichens angeben.

Verwendung von Variablen

Variablen können in Triggern, Aufträgen, Benutzerantworten, Blöcken und mehr verwendet werden. Betrachten wir ein konkretes Beispiel bei der Erstellung eines Trichters für eine Immobilienagentur.

Erstellen wir also einen Startblock:

Schritt 1: Erstellen Sie den Block „Danke“

Erstellen Sie einen neuen Block mit einer Nachricht, die dem Benutzer für seine Eingabe dankt.

Schritt 2: Konfigurieren Sie den Übergang

Konfigurieren Sie auf der Verbindung, die zu diesem Block führt, den folgenden Trigger:

  1. Aktivieren Sie den Schalter „Benutzer gibt Daten ein“.
  2. Geben Sie im Feld „Eingabedaten“ den Variablennamen ein: name.

Die Eingabe des Benutzers wird in der Variablen Name gespeichert. Dieser Wert kann in jedem nachfolgenden Block wiederverwendet werden, indem die Variable mit der Syntax #{Name} aufgerufen wird, z. B.: Willkommen, #{Name}!.

Der Bot funktioniert wie folgt:

Machen wir die Aufgabe nun etwas komplexer.

In diesem selben Block fragen wir den Benutzer, ob er an Erstbezug (Neubau) oder Zweitbezug (Wiederverkauf) interessiert ist:

Erstellen Sie als Nächstes Verbindungen von den Schaltflächen „Erstbezug“ und „Zweitbezug“ im Block „Chat“.

Betrachten wir nun die zweite Möglichkeit, Variablen innerhalb von Blöcken zu verwenden.

Wählen Sie den rechten Block aus und geben Sie den folgenden Text in das Feld „Rechner“ ein:
client_interest = Erstbezug. Geben Sie im linken Block ein:
client_interest = Zweitbezug.

Eine Variable wird dem Benutzer zugewiesen, wenn er zu einem dieser Blöcke wechselt. Wir können sie später bei der Erstellung eines Auftrags verwenden.

Als Nächstes fragen wir den Kunden in diesen Blöcken nach seinem Budget für den Immobilienkauf und erstellen zwei weitere Blöcke mit Pfeilen, die basierend auf den Triggern der Kundenantworten zu ihnen führen.

Erstellen Sie vom Block „Wie hoch ist Ihr Budget?“ eine Verbindung und legen Sie eine Triggerbedingung fest, um Benutzer basierend auf ihrer Eingabe zu segmentieren.

  1. Aktivieren Sie in den Einstellungen der Verbindung das Kontrollkästchen für „Benutzer gibt Daten ein“.
  2. Weisen Sie einen Variablennamen (z. B. budget) zu, um die Antwort des Kunden zu speichern.
  3. Verwenden Sie im Feld „Variable“ die integrierte Variable #{question} (die die letzte Nachricht des Benutzers enthält), um eine Bedingung zu erstellen.
    • Beispiel: #{question} <= 1000000

Aktivieren Sie für alle Verbindungen zu „Leads“-Blöcken „Benutzer gibt Daten ein“ und definieren Sie die Variable.

Sie können auch eine zusätzliche Variable direkt im „Leads“-Block definieren, um umfassendere Geschäftsinformationen bereitzustellen.

Ändern Sie nun den Typ der letzten beiden Blöcke in „Leads“ und sehen Sie sich die Ergebnisse an:

Testen wir den Ablauf in Aktion:

Sie können das erstellte Geschäft und die gespeicherten Daten des Kunden überprüfen, indem Sie zum Abschnitt „Kunden“ gehen und die entsprechende Konversation öffnen. Die Geschäftsvariablen werden dort sichtbar sein.

Jetzt wissen Sie, wie Sie Variablen auf mindestens drei verschiedene Arten verwenden:

  1. Weisen Sie Variablennamen für Benutzereingabedaten zu (z. B. „Name“, „Budget“)
  2. Weisen Sie einen Variablenwert beim Übergang zu einem Block zu (z. B. client_interest = Erstbezug)

Anzeigen von Variablen

Um die Variablen eines Kunden anzuzeigen, navigieren Sie zum Abschnitt „Kunden“ und öffnen Sie die Kundenkarte.

Variablen werden in der Kundenkarte als Liste angezeigt:

  • Jede Variable belegt eine eigene Zeile.
  • Der Variablenname wird links angezeigt.
  • Der entsprechende Wert wird rechts angezeigt.

So ändern Sie eine Variable:

Bewegen Sie den Mauszeiger über die Zeile in der Liste, um eine Aktionsschaltfläche anzuzeigen. Durch Klicken auf diese Schaltfläche können Sie:

  • Den Namen der Variable bearbeiten.
  • Den Wert der Variable bearbeiten.
  • Die Variable vollständig löschen.

Systemvariablen können nicht bearbeitet werden!

Festlegen von Kunden-Variablen

Kunden-Variablen werden nicht gelöscht, zurückgesetzt oder verloren, wenn der Block „Ende der Datenerfassung“ (roter Block) verwendet wird.

Eine Kunden-Variable kann auf zwei Arten festgelegt werden: explizit und implizit.

Eine explizite Möglichkeit, eine Variable zu definieren, besteht darin, sie im Feld „Rechner“ eines der Trichterblöcke festzulegen.

Beispiel: client.age = 28 oder client.age = 28:

Die implizite Möglichkeit besteht darin, eine Variable im Dateneingabefeld des Pfeils festzulegen.

Beispiel:

Erstellen wir einen Block, in dem wir nach dem Namen des Kunden fragen, und erstellen wir darunter einen weiteren Block:

Gehen Sie als Nächstes zu den Verbindungseinstellungen und aktivieren Sie die Option „Benutzer gibt Daten ein“.

Verwenden Sie das Präfix client. bei der Benennung Ihrer Variable (z. B. client.name), um die Eingabe des Benutzers zu speichern. Auf diese Variable kann dann in späteren Nachrichten als #{client.name} verwiesen werden.

Kunden-Variablen werden im Builder genau wie normale Variablen verwendet, jedoch ohne das Präfix client.

Festlegen von Projekt-Variablen

Globale Variablen werden nicht gelöscht, zurückgesetzt oder verloren, wenn der Block „Leads“ (roter Block) verwendet wird.

Globale Variablen sind für alle Benutzer des Bots zugänglich. Sie eignen sich ideal zur Steuerung des Bot-Verhaltens oder zur Erleichterung von Interaktionen zwischen verschiedenen Benutzern.

Anwendungsbeispiel:
Ein Benutzer kann einen Artikel in einem Marktplatzkanal veröffentlichen, indem er eine Variable setzt (z. B. project.latest_listing), und alle anderen Benutzer können ihn sehen und darauf reagieren.

Syntax für die Zuweisung

Um eine globale Variable zu erstellen oder zu aktualisieren, verwenden Sie das Präfix project. im Rechner:

Beispiele:

  • project.product_shop = 28
  • project.age = 28

Sie können ohne Präfix verwendet werden.

Sehen wir uns an, wie die Daten in der Tabelle angezeigt werden.

Führen Sie nun den Block „Start“ im Testmodus aus.

Wir können die Daten sehen, die aus der Tabelle in die Variable geschrieben wurden, in der vom Bot gesendeten Nachricht. Da wir in der Nachricht mit der Syntax #{} auf die Variable verwiesen haben, wurden die darin gespeicherten Daten im Bot-Chat angezeigt.

Weitere Details zur Arbeit mit der Funktion get_records_from_table() finden Sie im Artikel „KI-Assistent mit MaviBot-Tabelle“.

Das Präfix project. ermöglichte es der Funktion, die Tabellendaten direkt in die globalen Variablen des Projekts zu schreiben, die im Abschnitt „Variablen“ zugänglich sind.

Sie können Projektvariablen in den Projekteinstellungen bearbeiten.

Beispiel: Verwendung von Projektvariablen

Erstellen Sie ein System, das jedem neuen Kunden, der den Bot betritt, eine fortlaufende Nummer zuweist.

Implementierung:

  1. Navigieren Sie zu Ihren Projekteinstellungen.
  2. Erstellen Sie eine neue Projektvariable (z. B. project.client_counter).

  1. Setzen Sie ihren Anfangswert (z. B. 0), was bedeutet „Keine Kunden im Bot“:

Fügen Sie im Startblock des Bots eine Logik hinzu, die:

  1. Den Wert der Projektvariable um 1 erhöht.
  2. Den neuen Wert einer kundenspezifischen Variable für den aktuellen Benutzer zuweist.

Vergessen Sie nicht, eine Einschränkung festzulegen, damit der Zähler für denselben Kunden nicht zweimal erhöht werden kann.

Festlegen von Konstanten-Variablen

Konstanten sind feste Werte, die während des gesamten Projektlebenszyklus unverändert (oder selten geändert) bleiben.

Hauptunterschied zu globalen Variablen:

Im Gegensatz zu globalen Variablen sind Konstanten kundenspezifisch. Wenn der Wert einer Konstanten geändert wird, gilt die Änderung nur für die Sitzung dieses einzelnen Kunden.

Häufige Anwendungsfälle:

Konstanten eignen sich ideal zum Speichern statischer Daten wie:

  • Produktpreise und Kundenrabatte
  • Integrations-Tokens und API-Schlüssel
  • Verkäufer- oder Support-Kontaktinformationen
  • Alle anderen festen Konfigurationswerte

Beispiel: Verwendung von Konstanten-Variablen

Beispielsweise könnte der Rabatt eines Kunden standardmäßig 10 % betragen, sich aber bei Eingabe eines Aktionscodes auf 25 % ändern.

Gehen Sie in „Projekteinstellungen“ → „Konstanten“ und geben Sie ein: Rabatt : 10

Um einen Aktionscode einzugeben, fügen Sie einen Block „Trigger“ hinzu, in dem wir der Variablen rabatt den Wert 25 zuweisen.

Zeigen Sie die Variable an, die den Rabattbetrag im grünen Block anzeigt:

Schritt 1: Konfigurieren Sie den automatischen Übergang
Erstellen Sie eine Verbindung mit einem Null-Sekunden-Timer vom grauen Block. Dadurch wird sichergestellt, dass der Rabatt sofort angewendet wird und der Kunde zur Nachricht im Startblock gelangt.

Schritt 2: Testen Sie den Ablauf
Schreiben Sie nun eine Nachricht an den Bot, um die gesamte Sequenz auszulösen und zu testen.

Der Standardrabatt beträgt 10 % ohne Aktionscode. Die Eingabe eines gültigen Aktionscodes ändert die Situation jedoch.

Nach Eingabe des Aktionscodes wurde die Variable „rabatt“ für diesen Kunden also 25.

Dies geschah, weil eine Zuweisung wie rabatt = 25 den Wert für die Geschäftsvariable setzte, anstatt den Wert der Konstanten mit demselben Namen zu ändern.

Wichtige Geschäftsvariablen

name - Geschäftsname. Der Begriff Name wird für die internationale Version des Projekts verwendet.

description - Geschäftsbeschreibung. Description wird in der internationalen Version des Projekts verwendet.

budget - Geschäftsbetrag (Zahl).

Um Variablen mit der API-Anfrage /set_order_vars zu bearbeiten, müssen Sie die Namen genau wie in dieser Anleitung verwenden, einschließlich Groß-/Kleinschreibung und der Projektversion.

Grenzen

Maximale Länge des Variablennamens: 500 Zeichen

Maximale Länge des Variablenwerts: 100.000 Zeichen

Maximale Anzahl von Variablen pro Kunde oder Deal: 1.000 Zeichen.

So arbeiten Sie korrekt mit Variablen

Wann sollte der Wert einer Variable in Anführungszeichen gesetzt werden?

Zum Beispiel client_id = 1202020202 oder client_id = '1202020202'?

Beide Syntaxoptionen sind funktional korrekt. Die Verwendung von Anführungszeichen um einen Wert beeinflusst nur dessen visuelle Hervorhebung im Rechnereditor.

Die Einhaltung konsistenter Codierungskonventionen verbessert jedoch die Lesbarkeit und Wartbarkeit:

  • Keine Anführungszeichen für numerische Werte (z. B. discount = 25).
  • Anführungszeichen für Zeichenfolgen-Werte (z. B. status = "active").

Wie lautet die korrekte Syntax zum Übergeben von Identifikatoren wie Kunden-ID, Site-ID, Block-ID oder Zertifikats-ID an Funktionen – sollten sie in Anführungszeichen gesetzt werden?

Eine ID sollte nicht in Anführungszeichen gesetzt werden, wenn sie an eine Methode oder Funktion übergeben wird:

Welche sollten verwendet werden: doppelte oder einfache Anführungszeichen?

Es gibt keinen Unterschied zwischen der Verwendung von einfachen oder doppelten Anführungszeichen, aber wir empfehlen die Verwendung von doppelten Anführungszeichen. Auf diese Weise wird beispielsweise beim Einfügen einer Variable in eine Zeichenfolge die Variable in einer anderen Farbe hervorgehoben, was sie leichter erkennbar macht.

Wie sollten Leerzeichen gesetzt werden?

Funktioniert es genauso, wenn ein Leerzeichen zwischen der Variable und dem Gleichheitszeichen steht (z. B. ans="yes", ans = "yes", ans= "yes", ans ="yes"?

Leerzeichen beeinflussen die Funktionsweise von Methoden, Variablen oder Funktionen nicht. Es wird jedoch empfohlen, Leerzeichen im Code zu verwenden, um die Lesbarkeit zu verbessern.

Wie schreibt man Kommentare im Rechner korrekt

Weitere Details zum Schreiben von Kommentaren im Rechner finden Sie in diesem Artikel.

Wie man Variablen vergleicht

Sie können den Ablauf des Chatbots steuern, indem Sie Variablenwerte vergleichen. Dies ermöglicht es Ihnen, bedingte Logik zu erstellen, z. B. um das Alter eines Benutzers für die Einhaltung gesetzlicher Vorschriften zu überprüfen oder Interaktionen basierend auf der Messenger-Plattform des Benutzers zu leiten.

Hier erfahren Sie, wie Sie den Trichter nach verschiedenen Messengern oder nach verschiedenen Konten desselben Messengers aufteilen können.

Unterstützte Operatoren:

"+": Addition
"-"': Subtraktion
"*" Multiplikation
"/": Division
"%'": Rest der Division
"^" "**": Potenzierung
"and" "AND" "&&": logisches UND
"or" "OR" "||": logisches ODER

Vergleichsoperatoren:
"==" — gleich
"!=" — ungleich
">" — größer als
"<" — kleiner als
">=" — größer oder gleich
"<=" — kleiner oder gleich

WICHTIG!
Um zu überprüfen, ob das integrierte Variable-Tag (das Bot-Start-Tag) nicht in der Kundenkarte vorhanden ist, verwenden Sie die folgende Vergleichsmethode:

tag == "NONE"

Variablen sollten in der Bedingung im Feld "Variable" verglichen werden (sowohl in den Verbindungseinstellungen als auch in den Blockeinstellungen):

Beispiel für einen Variablenvergleich im Feld "Variable" eines Trigger-Blocks.

Beispiel für einen Variablenvergleich im Feld "Variable" einer Blockverbindung.

Wie Variablen und Trigger zusammenarbeiten

Damit eine Verbindung aktiviert wird, müssen beide Trigger erfüllt sein:

  1. Die Bedingung im Feld "Trigger".
  2. Die Vergleichslogik im Feld "Variable".

Das Feld "Variable" verstehen

Wenn Sie nur einen Variablennamen (z. B. client_type) in das Feld "Variable" ohne einen Ausdruck eingeben, prüft das System auf die Existenz oder Wahrheit des Variablenwerts. Es vergleicht ihn nicht mit der rohen Benutzereingabe.

Beispiel:
Die folgende Konfiguration prüft, ob der Kunde von WhatsApp kommt, indem sie überprüft, ob die Variable client_type gleich 6 ist (wobei 6 für WhatsApp steht).

client_type == 6

Das folgende Beispiel funktioniert identisch:

Bitte beachten Sie!
Sie können im Feld "Trigger" keine mehreren Werte für den Variablenvergleich angeben.

Das ist falsch!

Wenn Sie mehrere Variablen vergleichen müssen, geben Sie deren Werte im Feld "Variable" an.

Diese Optionen sind korrekt.

client_type == 3 Übergang, wenn der Variablenwert gleich 3 ist
attachments != None Übergang, wenn die Variable einen beliebigen Wert enthält
attachments == None Übergang, wenn die Variable nicht gesetzt ist
product_quantity >= 100 Übergang, wenn die Produktmenge größer oder gleich 100 ist
product_quantity <= 100 Übergang, wenn die Produktmenge kleiner oder gleich 100 ist
name == "John" Übergang, wenn der Variablenname gleich John ist

Um zu überprüfen, ob eine Variable leer ist oder nicht, verwenden Sie die Ausdrücke:
&#xNAN;"#{value}" == ""
"#{value}" != ""

(wobei value der Variablenname ist).

Das Ergebnis der Vergleichsoperation gibt einen booleschen Wert zurück: True oder False.

Maximale Ausdruckslänge: 1000 Zeichen

Der Standardwert wird als Ergebnis zurückgegeben, wenn versucht wird, Werte unterschiedlicher Typen zu vergleichen.

"==" - False "<" - False
"!=" - True ">=" - False
">" - False "<=" - False

WICHTIG!
Um zu überprüfen, ob das integrierte Variable-Tag (das Bot-Start-Tag) nicht in der Kundenkarte vorhanden ist, verwenden Sie die folgende Vergleichsmethode:

tag == "NONE"

Beispiel: ein Bot, der das Alter eines Benutzers überprüft (age).

  • Wenn age < 18, sendet er eine Nachricht für Minderjährige.
  • Wenn age >= 18, sendet er eine Nachricht für Erwachsene.

Beachten Sie, dass der Ablauf einen Block ohne Trigger enthält, von dem zeitgesteuerte Verbindungen ausgehen.

Dieser Block ist absichtlich so gestaltet, um zu demonstrieren, wie Abläufe erstellt werden, bei denen der Bot nicht auf Benutzeraktionen, sondern auf Berechnungsergebnisse reagiert. Im ersten Schritt wird die Antwort in einer Variable gespeichert, und dann findet der Vergleich statt. Die Verzögerung auf den Pfeilen ist auf 0 gesetzt, um eine sofortige Antwort zu erhalten.

Der Vergleich "Age >= 18" kann auch als "größer oder gleich 18" ausgedrückt werden.

Bitte beachten Sie die Fehler in den Triggern:

Eine Zahl kann nicht gleichzeitig größer als, kleiner als und gleich 18 sein!

Diese Trigger sind bedeutungslos. Jede Zahl ist entweder kleiner als 18, größer als 18 oder gleich 18.

Wichtig!

Logische Trigger mit Variablen müssen im Feld "Variable" geschrieben werden, nicht im Feld "Trigger"!

Zum Beispiel wird der Block im Bild unten ausgelöst, wenn die Variable phone ausgefüllt ist (d. h. ungleich None):

Das nächste Beispiel zeigt, wie man Operatoren kombiniert:

Wenn der Kunde eine Altersvariable mit einem Wert zwischen 18 und 99 hat, wird der Block ausgelöst. Wenn die Variable fehlt oder das Alter kleiner als 18 oder größer als 99 ist, wird der Block nicht aktiviert.

Hinweis!

Wenn Sie eine Variable mit einem Wert in Anführungszeichen vergleichen, stellen Sie sicher, dass keine Leerzeichen zwischen den Anführungszeichen und dem Wert sind; andernfalls kann der Block möglicherweise nicht ausgelöst werden oder sich falsch verhalten!

Richtig (kein Leerzeichen vor dem Anführungszeichen oder nach dem Wert my_new_bot):

Falsch (mit einem Leerzeichen vor dem Anführungszeichen):