Değişkenler

Değişkenler nasıl kullanılır

Değişkenlerin ne olduğunu ve MaviBot'ta chatbotlar oluştururken bunları etkili bir şekilde nasıl kullanacağımızı inceleyelim.

Lütfen tek bir projede değişkenler ve sabitler için aşağıdaki sistem sınırlarına dikkat edin:

Şablon Değişkenleri:

• Maksimum miktar: 100 değişken

• Maksimum ad uzunluğu: 100 karakter

Proje sabitleri:

• Maksimum miktar: 50 sabit

• Maksimum ad uzunluğu: 100 karakter

• Maksimum değer uzunluğu: 5.000 karakter

Değişken, benzersiz bir metin etiketiyle tanımlanan, veri için adlandırılmış bir depolama alanıdır.

Şekil 1: Adlı bir değişken total, bir ödeme tutarını saklıyor.

MaviBot çeşitli değişken türleri sağlar:

1. Yerleşik değişkenler

2. Sistem değişkenleri

3. Kullanıcı tanımlı değişkenler — bunlar proje içinde kendiniz oluşturduğunuz değişkenlerdir.

Bir değişken tanımlamak adı verilen bir kapsayıcıya bir değer atamak anlamına gelir. Başka bir deyişle, şu gibi bir ifade: a=0 değişkeninin tanımıdır a. Builder'a, değişkeninde bir sayı saklayacağımızı yeni söyledik (tanımladık) a, ve şimdilik bu değer 0.

Bir değişkene değer atamak aynı anlama gelir.

İfadeler "bir değişkene bir fonksiyonun değerini atamak" veya "bir değişkeni bir fonksiyona eşit olarak ayarlamak" de yaygın olarak kullanılır. Prensip aynıdır: belirli bir değer atamak yerine, bir fonksiyonun sonucunu atarsınız. Örneğin: s_id = tg_send_message(platform_id, "Merhaba!") Bu durumda, fonksiyonun sonucu değişkende saklanacaktır.

Bir değişkeni sıfırlamak ona şu değeri atamak anlamına gelir 0.

Fonksiyonlar ve metodlar MaviBot tarafından önceden yapılandırılmış komut kümeleridir. Çoğu fonksiyon parametreler gerektirir - fonksiyonun veya metodun anlayabildiği değerler. Bot gerekli parametreleri aldığında belirli bir komutu yürütür.

tg_send_message(platform_id, "Merhaba!") — bu fonksiyon Telegram'da "Merhaba!" mesajını gönderir.

Şek. 2. text1 adlı ve bir fonksiyona atanmış değişken örneği.

DEĞİŞKENLERLE ÇALIŞMA KURALLARI:

1. Bir değişken adı yalnızca bir harfile başlayabilir; bir sayı ile başlayamaz.

   Age1 - ✅ doğru

   1Age - ❌ yanlış

   age1 - ✅ doğru - önerilen seçenek

2. Bir değişken, alt çizgi (_) dışında boşluk veya özel karakter içeremez.

   Name_Surname - ✅ doğru

   Name Surname - ❌ yanlış

   nameSurname - ✅ doğru - önerilen seçenek

   Programlama dillerindeki ayrılmış kelimeler değişken adı olarak kullanılamaz; örneğin: print, true, false, count, sum vb.

3. Bu kesinlikle yasaktır kullanmak yerleşik ve sistem değişkenlerinin adlarını kullanıcı tanımlı değişkenler için kullanmak. Bu tür değişkenlerin listesini burada bulabilirsiniz. bağlantı

4. Şunu öneriyoruz:

   • Değişkenler için Latin (İngilizce) adlar kullanın.

   • Kısa ama anlamlı değişken adları kullanın, örneğin: totalSum, pay_name, ns, name_client vb.

Bir değişkenin değeri nasıl alınır

Değişken adını süslü parantezlerin içine yerleştirin #{}. Mesaj metni alanında değerine bu şekilde başvurabilirsiniz. Ancak "Hesaplayıcı" alanında, değişkenin değerine ek bir sözdizimi olmadan, yalnızca adıyla başvurmalısınız.

