Facebook API
Kalıcı menü nedir
Kalıcı menü, işletmenizin çalışma saatleri, mağaza konumları ve ürünler gibi ana işlevlerinden oluşan bir menü oluşturup göndermenize olanak tanır. Messenger’da bir kişinin şirketinizle yaptığı konuşma 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 çağırma düğmeleri (postback)
Belirli bir sayfa için kalıcı menü nasıl eklenir
response = fb_set_persistent_menu("group_id", buttons), burada: group_id - Facebook bot kimliği, (içinde bulunabilir "Channel" MaviBot menüsü) buttons - düğmeleri içeren bir sözlük
Düğme sözlüğünün nasıl yapılandırılacağına örnek: buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]]}
varsayılan - menüde varsayılan olarak gösterilecek düğmeler dizisini tanımlayan gerekli bir anahtar, kullanıcının yerelleştirmesinden bağımsız olarak. Değer, bir düğme dizisi olmalıdır. Her düğme aşağıdaki biçimde 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ı: - geri çağırma düğmesi: ["postback", "Düğme gösterim metni", "Bot'a gönderilen geri çağırma metni"] - URL düğmesi: ["web_url", "Bağlantı gösterim metni", "https://example.com"]
Menüyü kullanıcı yerel ayarına göre nasıl yapılandırılır
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üğme eklemek üzere:
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ı için kalıcı menü nasıl eklenir
Bunu yapmak için, fb_set_persistent_menu fonksiyonunun üçüncü parametresini 1 olarak ayarlayın, şöyle: response = fb_set_persistent_menu('group_id', buttons, 1)
Bu menü, fonksiyonun çağrıldığı kullanıcı için kullanılabilir olacaktır.
NOT . Güncelleme kullanıcı düzeyindeki bir kalıcı menü gerçek zamanlı olarak etkili olur. Ancak, sayfa düzeyindeki bir kalıcı menünün güncellenmesi 24 saate kadar sürebilir.
Kullanıcı düzeyi ayarlar sınırlıdır her 10 dakikada kullanıcı başına 10 çağrı oranıyla.
Kalıcı menü dışındaki tüm iletişimi 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 yapmak için, composer’ı devre dışı bırakmanız gerekir.
Bunu neden yapasınız?
Botunuz belirli bir amaç veya önceden tanımlanmış bir seçenek kümesi için tasarlandığında kullanışlıdır.
Bunu nasıl yaparsınız?
Composer’ı devre dışı bırakmak için, fonksiyonda dördüncü parametre olarak 1 geçin:
composer’ı 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) fonksiyonun çağrıldığı kullanıcı için composer’ı devre dışı bırakmak için: response = fb_set_persistent_menu('group_id', buttons, 1, 1) burada: group_id - Facebook bot kimliği, (içinde bulunabilir "Channel" MaviBot menüsü) 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. 'Data yazımı için hata' - 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:
Tüm kullanıcılar için menü ekleme ve bu menüyü herkes için tek iletişim yöntemi haline getirme:
Fonksiyonu çağıran bloğa giren kullanıcı için menü ekleme:
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 haline getirme:
Kalıcı menüyü sayfa düzeyinde (tüm kullanıcılar için) silin:
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'
Kalıcı menüyü kullanıcı düzeyinde silin:
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"
Last updated