Hesap Makinesindeki Fonksiyonlar (API)

API fonksiyonları yalnızca "Business" ve "MaviBot AI" planlarında kullanılabilir.

API MaviBot

AÇIKLAMA:\ ! -Zorunlu parametreler

Geri arama nasıl gönderilir

callback()

Geri aramayı yalnızca BAŞKA bir müşteriye gönderebilirsiniz.

KENDİNİZE geri arama GÖNDEREMEZSİNİZ!

callback(client_id, callback_message)

Parametreler:

! client_id - müşteri tanımlayıcısı

! callback_message - geri arama mesaj metni

Geri arama, botun belirli bir eylemi tetiklemek için bir komut olarak tanıdığı özel bir sistem mesajıdır. Bu mesaj kullanıcı tarafından görülmez ve yalnızca dahili işleme için müşterinin profili içinde günlüğe kaydedilir.

client_id=73704021 olan müşteriye geri arama gönderelim

Ardından, koşul bloğunda bu geri aramaya yanıtı ayarlıyoruz.

callback('73704021', 'callback TEST123')

callback(client_id, 'callback TEST123')

Telegram'da geri arama nasıl gönderilir

tg_callback()

tg_callback(platform_id , callback_message,group_id, business_connection_id)

Parametreler:

! platform_id - Telegram müşteri tanımlayıcısı

! callback_message - geri arama mesaj metni

group_id - Telegram bot tanımlayıcısı

tg_business - işletme müşterileriyle çalışmak için "1" değeri iletilir.

Bu, zorunlu parametrelerle ilgili bir örnektir:

Bu, isteğe bağlı parametrelerle ilgili bir örnektir:

tg_callback('73704021', 'callback TEST123')

tg_callback(platform_id, 'callback TEST123', None, 1)

Geri arama düğmesine yanıt olarak etiketli bir bot yönlendirmesi nasıl eklenir?

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 bildirimi göstermenize olanak tanır,\ ! url - URL- botu ve parametreyi belirtir (şu şekilde görünür: t.me/your_bot?start=XXXX, your_bot yerine - bot adı)

Müşteriye mesaj nasıl gönderilir

message() | platform_message() | whatsapp_message()

Satır sonları olan metni bir değişkende saklamak için değeri aşağıdaki gibi ayarlayın:

text = "Birinci satır metni" + "\n" + "İkinci satır metni" + "\n" +"Üçüncü satır metni"

message(client_id, text, message_id, timeout)

Parametreler:\ ! client_id - müşteri 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 müşteriye gönderilir.

Not: message fonksiyonuna message_id parametresini iletirseniz, blok yine de tamamen yürütülür ve client_id parametresinde belirtilen müşteri, message_id'de ilettiğiniz bloğa taşınır.

timeout - mesaj gecikmesi veya planlanan gönderme zamanı. Mesaj göndermeyi geciktirmek için timeout parametresini kullanabilirsiniz:
a) Saniye cinsinden bir 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) gg.aa.yyyy ss:dd 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 müşteri tanımlayıcısı\ ! text - mesaj metni
client_type - mesajlaşma uygulaması türü, isteğe bağlı parametre. Belirtilmezse, müşteri botun mesajı gönderdiği aynı mesajlaşma uygulamasında aranır. Belirtilirse, müşteri belirtilen mesajlaşma uygulamasının veritabanında bulunur. Mesajlaşma uygulaması türlerini burada bulabilirsiniz.
message_id - blok kimliği. Belirtilirse, müşteri metin parametresindeki değeri değil, belirtilen bloktaki mesajı alır.
timeout - gönderme zamanı veya gecikme. Aynı ada sahip message() fonksiyonunun 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ırsa ('') ve bu parametre ayarlanırsa, müşteri belirtilen bloktaki mesaj içeriğini alır.

Whatsapp botunun projeye bağlı olması gerekir.

client_id ile mesaj göndermenin basit bir örneği:

client_id ile mesaj göndermek için farklı seçenekler:

platform_message() ile mesaj gönderme örneği:

/*client_id ile mesaj gönderme*/
message(73704021, 'Müşteri için mesaj metni')
/*client_id ile 30 saniye gecikmeli mesaj gönderme*/
message(73704021, 'Merhaba! Yazdığınız için teşekkürler..','',30)
/*03.04.2022 saat 15:00'te client_id ile 3190 bloğundan mesaj gönderme*/
message(73704021, '',3190, '03.04.2022 15:00')

/*Whatsapp'ta mesaj gönderme*/
whatsapp_message('79999999999', 'Müşteri için mesaj metni')

platform_id değerine göre client_id alma

get_client_id_by_platform_id()

get_client_id_by_platform_id(client_type, platform_id , group)