Düğmenin #{} yapısı, bir değişkenin değerini almanızı sağlar. Bu yapı, değişkenin değerini metne eklemek için "Mesaj metni" alanında kullanılır.

Örnek:

Sistem, bir değişkenin değerinin başka bir değişkenin adının parçası olduğu iç içe değişkenleri destekler. Örneğin: #{q#{test#{i}}}

"Hesaplayıcı" alanında, değişkenlere #{} gösterimini kullanmadan adlarıyla başvurun.\r Örneğin, elimizde iki değişken varsa: price (toplam) ve quantity (adet).

num = 10

sum = 1500

Toplam tutar nasıl gösterilir

Hesaplayıcıya şunu girin:

total_sum = sum1 * num2 ✅ doğru

Nasıl yapılmaz denir:

total_sum = #{sum1} * #{num2} - ❌ yanlış

Bir değişken bot'tan nasıl silinir

Bir değişkeni silmek (temizlemek) için, "Hesaplayıcı" alanına aşağıdakilerden birini girin:\r\nYourVariableName =\r\nveya\r\nYourVariableName = ""

Eşittir işaretinden sonra ya bir boşluk bırakın ya da çift (veya tek) tırnak işareti kullanın.

Lütfen dikkat edin! Değişkenin hangi alana ait olduğunu belirtmek için doğru öneki kullanmak önemlidir.

Proje düzeyindeki değişkenler için (proje ayarlarında saklananlar), şu öneki kullanın project: Örnek: project.YourVariableName = veya project.YourVariableName = ""

İstemci düzeyindeki değişkenler için şu öneki kullanın client:\r\nÖrnek: client.YourVariableName = veya client.YourVariableName = ""

İşlem düzeyindeki değişkenler için önek gerekmez.

Yerleşik değişkenler

Yerleşik değişkenlerin listesi:

#{none} - mesajı yoksay

#{api_key} - Salebot API çağrılarında kullanılan API belirteci

#{attachment_url} - ekin bağlantısını içerir

#{attachments} - kullanıcının mesajındaki ek URL'lerinin JSON dizisi

#{avatar} - kullanıcının avatarına bağlantı ("Müşteriler" bölümünde gösterilir)

#{client_id} - oluşturucudaki istemci ID'si, API isteklerinde de kullanılır

#{client_type} - istemcinin geldiği mesajlaşma uygulaması türü (değerler [burada] açıklanmıştır)

#{current_date} - projenin saat dilimine göre dd.mm.yyyy biçiminde geçerli tarih

#{current_time} - projenin saat dilimine göre hh:mm biçiminde geçerli saat

#{custom_answer} - "Sunucu yanıt URL'si" alanında belirtilen sunucudan alınan yanıt

#{message_from_outside} - gelen mesaj türü. Olası değerler: normal mesaj = 0\nAPI üzerinden gönderilen mesaj = 1\ncallback bildirimi (diyalogda sarı arka plan) = 3\ntelefon bildirimi (diyalogda açık mavi arka plan) = 5 \nBu değişken her gelen mesajla birlikte oluşturulur, ancak müşteri kartında görünmez.\r\nBlok tetikleyicileri ve bağlantıları için koşullar kurmak üzere bunu "Karşılaştırma değişkeni" alanında kullanabilirsiniz.

#{date_of_creation} - kullanıcının bot'a eklendiği veya ilk kez mesaj gönderdiği tarih

#{full_name} - kullanıcının tam adı (ad ve soyad)

#{group} - istemcinin bağlı olduğu bot (müşteri kartında "Bot'a bağlı" olarak gösterilir)

#{main_client_id} - bağlı müşteri kartları grubundaki ana müşterinin ID'si

#{message_id} - müşteriyle mevcut konuşma durumunun ID'si (varsayılan: NONE)

#{messenger} - kullanıcının geldiği mesajlaşma uygulamasının adı

#{name} - kullanıcının adı

#{next_day} - yarının tarihi dd.mm.yyyy formatında (mesaj planlama için kullanışlıdır)

#{order_id} - sipariş kimliği (müşteri ID'si ve dahili sipariş ID'si kısa çizgi ile ayrılmış)

