MaviBot Etiketleriyle Çalışma

Etiket Oluşturma / Kaldırma

MaviBot etiketleri, müşteri profilinde şu şekilde görüntülenir:

ve "Listeler" bölümünde:

create_label(etiket_adı)
belirtilen ada sahip MaviBot etiketi oluşturur

Parametreler:\ ! etiket_adı- tek tırnak ('') içinde belirtilen etiket adı.

add_label(etiket_adı, müşteri_kimliği)
Müşteriye MaviBot etiketi ekler

Parametreler:\ ! etiket_adı - tek tırnak ('') içinde belirtilen etiket adı
müşteri_kimliği müşteri kimliği. Belirtilmezse, mevcut müşteri kimliği kullanılır

remove_label(etiket_adı, müşteri_kimliği)
Müşteriden etiketi kaldırır

Parametreler:\ ! etiket_adı - tek tırnak ('') içinde belirtilen etiket adı
müşteri_kimliği - müşteri kimliği. Belirtilmezse, mevcut müşteri kimliği kullanılır

has_label(etiket_adı, müşteri_kimliği) - müşterinin etikete sahip olup olmadığını kontrol eder

Parametreler:\ ! etiket_adı - tek tırnak ('') içinde belirtilen etiket adı
müşteri_kimliği - müşteri kimliği. Belirtilmezse, mevcut müşteri kimliği kullanılır

remove_label_everywhere(etiket_adı)
Etiketi tüm müşterilerden kaldırır

Parametreler:\ ! etiket_adı- tek tırnak ('') içinde belirtilen etiket adı

count_of_clients_with_label(etiket_adı)
Etikete sahip toplam müşteri sayısını alır

Parametreler:\ ! etiket_adı- tek tırnak ('') içinde belirtilen etiket adı

Şimdi, bir MaviBot etiketinin nasıl oluşturulduğunu görelim.

Oluşturma işlevini gri blokta (durumsuz blok) bir kez çalıştırmanız yeterlidir, örneğin:

Aynı zamanda, a değişkeni etiket oluşturma işlevinin başarısını analiz etmek için kullanılabilir:

Ardından, huninizin uygun bloğuna add_label() işlevini ekleyerek herhangi bir müşteriye bir etiket atayabilirsiniz:

has_label() işlevini kullanarak bir müşterinin etikete sahip olup olmadığını kontrol edebilirsiniz:

İşlev, mantıksal bir değer döndürür: True veya False.

Etiketle ilgili diğer işlemler de benzer şekilde gerçekleştirilir—belirli bir müşteriden etiketi kaldırma veya etiketi tüm müşterilerden tamamen kaldırma.

Ayrıca, count_of_clients_with_label() işlevini kullanarak belirli bir etikete sahip müşteri sayısını da sayabilirsiniz.

/Etiket oluştur/ a=create_label('tag1')

/Müşteriye etiket ata/ a=add_label('stage 1')

/Müşterinin etiketi olup olmadığını kontrol et/ a=has_label('step 1','73704021')

/Belirli etikete sahip müşteri sayısını say/ step1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')

Etiket Oluşturma

create_label(etiket_adı) - belirtilen ada sahip MaviBot etiketi oluşturur

Parametreler:

! etiket_adı- tek tırnak ('') içinde belirtilen etiket adı

Yinelenen olmadan etiket oluşturma

create_label_if_not_exist(ad, renk) - aynı ada sahip bir etiket henüz yoksa yeni bir etiket oluşturur ve tanımlayıcısını döndürür; aksi takdirde, mevcut etiketin tanımlayıcısını döndürür

ad — etiket adı

renk — etiket rengi (varsayılan: 0)

renk parametresi için renk tablosu:

0 — açık gri

1 — sarı

2 — mavi

3 — kırmızı

4 — pembe

5 — bej

6 — mor

7 — açık mavi

8 — gri

9 - yeşil

Tüm müşteri etiketlerini al

get_all_client_labels(müşteri_kimliği)

Parametreler:

