MaviBot etiketleriyle çalışma
Etiket oluştur / kaldır
create_label() | add_label() | remove_label() | remove_label_everywhere() | count_of_clients_with_label() | has_label()
Açıklama
MaviBot etiketleri bir müşteri profilinde şu şekilde görüntülenir:

ve "Lists" bölümünde bulmanız gerekir:

create_label(label_name) belirtilen adla MaviBot etiketi oluşturur
Parametreler: ! label_name- tek tırnak içinde belirtilen etiket adı ('').
add_label(label_name, client_id) müşteriye MaviBot etiketi ekle
Parametreler: ! label_name - tek tırnak içinde belirtilen etiket adı ('') client_id müşteri ID’si. Belirtilmezse, geçerli müşteri ID’si kullanılır
remove_label(label_name, client_id) etiketi müşteriden kaldır
Parametreler: ! label_name - tek tırnak içinde belirtilen etiket adı ('') client_id - müşteri ID’si. Belirtilmezse, geçerli müşteri ID’si kullanılır
has_label(label_name, client_id) - müşterinin etiketi olup olmadığını kontrol et
Parametreler: ! label_name - tek tırnak içinde belirtilen etiket adı ('') client_id - müşteri ID’si. Belirtilmezse, geçerli müşteri ID’si kullanılır
remove_label_everywhere(label_name) etiketi tüm müşterilerden kaldır
Parametreler: ! label_name- tek tırnak içinde belirtilen etiket adı ('')
count_of_clients_with_label(label_name) etikete sahip toplam müşteri sayısını al
Parametreler: ! label_name- tek tırnak içinde belirtilen etiket adı ('')
Örnek
Öyleyse, bakalım MaviBot etiketi nasıl oluşturulur.
Gri blokta (durumsuz bir blok) oluşturma fonksiyonunu bir kez çalıştırmanız yeterlidir, örneğin:

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

Sonraki adımda, herhangi bir müşteriye etiket atayabilirsiniz şunu ekleyerek add_label() fonksiyonunu huninizin ilgili bloğuna:



Bir müşterinin etikete sahip olup olmadığını has_label() fonksiyonunu kullanarak kontrol edebilirsiniz:

Fonksiyon mantıksal bir değer döndürür: True veya False.

Etiketle ilgili diğer işlemler de benzer şekilde yapılır— belirli bir müşteriden etiketi kaldırmak veya etiketi tüm müşterilerden tamamen kaldırmak.
Ayrıca şu fonksiyonu kullanarak belirli bir etikete sahip müşteri sayısını da sayabilirsiniz: count_of_clients_with_label() işlevini kullanın.

Kopyalama için kod örneği
/Etiket oluştur/ a=create_label('tag1')
/Müşteriye etiket ata/ a=add_label('stage 1')
/Müşterinin etikete sahip olup olmadığını kontrol et/ a=has_label('этап 1','73704021')
/Belirli etikete sahip müşteri sayısını say/ etap1=count_of_clients_with_label('stage 1') tovar1=count_of_clients_with_label('1')
Etiket oluşturma
Açıklama
create_label(label_name) - belirtilen adla MaviBot etiketi oluşturur
Parametreler:
! label_name- tek tırnak içinde belirtilen etiket adı ('')
Çift kayda izin vermeden etiket oluşturma
Açıklama
create_label_if_not_exist(name, color) - aynı ada sahip bir etiket henüz yoksa yeni bir etiket oluşturur ve kimliğini döndürür; aksi halde mevcut etiketin kimliğini döndürür
name — etiket adı
color — etiket rengi (varsayılan: 0)
İçin renk tablosu color parametresi:
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
Açıklama
get_all_client_labels(client_id)
Parametreler:
client_id - isteğe bağlı; belirtilmezse, mevcut müşterinin etiketleri alınır.
Fonksiyon JSON formatında bir yanıt döndürür: {"161":"tag1","228":"tag2"}, burada: anahtar etiket ID’sidir ve değer etiket adıdır
Müşteri etiketlerini dizi ile sil
Açıklama
remove_multiple_client_labels(labels_array, names) - dizide belirtilen etiketleri siler
labels_array - etiket dizisi. VEYA ID dizi, VEYA names dizi.
names dizisi geçirilirse, o zaman❗ikinci parametre (names) 1 olarak geçirilmek zorunludur.
names - Dizi etiket ID’leri yerine etiket adları içeriyorsa 1 olarak ayarlanır. Bu, dizinin adlardan oluştuğunu gösterir.
Aynı fonksiyonda hem etiket ID’lerini hem de etiket adlarını birlikte kullanmaya izin verilmez!
Örnek
/*Etiketleri ID ile 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, fonksiyon çalıştırma sonucunu saklar: ya bir hata mesajı ya da kaç etiketin silindiğini belirten bir sayı.

Müşterileri birden çok etikete göre bul
Açıklama
find_clients_by_multiple_labels(labels_array, names) - müşterileri birden çok etikete göre bulur
ÖNEMLİ! Bu yalnızca belirtilen TÜM etiketlere sahip müşterileri bulur.
Parametreler:
labels_array - etiket dizisi. VEYA ID dizi, VEYA names dizi.
names dizisi geçirilirse, o zaman❗ikinci parametre (names) 1 olarak geçirilmek zorunludur.
names - Dizi etiket ID’leri yerine etiket adları içeriyorsa 1 olarak ayarlanır. Bu, dizinin adlardan oluştuğunu gösterir.
Aynı fonksiyonda hem etiket ID’lerini hem de etiket adlarını birlikte kullanmaya izin verilmez!
Müşteri ID’lerinden (client_id) oluşan bir dizi döndürür: [41121, 41192, 41522]
Örnek
/*Belirtilen tüm etiketlere ID ile sahip müşterileri bul*/
r = find_clients_by_multiple_labels('[138,169,166]')
/*Belirtilen tüm etiketlere etiket adlarıyla sahip müşterileri bul*/
r2 = find_clients_by_multiple_labels('["newTestTag","tag2"]', 1)

Müşteri etiketleri dizisini kontrol et
Açıklama
has_client_multiple_labels(labels_array, names) - müşteri etiketleri dizisini kontrol eder
ÖNEMLİ! Döndürür True eğer bir müşteri belirtilen tüm etiketlere sahipse!
Parametreler:
labels_array - etiket dizisi. VEYA ID dizi, VEYA names dizi.
names dizisi geçirilirse, o zaman❗ikinci parametre (names) 1 olarak geçirilmek zorunludur.
names - Dizi etiket ID’leri yerine etiket adları içeriyorsa 1 olarak ayarlanır. Bu, dizinin adlardan oluştuğunu gösterir.
Aynı fonksiyonda hem etiket ID’lerini hem de etiket adlarını birlikte kullanmaya izin verilmez!
Şunlardan birini döndürür bir hataya da True eğer müşterinin dizideki tüm etiketleri varsa veya False eğer müşterinin tüm etiketleri yoksa.
Son güncelleme