#{order} - kullanıcı tarafından gönderilen siparişin içeriği

#{platform_id} - mesajlaşma platformundaki müşteri ID'si

#{question} - kullanıcı tarafından gönderilen mesaj

#{timestamp} - milisaniyeler dahil geçerli zaman damgası

#{time_of_creation} - kullanıcının bot'a eklendiği veya ilk kez mesaj gönderdiği zaman

#{wa_bot} - kullanıcının mesaj gönderdiği WhatsApp numarası (CRM alanlarına aktarmak ve potansiyel müşterileri yöneticiler arasında dağıtmak için kullanışlıdır)

#{weekday} - haftanın günü sayı olarak (Pazartesi = 1, Salı = 2 vb.)

client_type değerleri

Değer	Mesajlaşma uygulaması
1	Telegram için
2	Viber için
3	Facebook için
5	çevrimiçi sohbet için
10	Instagram için
14	e-posta
16	Telegram Business Hesabı
21	Telegram hesabı
22	TikTok

Sistem değişkenleri

Sistem, bir botun çalışması sırasında çeşitli çalışma zamanı değişkenleri otomatik olarak oluşturur. Botunuzu oluştururken bu değişkenleri kullanabilirsiniz. İşinize yarayabilecek olanların listesi aşağıdadır.

Ek sistem değişkenlerini belgelerde bulabilirsiniz. Bunlar, kullanım alanlarıyla ilgili bölümlerde yer alır.

phone - telefon numarası

notSubscribed - değişken 1'e eşitse, müşteri mesaj aboneliğinden çıkmıştır ve hiçbir mesaj almayacaktır

clientBlocked - müşteri engellenmiştir ve bot onlar için çalışmaz

story_url - müşterinin yanıt verdiği Instagram hikâyesinin tanımlayıcısı

viewed_page - kullanıcının çevrimiçi sohbette yazdığı sayfa

wa_bot - WhatsApp botunun telefon numarası

Ödeme sırasında hangi değişkenlerin oluşturulabileceğini öğrenmek için, "Ödeme sistemi" bölümündeki ödeme hizmetleri entegrasyon kılavuzlarına bakın.

Özel değişkenler

Özel değişkenler şu şekilde ayrılır:

• Proje değişkenleri (ortak değişkenler olarak da adlandırılır)

• İstemci değişkenleri

• İşlem değişkenleri (düzenli değişkenler olarak da adlandırılır)

• Sabitler

Her değişken türü aşağıda açıklanacaktır.

Builder beklediğinizden farklı bir değer gösterdiğinde veya kullandığında karışıklığı önlemek için farklı değişken türleri için aynı adları kullanmaktan kaçının.

Bir değişkene değer atarken, uygun öneki kullanarak türünü belirtmek önemlidir:

client. (istemci değişkenleri için) ve project. (proje değişkenleri için). İşlem değişkenleri için önek kullanılmaz.

Bir değişkenin değeri alınırken önek kullanılmaz.

Örnek:\r Şimdi, müşterilerinizden gelen beğeniler için sayaç görevi görecek like adlı bir proje değişkeni oluşturmak istediğinizi varsayalım.

project.like = 0 - tanım, bir kez yapılır

Beğenileri saymanız gereken blokta şunu yazın: project.like = like + 1

Değişken öncelik sırası:\r işlem değişkenleri en yüksek önceliğe sahiptir, ardından istemci değişkenleri ve sonra proje değişkenleri gelir.

Messenger ID (platform_id)

Messenger ID (platform_id) - mesajlaşma uygulamasındaki kullanıcı/sohbet/kanal tanımlayıcısıdır. Bunu bulmak için, "Müşteriler" bölümünde istediğiniz müşteriyle olan görüşmeyi açın. Sohbet penceresinin sağ tarafında, "Müşteri hakkında - Sistem değişkenleri" sekmesine veya "Tümü" sekmesine gidin.

Düğmenin platform_id - kullanıcının benzersiz mesajlaşma uygulaması ID'sini temsil eden, kalıcı ve sistem tarafından oluşturulan bir değişkendir.