Yürütüldükten sonra, belirtilen koşullarla eşleşen bir müşteri bulunursa fonksiyon client_id'yi döndürür; aksi takdirde None döndürür.

! client_type - mesajlaşma uygulaması. client_type değeri için bu makaleyi okuyun.

! platform_id - belirtilen mesajlaşma uygulamasındaki müşterinin kimliği.

group - birden fazla mesajlaşma uygulaması botu bağlıysa zorunlu bir parametredir.

Projede aynı türden birden fazla mesajlaşma uygulaması bağlıysa, arama bu türdeki tüm bağlı mesajlaşma uygulamaları üzerinden yapılacaktır.

Bu durumda, group parametresini iletmenizi öneririz.

Get-istekleri için fonksiyon: requests_get(url, answer_type, headers, params, auth, proxy)

! url - isteğin yapıldığı bağlantıdır

answer_type – sunucu yanıtından neyin döndürülmesi gerektiğini tanımlayan isteğe bağlı parametredir: ('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) şu biçimde bir yanıt döndürür: '{"status": status_code, "data": data}')

headers - istek başlıklarını iletmek için isteğe bağlı parametredir,

params - get istek parametreleridir (doğrudan URL'ye de dahil edilebilir),

auth - API kimlik doğrulaması için kullanışlı olan isteğe bağlı parametredir. Herhangi bir isteğe bağlı parametre kullanmak istemiyor ancak bir sonrakine ihtiyacınız varsa, buraya 0 girin.

proxy - isteğe bağlı parametredir; isteği Avrupa IP adresi üzerinden yönlendiren tek bir değer kabul eder: "de".

Post istekleri için fonksiyonlar

requests_post(url, answer_type, headers, data, json_data, auth, proxy)

! url - isteğin yapıldığı bağlantıdır,

answer_type - sunucu yanıtından neyin döndürülmesi gerektiğini tanımlayan isteğe bağlı parametredir: ('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) şu biçimde bir yanıt döndürür: '{"status": status_code, "data": data}')

headers - istek başlıklarını iletmek için isteğe bağlı parametredir

data - isteğe bağlı parametredir; API json ile çalışmadığında istek gövdesini temsil eder.

json_data - isteğe bağlı parametredir; ayrıca istek gövdesini temsil eder. Bu parametrelerden aynı anda yalnızca birini kullanmalısınız.

Lütfen unutmayın: belirli başlık yapılandırmaları, isteğin belirli bir gövde türüyle gönderilmesini engelleyebilir.

proxy - isteğe bağlı parametredir; isteği Avrupa IP adresi üzerinden yönlendiren tek bir değer kabul eder: "de".

Put-istekleri için fonksiyonlar

requests_put(url, answer_type, headers, data, auth, proxy)

! url - isteğin yapıldığı bağlantıdır

headers - istek başlıklarını iletmek için isteğe bağlı parametredir

data - isteğe bağlı parametredir; API json ile çalışmadığında istek gövdesini temsil eder.

proxy - isteğe bağlı parametredir; isteği Avrupa IP adresi üzerinden yönlendiren tek bir değer kabul eder: "de".

data_is_json isteğe bağlı bir parametredir.
Ayarlanırsa, data içinde iletilen veriler JSON biçiminde gönderilir.
Etkinleştirmek için '1' iletin.

Patch-istekleri için fonksiyonlar

requests_patch(url, answer_type, headers, data, auth, proxy)

! url - isteğin yapıldığı bağlantıdır

headers - istek başlıklarını iletmek için isteğe bağlı parametredir

data - isteğe bağlı parametredir; API json ile çalışmadığında istek gövdesini temsil eder.

proxy - isteğe bağlı parametredir; isteği Avrupa IP adresi üzerinden yönlendiren tek bir değer kabul eder: "de".

Delete istekleri için fonksiyonlar

requests_delete(url, answer_type, headers, data, json_data, auth, proxy)

! url - isteğin yapıldığı bağlantıdır

headers - istek başlıklarını iletmek için isteğe bağlı parametredir

data - isteğe bağlı parametredir; API json ile çalışmadığında istek gövdesini temsil eder.

json_data - isteğe bağlıdır ve ayrıca istek gövdesi olarak kullanılabilir. Ancak, aynı anda yalnızca bir seçenek kullanılmalıdır

auth - API kimlik doğrulaması için kullanışlı olan isteğe bağlı parametredir. Herhangi bir isteğe bağlı parametre kullanmak istemiyor ancak bir sonrakine ihtiyacınız varsa, buraya 0 girin

proxy - isteğe bağlı parametredir; isteği Avrupa IP adresi üzerinden yönlendiren tek bir değer kabul eder: "de".

Blok adını kimliğine göre alma fonksiyonu

get_block_name_by_id(block_id)

! block_id — blok tanımlayıcısı (id)