Hesap makinesindeki işlevler (API)
API işlevleri yalnızca "Business" ve "MaviBot AI" planlarında kullanılabilir.
API MaviBot
LEJAND: ! -Gerekli parametreler
Geri çağrının nasıl gönderileceği
callback()
Geri çağrı yalnızca BAŞKA bir istemciye gönderilebilir.
Geri çağrıyı KENDİNİZE gönderemezsiniz!
Açıklama
callback(client_id, callback_message)
Parametreler:
! client_id - istemci tanımlayıcısı
! callback_message - geri çağrı mesajı metni
Örnek
Geri çağrı, botun belirli bir işlemi tetiklemek için bir komut olarak tanıdığı özel bir sistem mesajıdır. Bu mesaj kullanıcıya görünmez ve yalnızca dahili işlem için istemcinin profilinde kaydedilir.
client_id=73704021 olan istemciye geri çağrı gönderelim
Sonra, bu geri çağrıya verilen yanıtı koşullu blokta ayarlıyoruz.
Kopyalanacak kod örneği
callback('73704021', 'callback TEST123')
callback(client_id, 'callback TEST123')Telegram'da geri çağrı nasıl gönderilir
tg_callback()
Açıklama
tg_callback(platform_id , callback_message,group_id, business_connection_id)
Parametreler:
! platform_id - Telegram istemci tanımlayıcısı
! callback_message - geri çağrı mesajı metni
group_id - Telegram bot tanımlayıcısı
tg_business - işletme müşterileriyle çalışmak için "1" değeri geçirilir.
Bir geri çağrı düğmesine yanıt olarak etiketli bir bot yönlendirmesi nasıl eklenir?
Açıklama
tg_callback_url_open(callback_query_id, url)
Parametreler: ! callback_query_id - bu kimlik, düğmeye basan kişiyi tanımlamanıza ve ona Alert -bildirimini göstermenize olanak tanır, ! url - URL- botu ve parametreyi belirten (şöyle görünür: t.me/your_bot?start=XXXX, your_bot yerine - bot adı)
İstemciye mesaj nasıl gönderilir
message() | platform_message() | whatsapp_message()
Satır sonları içeren metni bir değişkende saklamak için, değeri şu şekilde ayarlayın:
text = "Birinci satır metni" + "\n" + "İkinci satır metni" + "\n" +"Üçüncü satır metni"
Açıklama
message(client_id, text, message_id, timeout)
Parametreler: ! client_id - istemci tanımlayıcısı ! text - mesaj metni message_id - blok kimliği. Metin alanını boş bırakırsanız (") ve bu parametreyi doldurursanız, belirtilen bloktaki metin istemciye gönderilecektir.
Not: message işlevine message_id parametresini geçirirseniz, blok yine de tamamen yürütülür ve client_id parametresinde belirtilen istemci, message_id içinde geçtiğiniz bloğa taşınır.
timeout - mesaj gecikmesi veya planlanan gönderim zamanı. Mesaj gönderimini geciktirmek için timeout parametresini kullanabilirsiniz: a) Saniye cinsinden gecikme (3600 saniyeye kadar). Değer 3600'ü aşarsa, mesaj bir saat içinde gönderilir. Değer negatifse, mesaj hemen gönderilir. Örnek: timeout = 50
b) dd.mm.yyyy hh:mm biçiminde belirli bir tarih ve saat, örnek: timeout = '03.04.2022 15:00' . Geçmiş bir tarih belirtilirse, mesaj hemen gönderilir.
platform_message(platform_id, text, client_type, message_id, timeout,group_id)
Parametreler: ! platform_id - mesajlaşma uygulamasındaki istemci tanımlayıcısı ! text - mesaj metni client_type - mesajlaşma uygulaması türü, isteğe bağlı parametre. Belirtilmezse, istemci botun mesajı gönderdiği aynı mesajlaşma uygulamasında aranır. Belirtilirse, istemci belirtilen mesajlaşma uygulamasının veritabanı arasında bulunur. Mesajlaşma uygulaması türlerini bulabilirsiniz burada. message_id - blok kimliği. Belirtilirse, istemci metin parametresindeki değeri değil, belirtilen bloktaki mesajı alır. timeout - gönderim zamanı veya gecikme. Aynı adlı message() işlevinin parametresine benzer. group_id - bot tanımlayıcısı
whatsapp_message(phone, text, message_id)
Parametreler: ! phone- Whatsapp'ın kayıtlı olduğu müşterinin telefon numarası ! text - mesaj metni message_id - blok kimliğidir. Metin alanı boş ('') bırakılır ve bu parametre ayarlanırsa, istemci belirtilen bloktaki mesaj içeriğini alır.
Whatsapp botunun projeye bağlanması gerekir.
Örnek
client_id ile mesaj göndermenin basit bir örneği:
client_id ile mesaj göndermek için farklı seçenekler:
platform_message() üzerinden mesaj gönderme örneği:
platform_id değeri ile client_id alma
get_client_id_by_platform_id()
Açıklama
get_client_id_by_platform_id(client_type, platform_id , group)
Fonksiyon çalıştırıldıktan sonra, belirtilen koşullara uyan bir istemci bulunursa client_id döndürülür; aksi halde None döndürülür.
! client_type - mesajlaşma uygulaması. client_type değeri için şuraya bakın bu makale.
! platform_id - belirtilen mesajlaşma uygulamasındaki istemci kimliği.
group - birden fazla mesajlaşma botu bağlıysa gerekli bir parametredir.
Projeye aynı türden birden fazla mesajlaşma uygulaması bağlanmışsa, arama bu türün bağlı tüm mesajlaşma uygulamaları üzerinden yapılır.
Bu durumda, group parametresini geçirmenizi öneririz.
get istekleri için işlevler: requests_get(url, answer_type, headers, params, auth, proxy)
Açıklama
! url - isteğin yapıldığı bağlantı
answer_type – sunucu yanıtından neyin döndürülmesi gerektiğini belirleyen isteğe bağlı parametre: ('status' – yanıt durum kodunu döndürür; 'json' – yanıtın json gövdesini döndürür; 'text' – yanıtın ham metnini döndürür; diğer herhangi bir değer (varsayılan dahil) yanıtı şu formatta döndürür: '{"status": status_code, "data": data}')
headers - istek başlıklarını geçirmek için isteğe bağlı parametre,
params - is get istek parametreleri (doğrudan URL'ye de eklenebilir),
auth - API kimlik doğrulaması için yararlı isteğe bağlı parametre. Herhangi bir isteğe bağlı parametre kullanmak istemiyorsanız ancak bir sonrakine ihtiyaç duyuyorsanız, buraya 0 girin.
proxy - isteğe bağlı parametre; tek bir değer kabul eder: "de", isteği Avrupa IP adresi üzerinden yönlendirir.
post istekleri için işlevler
Açıklama
requests_post(url, answer_type, headers, data, json_data, auth, proxy)
! url - isteğin yapıldığı bağlantı,
answer_type - sunucu yanıtından neyin döndürülmesi gerektiğini belirleyen isteğe bağlı parametre: ('status' – yanıt durum kodunu döndürür; 'json' – yanıtın json gövdesini döndürür; 'text' – yanıtın ham metnini döndürür; diğer herhangi bir değer (varsayılan dahil) yanıtı şu formatta döndürür: '{"status": status_code, "data": data}')
headers - istek başlıklarını geçirmek için isteğe bağlı parametre
data - isteğe bağlı parametre; API json ile çalışmadığında istek gövdesini temsil eder.
json_data - isteğe bağlı parametre; ayrıca istek gövdesini temsil eder. Bu parametrelerden yalnızca birini aynı anda kullanmalısınız.
Lütfen dikkat: belirli başlık yapılandırmaları, isteğin belirli bir gövde türüyle gönderilmesini engelleyebilir.
auth - API kimlik doğrulaması için yararlı isteğe bağlı parametre. Herhangi bir isteğe bağlı parametre kullanmak istemiyorsanız ancak bir sonrakine ihtiyaç duyuyorsanız, buraya 0 girin
proxy - isteğe bağlı parametre; tek bir değer kabul eder: "de", isteği Avrupa IP adresi üzerinden yönlendirir.
put istekleri için işlevler
Açıklama
requests_put(url, answer_type, headers, data, auth, proxy)
! url - isteğin yapıldığı bağlantı
answer_type - sunucu yanıtından neyin döndürülmesi gerektiğini belirleyen isteğe bağlı parametre: ('status' – yanıt durum kodunu döndürür; 'json' – yanıtın json gövdesini döndürür; 'text' – yanıtın ham metnini döndürür; diğer herhangi bir değer (varsayılan dahil) yanıtı şu formatta döndürür: '{"status": status_code, "data": data}')
headers - istek başlıklarını geçirmek için isteğe bağlı parametre
data - isteğe bağlı parametre; API json ile çalışmadığında istek gövdesini temsil eder.
auth - API kimlik doğrulaması için yararlı isteğe bağlı parametre. Herhangi bir isteğe bağlı parametre kullanmak istemiyorsanız ancak bir sonrakine ihtiyaç duyuyorsanız, buraya 0 girin
proxy - isteğe bağlı parametre; tek bir değer kabul eder: "de", isteği Avrupa IP adresi üzerinden yönlendirir.
data_is_json isteğe bağlı bir parametredir.
Ayarlanırsa, geçirilen veri data JSON formatında gönderilecektir.
Etkinleştirmek için şunu geçin '1'.
patch istekleri için işlevler
requests_patch(url, answer_type, headers, data, auth, proxy)
Açıklama
! url - isteğin yapıldığı bağlantı
answer_type - sunucu yanıtından neyin döndürülmesi gerektiğini belirleyen isteğe bağlı parametre: ('status' – yanıt durum kodunu döndürür; 'json' – yanıtın json gövdesini döndürür; 'text' – yanıtın ham metnini döndürür; diğer herhangi bir değer (varsayılan dahil) yanıtı şu formatta döndürür: '{"status": status_code, "data": data}')
headers - istek başlıklarını geçirmek için isteğe bağlı parametre
data - isteğe bağlı parametre; API json ile çalışmadığında istek gövdesini temsil eder.
auth - API kimlik doğrulaması için yararlı isteğe bağlı parametre. Herhangi bir isteğe bağlı parametre kullanmak istemiyorsanız ancak bir sonrakine ihtiyaç duyuyorsanız, buraya 0 girin
proxy - isteğe bağlı parametre; tek bir değer kabul eder: "de", isteği Avrupa IP adresi üzerinden yönlendirir.
delete istekleri için işlevler
requests_delete(url, answer_type, headers, data, json_data, auth, proxy)
Açıklama
! url - isteğin yapıldığı bağlantı
answer_type - sunucu yanıtından neyin döndürülmesi gerektiğini belirleyen isteğe bağlı parametre: ('status' – yanıt durum kodunu döndürür; 'json' – yanıtın json gövdesini döndürür; 'text' – yanıtın ham metnini döndürür; diğer herhangi bir değer (varsayılan dahil) yanıtı şu formatta döndürür: '{"status": status_code, "data": data}')
headers - istek başlıklarını geçirmek için isteğe bağlı parametre
data - API json ile çalışmadığında istek gövdesini temsil eden isteğe bağlı parametre.
json_data - isteğe bağlıdır ve istek gövdesi olarak da kullanılabilir. Ancak, aynı anda yalnızca bir seçenek kullanılmalıdır
auth - API kimlik doğrulaması için yararlı isteğe bağlı parametre. Herhangi bir isteğe bağlı parametre kullanmak istemiyorsanız ancak bir sonrakine ihtiyaç duyuyorsanız, buraya 0 girin
proxy - isteğe bağlı parametre; tek bir değer kabul eder: "de", isteği Avrupa IP adresi üzerinden yönlendirir.
Kimliğine göre blok adını alma işlevi
Son güncelleme