• Kalıcılık: Bu ID bir kullanıcı için sabit kalır. Kayıtlarını builder'dan silseniz bile, platform_id yeniden kayıt sırasında aynı olacaktır.

• Kaynak: ID, kullanıcı bot ile ilk etkileşime girdiğinde mesajlaşma platformu (ör. Telegram, WhatsApp) tarafından atanır.

Aşağıdaki örnek, platform_id ifadesinin müşteri kartında nasıl göründüğünü gösterir.

platform_id değişkeni, topluluklar, kanallar ve sohbetler için olduğu gibi normal kullanıcılar için de mevcuttur.

bunu elde etmek için platform_id Telegram kanalının (botun yönetici olduğu)

(mesajlaşma ID'si) değerini kopyalamak için, kişisel hesabınızdan kanala bir mesaj gönderin. Bu, bot ile kanal arasında otomatik olarak bir diyalog oluşturacaktır. platform_id Kanalın

değerini "Müşteri hakkında" bölümünden kopyalayabilirsiniz.

Değişkenler nasıl kullanılır

Telegram'da kanallar için mesajlaşma ID'si her zaman eksi işareti (-) ile başlar. Fonksiyonları kullanırken, eksi işareti dahil tüm değeri eklediğinizden emin olun.

Değişkenler tetikleyicilerde, siparişlerde, kullanıcı yanıtlarında, bloklarda ve daha fazlasında kullanılabilir. Bir emlak ajansı için bir huni oluştururken somut bir örneğe bakalım.

Öyleyse, bir Başlangıç bloğu oluşturalım:

1. Adım: "Teşekkür" bloğunu oluşturun

Kullanıcının girdisi için teşekkür eden bir mesaj içeren yeni bir blok oluşturun.

2. Adım: Geçişi yapılandırın

1. Bu bloğa giden bağlantı üzerinde aşağıdaki tetikleyiciyi yapılandırın: "Kullanıcı veri girer" anahtarını etkinleştirin.

2. içinde "Girdi verisi" alanına değişken adını girin: name.

Kullanıcının girdisi Name değişkeninde saklanır. Bu değer, değişkeni #{Name} sözdizimiyle çağırarak sonraki herhangi bir blokta yeniden kullanılabilir; örneğin: Hoş geldin, #{Name}!.

Bot şu şekilde çalışacaktır:

Şimdi görevi biraz daha karmaşık hale getirelim.

Aynı blokta, kullanıcıya birincil (yeni) mi yoksa ikincil (ikinci el) konut mu istediğini soracağız:

Sonraki olarak, "Sohbet" bloğundaki "Birincil konut" ve "İkincil konut" düğmelerinden bağlantılar oluşturun.

Şimdi bloklar içinde değişkenleri kullanmanın ikinci yoluna bakalım.

Sağ bloğu seçin ve "Hesaplayıcı" alanına aşağıdaki metni girin: client_interest = Birincil konut. Sol blokta şunu girin: client_interest = İkincil konut.

Kullanıcı bu bloklardan herhangi birine geçtiğinde ona bir değişken atanır. Bunu daha sonra sipariş oluştururken kullanabiliriz.

Sonraki olarak, bu bloklarda müşteriye gayrimenkul satın alma bütçesini soracağız ve müşterinin yanıt tetikleyicilerine göre bunlara yönlendiren iki blok daha oluşturacağız.

Bloğundan "Bütçeniz nedir?"bir bağlantı oluşturun ve kullanıcıları girdilerine göre segmente etmek için bir tetikleyici koşulu ayarlayın.

1. Bağlantı ayarlarında, için onay kutusunu etkinleştirin "Kullanıcı veri girer".

2. Değişken adını atayın (örneğin, budget) müşteri yanıtını saklamak için.

3. içinde "Değişken" alanında, koşul oluşturmak için yerleşik değişkeni kullanın #{question} (kullanıcının son mesajını içerir).

   • Örnek: #{question} <= 1000000

Tüm bağlantılar için "Lead'ler" blokları için "Kullanıcı veri girer" etkinleştirin ve değişkeni tanımlayın.

Ek bir değişkeni doğrudan içinde de tanımlayabilirsiniz "Lead'ler" daha kapsamlı işlem bilgisi sağlamak için blok.

Şimdi son iki bloğun türünü "Lead'ler" olarak değiştirin ve sonuçları görün:

Akışı şimdi çalışırken test edelim:

Oluşturulan işlemi ve müşterinin saklanan verilerini görmek için "Müşteriler" bölümüne gidip ilgili görüşmeyi açabilirsiniz. İşlem değişkenleri orada görünür olacaktır.

Artık değişkenleri en az üç farklı şekilde nasıl kullanacağınızı biliyorsunuz:

1. Kullanıcı giriş verilerine değişken adları atama (ör. “Name”, “Budget”)

2. Bir bloğa geçiş sırasında bir değişken değeri atama (ör. client_interest = Birincil konut)

Değişkenler nasıl görüntülenir

Bir müşterinin değişkenlerini görüntülemek için "Müşteriler" bölümüne gidin ve müşteri kartını açın.

Değişkenler müşteri kartında liste biçiminde gösterilir:

• Her değişken kendi satırını kaplar.

• Düğmenin değişken adı solda gösterilir.

• Buna karşılık gelen value sağda görüntülenir.

Bir değişkeni değiştirmek için:

Listede satırının üzerine gelin; bir işlem düğmesi görünür. Bu düğmeye tıklayarak şunları yapabilirsiniz:

• Değişkenin adını düzenleyin.

• Değişkenin değerini düzenleyin.

• Değişkeni tamamen silin.

Sistem değişkenleri düzenlenemez!

İstemci değişkenleri nasıl ayarlanır

"Veri toplamanın sonu" bloğu (kırmızı blok) kullanıldığında istemci değişkenleri silinmez, sıfırlanmaz veya kaybolmaz.

Bir istemci değişkeni iki şekilde ayarlanabilir: açık ve örtük.\r\nBir değişkeni açık şekilde tanımlamanın yolu, onu hunideki bloklardan birinin "Hesaplayıcı" alanında ayarlamaktır.

Örnek: client.age = 28 veya client.age = 28:

Örtük yol, okın veri giriş alanında bir değişken ayarlamaktır.

Örnek:

Müşterinin adını istediğimiz bir blok oluşturalım ve aşağıda da bir blok oluşturalım:

Sonraki olarak, bağlantı ayarlarına gidin ve "Kullanıcı veri girer" seçeneğini etkinleştirin.

Kullanın client. değişkeninizi adlandırırken öneki kullanın (örneğin, client.name) kullanıcının girdisini saklamak için. Bu değişkene daha sonra mesajlarda #{client.name}.

Builder'da istemci değişkenleri düzenli değişkenler gibi kullanılır, ancak client önek olmadan.

Proje değişkenleri nasıl ayarlanır

Genel değişkenler, "Lead'ler" bloğu (kırmızı blok) kullanıldığında silinmez, sıfırlanmaz veya kaybolmaz.

Genel değişkenler botun tüm kullanıcıları tarafından erişilebilir. Bot davranışını kontrol etmek veya farklı kullanıcılar arasındaki etkileşimleri kolaylaştırmak için idealdir.

Kullanım senaryosu örneği: Bir kullanıcı, bir pazar yeri kanalında bir öğeyi bir değişken ayarlayarak paylaşabilir (ör., project.latest_listing), ve diğer tüm kullanıcılar bunu görüp yanıt verebilir.

Atama sözdizimi

Bir genel değişken oluşturmak veya güncellemek için project. önekini Hesaplayıcı'da kullanın:

Örnekler:

• project.product_shop = 28

• project.age = 28

Bunlar herhangi bir önek olmadan kullanılabilir.

Verilerin tabloda nasıl görüntülendiğine bakalım.

Şimdi, "Başlangıç" bloğunu test modunda çalıştırın.

Tablodan değişkene yazılan verileri, bot tarafından gönderilen mesajda görebiliriz. Değişkene mesajda #{} sözdizimini kullanarak başvurduğumuz için, içindeki veri bot sohbetinde görüntülendi.

get_records_from_table() fonksiyonuyla nasıl çalışılacağına dair daha fazla ayrıntı "MaviBot tablosu ile yapay zekâ asistanı".

Düğmenin project. önek, fonksiyonun tablo verilerini doğrudan projenin genel değişkenlerine yazmasına izin verdi; bunlara "Değişkenler" bölümünde görünecektir.

bölümünden erişilebilir.

Proje değişkenlerini proje ayarlarında düzenleyebilirsiniz.

Örnek: proje değişkenlerinin kullanımı

Bot'a giren her yeni müşteriye sıralı bir numara atayan bir sistem oluşturun.

1. Uygulama: Şuraya gidin.

2. Proje ayarları Yeni bir proje değişkeni oluşturun (ör.,).

1. project.client_counter 0Başlangıç değerini ayarlayın (ör., "Bot'ta müşteri yok":

Bot'un başlangıç bloğunda şu mantığı ekleyin:

1. Proje değişkeninin değerini 1 artırır.

2. Yeni değeri mevcut kullanıcı için müşteri özelinde bir değişkene atar.

Sayacın aynı müşteri için iki kez artırılamaması için bir kısıtlama ayarlamayı unutmayın.

Sabit değişkenler nasıl ayarlanır

Sabitler, bir projenin yaşam döngüsü boyunca değişmeyen (veya çok nadiren değişen) sabit değerlerdir.

Genel değişkenlerden temel fark:

Genel değişkenlerin aksine, sabitler müşteriye özeldir. Bir sabitin değeri değiştirilirse, değişiklik yalnızca o müşterinin oturumuna uygulanır.

Yaygın kullanım alanları:

Sabitler, aşağıdaki gibi statik verileri saklamak için idealdir:

• Ürün fiyatları ve müşteri indirimleri

• Entegrasyon belirteçleri ve API anahtarları

• Satıcı veya destek iletişim bilgileri

• Diğer tüm sabit yapılandırma değerleri

Örnek: sabit değişkenlerin kullanımı

Örneğin, bir müşterinin indirimi varsayılan olarak %10 olabilir, ancak bir promosyon kodu girildiğinde %25'e değişebilir.

"Proje ayarları" → "Sabitler" bölümüne şunu girin: Discount : 10

Bir promosyon kodu girmek için, değişkeni atadığımız bir "Tetikleyici" bloğu ekleyin discount 25 değerini.

İndirim tutarını gösteren değişkeni yeşil blokta görüntüleyin:

1. Adım: Otomatik geçişi yapılandırın ile bir bağlantı oluşturun sıfır saniyelik zamanlayıcı gri bloktan. Bu, indirimin hemen uygulanmasını ve müşterinin başlangıç bloğundaki mesaja devam etmesini sağlar.

2. Adım: Akışı test edin Şimdi, tüm diziyi tetiklemek ve test etmek için bot'a bir mesaj yazın.

Promosyon kodu olmadan standart indirim %10'dur. Ancak geçerli bir promosyon kodu girmek durumu değiştirir.

Böylece, promosyon kodunu girdikten sonra, bu müşteri için "discount" değişkeni 25 oldu.

Bunun nedeni, discount = 25 gibi bir atamanın aynı adlı sabitin değerini değiştirmek yerine işlem değişkeninin değerini ayarlamasıdır.

Önemli işlem değişkenleri

name - işlem adı. Terim Name projenin uluslararası sürümü için kullanılır.

description - tişlem açıklaması. Açıklama projenin uluslararası sürümünde kullanılır

budget - işlem tutarı (sayı).

/set_order_vars API isteği kullanarak değişkenleri düzenlemek için, tbu kılavuzdaki adları tam olarak gösterildiği gibikullanmanız gerekir; büyük/küçük harf duyarlılığı ve proje sürümü dahil.

Sınırlar

Maksimum değişken adı uzunluğu: 500 karakter

Maksimum değişken değeri uzunluğu: 100.000 karakter

Müşteri veya işlem başına maksimum değişken sayısı: 1.000 karakter.

Değişkenlerle doğru şekilde nasıl çalışılır

Bir değişkenin değerini ne zaman tırnak içine almalısınız?

Örneğin, client_id = 1202020202 veya client_id = '1202020202'?

Her iki sözdizimi seçeneği de işlevsel olarak doğrudur. Bir değerin etrafına tırnak koymak yalnızca hesaplayıcı düzenleyicisindeki görsel vurgulanmasını etkiler.

Ancak, tutarlı kodlama kurallarına uymak okunabilirliği ve bakımı iyileştirir:

• Tırnakları kaldırın şunlar için sayısal değerler (ör., discount = 25).

• Tırnak kullanın şunlar için string değerler (ör., status = "active").

Client ID, Site ID, Block ID veya Certificate ID gibi tanımlayıcıları fonksiyonlara aktarırken doğru sözdizimi nedir—tırnak içine alınmalı mı?

Bir ID, bir metoda veya fonksiyona aktarılırken tırnak içine alınmamalıdır:

Hangisi kullanılmalı: çift tırnak mı tek tırnak mı?

Tek veya çift tırnak kullanımı arasında bir fark yoktur, ancak çift tırnak kullanmanızı öneririz. Bu şekilde, örneğin bir metin içinde bir değişken eklerken, değişken farklı bir renkle vurgulanır ve fark edilmesi daha kolay olur.

Boşluklar nasıl yerleştirilmelidir?

Değişken ile eşittir işareti arasında bir boşluk varsa aynı şekilde çalışır mı (örneğin, ans="yes", ans = "yes", ans= "yes", ans ="yes"?

Boşluklar, yöntemlerin, değişkenlerin veya işlevlerin çalışmasını etkilemez. Ancak, okunabilirliği artırmak için kodda boşluk kullanılması önerilir.

Hesap makinesinde yorumlar doğru şekilde nasıl yazılır

Hesap Makinesinde yorumların nasıl yazılacağı hakkında daha fazla ayrıntı için lütfen şuraya bakın: bu makale.

Değişkenler nasıl karşılaştırılır

Değişken değerlerini karşılaştırarak sohbet botunun akışını kontrol edebilirsiniz. Bu, yasal uygunluk için kullanıcının yaşını doğrulamak veya kullanıcının mesajlaşma platformuna göre etkileşimleri yönlendirmek gibi koşullu mantık oluşturmanıza olanak tanır.

Huniyi burada nasıl böleceğiniz anlatılıyor farklı mesajlaşma uygulamalarına veya aynı mesajlaşma uygulamasının farklı hesaplarına göre açıklanmıştır.

Desteklenen operatörler:

"+": toplama "-"': çıkarma "*" çarpma "/": bölme "%'": bölme kalanı "^" "**": üs alma "ve" "VE" "&&": mantıksal VE "veya" "VEYA" "||": mantıksal VEYA

Karşılaştırma operatörleri: "==" — eşittir "!=" — eşit değildir ">" — büyüktür "<" — küçüktür ">=" — büyük eşittir "<=" — küçük eşittir

ÖNEMLİ! Şunu kontrol etmek için yerleşik değişken etiketi (bot başlatma etiketi) müşterinin kartında yoksa, aşağıdaki karşılaştırma yöntemini kullanın: tag == "NONE"

Değişkenler, "Variable" alanındaki koşul içinde karşılaştırılmalıdır (hem bağlantı ayarlarında hem de blok ayarlarında):

Bir tetikleyici bloğunun "Variable" alanında değişken karşılaştırma örneği.

Bir blok bağlantısının "Variable" alanında değişken karşılaştırma örneği.

Değişkenler ve tetikleyicilerin birlikte nasıl çalıştığı

Bir bağlantının etkinleşmesi için, her iki tetikleyicinin de karşılanması gerekir:

1. İçindeki koşul "Tetikleyici" alanına yapıştırın.

2. İçindeki karşılaştırma mantığı "Değişken" alanına yapıştırın.

"Variable" alanını anlamak

Yalnızca bir değişken adı girerseniz (örneğin, client_type) "Değişken" alanına bir ifade yazmadan sistem varlığını veya doğruluğunu değişkenin değerinin. O yapılmaz onu kullanıcının ham girdisiyle karşılaştırmaz.

Örnek: Aşağıdaki yapılandırma, müşterinin WhatsApp'tan olup olmadığını denetler; bunun için client_type değişkenin eşit olduğunu doğrular 6 (burada 6 WhatsApp'i temsil eder).

client_type == 6

Aşağıdaki örnek aynı şekilde çalışır:

Lütfen dikkat! "Trigger" alanında değişken karşılaştırması için birden fazla değer belirleyemezsiniz.

Bu yanlıştır!

Birden fazla değişkeni karşılaştırmanız gerekiyorsa, değerlerini "Variable" alanında belirtin.

Bu seçenekler doğrudur.

client_type == 3 değişken değeri eşitse geçiş yap 3 attachments != None değişken herhangi bir değer içeriyorsa geçiş yap attachments == None değişken ayarlı değilse geçiş yap product_quantity >= 100 ürün miktarı bundan büyük ya da eşitse geçiş yap 100 product_quantity <= 100 ürün miktarı bundan küçük ya da eşitse geçiş yap 100 name == "John" değişken adı John'a eşitse geçiş yap

Bir değişkenin boş olup olmadığını kontrol etmek için şu ifadeleri kullanın: "#{value}" == "" "#{value}" != ""

(burada value değişken adıdır).

Karşılaştırma işleminin sonucu bir boolean değer döndürür: True veya False.

Maksimum ifade uzunluğu: 1000 karakter

Farklı türlerdeki değerleri karşılaştırmaya çalışırken varsayılan değer sonuç olarak döndürülür.

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

ÖNEMLİ! Şunu kontrol etmek için yerleşik değişken etiketi (bot başlatma etiketi) müşterinin kartında yoksa, aşağıdaki karşılaştırma yöntemini kullanın: tag == "NONE"

Örnek: Bir kullanıcının yaşını kontrol eden bir bot (yaş).

• Eğer age < 18, reşit olmayanlara bir mesaj gönderir.

• Eğer age >= 18, yetişkinlere bir mesaj gönderir.

Akışın, içinden zamanlanmış bağlantıların çıktığı tetikleyicisi olmayan bir blok içerdiğine dikkat edin.

Bu blok, botun kullanıcı eylemlerine değil, hesaplama sonuçlarına tepki verdiği akışların nasıl oluşturulacağını göstermek için bilerek tasarlanmıştır. İlk adımda yanıt bir değişkende saklanır, ardından karşılaştırma yapılır. Oklar üzerindeki gecikme, anında yanıt için 0 olarak ayarlanmıştır.

Karşılaştırma "Age >= 18" şu şekilde de ifade edilebilir "18'e eşit veya büyük."

Lütfen tetikleyicilerdeki hatalara dikkat edin:

Bir sayı aynı anda 18'den büyük, 18'den küçük ve 18'e eşit olamaz!

Bu tetikleyicilerin hiçbir anlamı yoktur. Her sayı ya 18'den küçüktür, ya 18'den büyüktür ya da 18'e eşittir.

Önemli!

Değişkenli mantıksal tetikleyiciler "Değişken" alanında yazılmalıdır, "Trigger" alanında değil!

Örneğin, aşağıdaki görselde, blok şu durumda tetiklenecektir: phone değişkeni doldurulmuşsa (yani, buna eşit değilse None):

Bir sonraki örnek, operatörlerin nasıl birleştirileceğini gösterir:

Müşterinin değeri 18 ile 99 arasında olan bir age değişkeni varsa, blok tetiklenecektir. Değişken eksikse veya yaş 18'den küçük ya da 99'dan büyükse, blok etkinleşmeyecektir.

Not!

Bir değişkeni tırnak içinde bir değerle karşılaştırıyorsanız, tırnak işaretleri ile değer arasında boşluk olmadığından emin olun; aksi takdirde blok tetiklenmeyebilir veya yanlış davranabilir!

Doğru (tırnak işaretinden önce boşluk yok veya my_new_bot değerinden sonra):

Yanlış (tırnak işaretinden önce boşlukla):