Arbeiten mit MaviBot-Labels

Label erstellen / entfernen

MaviBot-Labels werden im Kundenprofil wie folgt angezeigt:

und im Abschnitt "Listen" :

create_label(label_name)
erstellt ein MaviBot-Tag mit dem angegebenen Namen

Parameter:\ ! label_name- Tag-Name, in einfachen Anführungszeichen ('') angegeben.

add_label(label_name, client_id)
fügt einem Kunden ein MaviBot-Tag hinzu

Parameter:\ ! label_name - Tag-Name, in einfachen Anführungszeichen ('') angegeben
client_id Kunden-ID. Wenn nicht angegeben, wird die aktuelle Kunden-ID verwendet

remove_label(label_name, client_id)
entfernt ein Tag von einem Kunden

Parameter:\ ! label_name - Tag-Name, in einfachen Anführungszeichen ('') angegeben
client_id - Kunden-ID. Wenn nicht angegeben, wird die aktuelle Kunden-ID verwendet

has_label(label_name, client_id) - prüft, ob ein Kunde ein Tag hat

Parameter:\ ! label_name - Tag-Name, in einfachen Anführungszeichen ('') angegeben
client_id - Kunden-ID. Wenn nicht angegeben, wird die aktuelle Kunden-ID verwendet

remove_label_everywhere(label_name)
entfernt ein Tag von allen Kunden

Parameter:\ ! label_name- Tag-Name, in einfachen Anführungszeichen ('') angegeben

count_of_clients_with_label(label_name)
gibt die Gesamtzahl der Kunden mit diesem Tag zurück

Parameter:\ ! label_name- Tag-Name, in einfachen Anführungszeichen ('') angegeben

Sehen wir uns nun an, wie ein MaviBot-Tag erstellt wird.

Sie müssen die Erstellungsfunktion nur einmal im grauen Block (einem zustandslosen Block) ausführen, zum Beispiel:

Gleichzeitig kann die Variable a verwendet werden, um den Erfolg der Tag-Erstellungsfunktion zu analysieren:

Als nächstes können Sie einem beliebigen Kunden ein Label zuweisen, indem Sie die Funktion add_label() im entsprechenden Block Ihres Trichters hinzufügen:

Sie können mit der Funktion has_label() überprüfen, ob ein Kunde ein Label hat:

Die Funktion gibt einen logischen Wert zurück: True oder False.

Andere labelbezogene Aktionen werden ähnlich ausgeführt – Entfernen eines Labels von einem bestimmten Kunden oder vollständiges Entfernen eines Tags von allen Kunden.

Sie können auch die Anzahl der Kunden mit einem bestimmten Label mit der Funktion count_of_clients_with_label() zählen.

/Tag erstellen/ a=create_label('tag1')

/Tag Kunde zuweisen/ a=add_label('stage 1')

/Prüfen, ob Kunde Tag hat/ a=has_label('step 1','73704021')

/Anzahl der Kunden mit bestimmtem Tag zählen/ step1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

Ein Label erstellen

create_label(label_name) - erstellt ein MaviBot-Tag mit dem angegebenen Namen

Parameter:

! label_name- Tag-Name, in einfachen Anführungszeichen ('') angegeben

Ein Label ohne Duplikate erstellen

create_label_if_not_exist(name, color) - erstellt ein neues Label, falls noch keines mit demselben Namen existiert, und gibt dessen Kennung zurück; andernfalls wird die Kennung des vorhandenen Tags zurückgegeben

name — Label-Name

color — Label-Farbe (Standard: 0)

Farbtabelle für den Parameter color:

0 — hellgrau

1 — gelb

2 — blau

3 — rot

4 — pink

5 — beige

6 — lila

7 — hellblau

8 — grau

9 — grün

Alle Kundenlabels abrufen

get_all_client_labels(client_id)

Parameter:

client_id - optional; falls nicht angegeben, werden die Tags des aktuellen Kunden abgerufen.

