Kalıcı Menü Nedir

Kalıcı menü, işletmenizin ana işlevlerinin (çalışma saatleri, mağaza konumları, ürünler gibi) bir menüsünü oluşturmanıza ve göndermenize olanak tanır. Bu menü, bir kişinin Messenger'da şirketinizle yaptığı sohbet sırasında her zaman görünür olacaktır.

Desteklenen Düğmeler:

Kalıcı menü, bir dizi düğmeden oluşur. Kalıcı menüde aşağıdaki düğme türleri desteklenir:

● URL düğmeleri (web_url)
● Geri arama düğmeleri (postback)

Belirli Bir Sayfa İçin Kalıcı Menü Nasıl Eklenir

response = fb_set_persistent_menu("group_id", buttons) , burada:
group_id - Facebook bot kimliği ( "Kanal" MaviBot menüsünde bulunabilir)
buttons - düğmeleri içeren bir sözlük

Düğme sözlüğünün nasıl yapılandırılacağına dair örnek:
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]}

default - kullanıcının yerelleştirmesinden bağımsız olarak menüde varsayılan olarak gösterilecek düğme dizisini tanımlayan zorunlu bir anahtar.
Değer, bir düğme dizisi olmalıdır. Her düğme, aşağıdaki formatta ayrı bir dizi olarak tanımlanır:
["button_type", "Button display text", "Callback text sent to the bot"]

Düğme türleri ve açıklamaları:
&#xNAN;- geri arama düğmesi:
["postback", "Button display text", "Callback text sent to the bot"]
&#xNAN;- URL düğmesi:
["web_url", "Link display text", "https://example.com"]

Belirli yerel ayarlara karşılık gelen düğme sözlüğüne ek anahtarlar ekleyerek farklı bölgeler için düğmeler ayarlayabilirsiniz.

Örneğin, İngilizce yerel ayarı için düğmeler eklemek:

buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]], "en_EN": [["postback", "Button", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Link", "https://mavibot.ai/"]]}

Not: Bu durumda anahtar, düğmelerin görüntüleneceği yerel ayarı temsil eder.

Desteklenen yerel ayarlar:
af_ZA, ar_AR, as_IN, az_AZ, be_BY, bg_BG, bn_IN, br_FR, bs_BA, ca_ES, cb_IQ, co_FR, cs_CZ, cx_PH, cy_GB, da_DK, de_DE, el_GR, en_GB, en_UD, en_US, es_ES, es_LA, et_EE, eu_ES, fa_IR, ff_NG, fi_FI, fo_FO, fr_CA, fr_FR, fy_NL, ga_IE, gl_ES, gn_PY, gu_IN, ha_NG, he_IL, hi_IN, hr_HR, hu_HU, hy_AM, id_ID, is_IS, it_IT, ja_JP, ja_KS, jv_ID, ka_GE, kk_KZ, km_KH, kn_IN, ko_KR, ku_TR, lt_LT, lv_LV, mg_MG, mk_MK, ml_IN, mn_MN, mr_IN, ms_MY, mt_MT, my_MM, nb_NO, ne_NP, nl_BE, nl_NL, nn_NO, or_IN, pa_IN, pl_PL, ps_AF, pt_BR, pt_PT, qz_MM, ro_RO, ru_RU, rw_RW, sc_IT, si_LK, sk_SK, sl_SI, so_SO, sq_AL, sr_RS, sv_SE, sw_KE, sz_PL, ta_IN, te_IN, tg_TJ, th_TH, tl_PH, tr_TR, tz_MA, uk_UA, ur_PK, uz_UZ, vi_VN, zh_CN, zh_HK, zh_TW

Belirli Bir Kullanıcı İçin Kalıcı Menü Nasıl Eklenir

Bunu yapmak için, fb_set_persistent_menu fonksiyonunun üçüncü parametresini 1 olarak ayarlayın, şu şekilde: response = fb_set_persistent_menu('group_id', buttons, 1)

Bu menü, fonksiyonun çağrıldığı kullanıcı tarafından kullanılabilir olacaktır.

NOT . Kullanıcı düzeyindeki kalıcı menüyü güncelleme gerçek zamanlı olarak etkili olur.

Ancak, sayfa düzeyindeki kalıcı menüyü güncelleme 24 saate kadar sürebilir.

Kullanıcı düzeyi ayarları, kullanıcı başına her 10 dakikada 10 çağrı ile sınırlıdır.

Kalıcı Menü Dışındaki Tüm İletişimler Nasıl Devre Dışı Bırakılır

Kalıcı menüyü, bir kullanıcının Messenger botunuzla etkileşime geçebileceği tek yol haline getirmek için besteleyiciyi devre dışı bırakmanız gerekir.

Bunu neden yaparsınız?

Botunuz belirli bir amaç veya önceden tanımlanmış bir dizi seçenek için tasarlandığında kullanışlıdır.

Bu nasıl yapılır?

Besteleyiciyi devre dışı bırakmak için, fonksiyonda dördüncü parametre olarak 1 değerini iletin:

besteleyiciyi sayfa düzeyinde (tüm kullanıcılar için) devre dışı bırakmak için:
response = fb_set_persistent_menu('group_id', buttons, '', 1)
besteleyiciyi fonksiyonun çağrıldığı kullanıcı için devre dışı bırakmak için:
response = fb_set_persistent_menu('group_id', buttons, 1, 1)
burada:
group_id - Facebook bot kimliği ( "Kanal" MaviBot menüsünde bulunabilir)
buttons - düğmeleri içeren bir sözlük

Başarılı olursa, fonksiyon şunu döndürür:
{"result":"success"}

Aksi takdirde, bir hata açıklaması döndürür.
'Error parse buttons data' - düğme sözlüğünde hata
{"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}

ÖRNEKLER:

Tüm kullanıcılar için menü ekleme:

buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]], "en_EN": [["postback", "Button", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons)

Tüm kullanıcılar için menü ekleme ve bu menüyü herkes için tek iletişim yöntemi yapma:

buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]], "en_EN": [["postback", "Button", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, '', 1)

Fonksiyonu çağıran bloğa giren kullanıcı için menü ekleme:

buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, 1)

Fonksiyonu çağıran bloğa giren kullanıcı için menü ekleme ve bu menüyü tüm kullanıcılar için tek iletişim yöntemi yapma:

buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]}
response = fb_set_persistent_menu('123456789', buttons, 1, 1)

Sayfa düzeyinde kalıcı menüyü silme (tüm kullanıcılar için):

response = fb_delete_persistent_menu('group_id')

Başarılı olursa, fonksiyon şunu döndürür:
{"result":"success"}

Aksi takdirde, bir hata açıklaması döndürür.
'Bot not found'

Kullanıcı düzeyinde kalıcı menüyü silme:

response = fb_delete_persistent_menu('group_id', 1)

Başarılı olursa, fonksiyon şunu döndürür:
{"result":"success"}

Aksi takdirde, bir hata açıklaması döndürür.

"Bot not found"