müşteri_kimliği - isteğe bağlı; sağlanmazsa, mevcut müşterinin etiketleri alınır.

İşlev, JSON formatında bir yanıt döndürür: {"161":"tag1","228":"tag2"}, burada: anahtar etiket kimliği, değer ise etiket adıdır

Müşteri etiketlerini dizi ile sil

remove_multiple_client_labels(etiketler_dizisi, adlar) - dizide belirtilen etiketleri siler

etiketler_dizisi - etiketler dizisi. VEYA ID dizisi****,**** VEYA adlar dizisi.

Adlar dizisi iletilirse, o zaman**❗ikinci parametrenin (adlar) 1 olarak ayarlanması zorunludur.**

adlar - Dizi, kimlikler yerine etiket adlarını içeriyorsa 1 olarak ayarlayın. Bu, dizinin adlardan oluştuğunu belirtir.

Aynı işlevde hem etiket kimliklerini hem de etiket adlarını birleştirmeye İZİN VERİLMEZ!

/*Etiketleri kimlikle sil*/

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

/*Etiketleri etiket adıyla sil*/

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

Değişken, işlev yürütmesinin sonucunu saklar: bir hata mesajı veya kaç etiketin silindiğini gösteren bir sayı.

Birden çok etikete göre müşteri bul

find_clients_by_multiple_labels(etiketler_dizisi, adlar) - birden çok etikete göre müşteri bulur

ÖNEMLİ! Bu, yalnızca belirtilen TÜM etiketlere sahip olan müşterileri bulur.

Parametreler:

etiketler_dizisi - etiketler dizisi. VEYA ID dizisi****,**** VEYA adlar dizisi.

Adlar dizisi iletilirse, o zaman**❗ikinci parametrenin (adlar) 1 olarak ayarlanması zorunludur.**

adlar - Dizi, kimlikler yerine etiket adlarını içeriyorsa 1 olarak ayarlayın. Bu, dizinin adlardan oluştuğunu belirtir.

Aynı işlevde hem etiket kimliklerini hem de etiket adlarını birleştirmeye İZİN VERİLMEZ!

Müşteri kimliklerinden (müşteri_kimliği) oluşan bir dizi döndürür: [41121, 41192, 41522]

/*Belirtilen tüm etiketlere sahip müşterileri kimlikle bul*/

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

/*Belirtilen tüm etiketlere sahip müşterileri etiket adlarıyla bul*/

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

Müşteri etiketleri dizisini kontrol et

has_client_multiple_labels(etiketler_dizisi, adlar) - müşteri etiketleri dizisini kontrol eder

ÖNEMLİ! Bir müşteri belirtilen tüm etiketlere sahipse True döndürür!

Parametreler:

etiketler_dizisi - etiketler dizisi. VEYA ID dizisi****,**** VEYA adlar dizisi.

Adlar dizisi iletilirse, o zaman**❗ikinci parametrenin (adlar) 1 olarak ayarlanması zorunludur.**

adlar - Dizi, kimlikler yerine etiket adlarını içeriyorsa 1 olarak ayarlayın. Bu, dizinin adlardan oluştuğunu belirtir.

Aynı işlevde hem etiket kimliklerini hem de etiket adlarını birleştirmeye İZİN VERİLMEZ!

Ya bir hata ya da müşteri dizideki tüm etiketlere sahipse True ya da müşteri tüm etiketlere sahip değilse False döndürür.

/*Müşterinin belirtilen tüm etiketlere sahip olup olmadığını kimlikle kontrol et*/

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

/*Müşterinin belirtilen tüm etiketlere sahip olup olmadığını etiket adlarıyla kontrol et*/

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

Tüm müşteri etiket kimliklerini al

get_all_client_label_ids(müşteri_kimliği) — müşteriye atanmış tüm etiketlerin kimliklerini içeren bir dizi döndürür.

Müşterinin etiketi yoksa, işlev boş bir dizi döndürür: [].

Parametreler:

müşteri_kimliği — Mavibot müşteri kimliği. Belirtilmezse, mevcut müşterinin kimliği kullanılır.