Die Funktion gibt eine Antwort im JSON-Format zurück: {"161":"tag1","228":"tag2"}, wobei: Schlüssel die Label-ID und Wert der Label-Name ist

Kundenlabels per Array löschen

remove_multiple_client_labels(labels_array, names) - löscht die im Array angegebenen Tags

labels_array - Tags-Array. ODER ID-Array****,**** ODER Namen-Array.

Wenn ein Namen-Array übergeben wird, dann**❗muss zwingend der zweite Parameter (names) auf 1 gesetzt werden.**

names - Auf 1 setzen, wenn das Array Tag-Namen anstelle von IDs enthält. Dies gibt an, dass das Array aus Namen besteht.

Es ist NICHT erlaubt, Tag-IDs und Tag-Namen in derselben Funktion zu kombinieren!

/*Tags nach ID löschen*/

r = remove_multiple_client_labels('[138,169,166]')

/*Tags nach Tag-Namen löschen*/

r2 = remove_multiple_client_labels('["newTestTag","tag2"]', 1)

Die Variable speichert das Ergebnis der Funktionsausführung: entweder eine Fehlermeldung oder eine Zahl, die angibt, wie viele Tags gelöscht wurden.

Kunden nach mehreren Labels finden

find_clients_by_multiple_labels(labels_array, names) - findet Kunden anhand mehrerer Tags

WICHTIG! Es werden nur die Kunden gefunden, die ALLE angegebenen Tags besitzen.

Parameter:

labels_array - Tags-Array. ODER ID-Array****,**** ODER Namen-Array.

Wenn ein Namen-Array übergeben wird, dann**❗muss zwingend der zweite Parameter (names) auf 1 gesetzt werden.**

names - Auf 1 setzen, wenn das Array Tag-Namen anstelle von IDs enthält. Dies gibt an, dass das Array aus Namen besteht.

Es ist NICHT erlaubt, Tag-IDs und Tag-Namen in derselben Funktion zu kombinieren!

Gibt ein Array von Kunden-IDs (client_id) zurück: [41121, 41192, 41522]

/*Kunden finden, die alle angegebenen Tags (nach ID) besitzen*/

r = find_clients_by_multiple_labels('[138,169,166]')

/*Kunden finden, die alle angegebenen Tags (nach Tag-Namen) besitzen*/

r2 = find_clients_by_multiple_labels('["newTestTag","tag2"]', 1)

Array von Kundenlabels prüfen

has_client_multiple_labels(labels_array, names) - prüft ein Array von Kunden-Tags

WICHTIG! Gibt True zurück, wenn ein Kunde alle angegebenen Tags besitzt!

Parameter:

labels_array - Tags-Array. ODER ID-Array****,**** ODER Namen-Array.

Wenn ein Namen-Array übergeben wird, dann**❗muss zwingend der zweite Parameter (names) auf 1 gesetzt werden.**

names - Auf 1 setzen, wenn das Array Tag-Namen anstelle von IDs enthält. Dies gibt an, dass das Array aus Namen besteht.

Es ist NICHT erlaubt, Tag-IDs und Tag-Namen in derselben Funktion zu kombinieren!

Gibt entweder einen Fehler zurück, oder True, wenn der Kunde alle Tags aus dem Array besitzt, oder False, wenn der Kunde nicht alle Tags besitzt.

/*Prüfen, ob Kunde alle angegebenen Tags (nach ID) besitzt*/

r = has_client_multiple_labels('[138,169,166]')

/*Prüfen, ob Kunde alle angegebenen Tags (nach Tag-Namen) besitzt*/

r2 = has_client_multiple_labels('["newTestTag","tag2"]', 1)

Alle Kunden-Label-IDs abrufen

get_all_client_label_ids(client_id) — gibt ein Array mit den IDs aller Labels zurück, die dem Kunden zugewiesen sind.

Wenn der Kunde keine Labels hat, gibt die Funktion ein leeres Array zurück: [].

Parameter:

client_id — die Mavibot-Kunden-ID. Wenn nicht angegeben, wird die ID des aktuellen Kunden verwendet.