Apakah itu Menu Kekal?

Menu Kekal membolehkan anda memaparkan menu kekal dengan tindakan utama perniagaan anda, seperti waktu perniagaan, lokasi kedai, produk, atau pilihan lain yang kerap digunakan. Menu ini sentiasa kelihatan semasa perbualan dengan bot Facebook Messenger anda.

Jenis Butang yang Disokong

Menu Kekal menyokong jenis butang berikut:

  • Butang URL (web_url)
  • Butang Panggil Balik (postback)

Cipta Menu Kekal

Gunakan fungsi berikut untuk mencipta Menu Kekal untuk halaman Facebook:

response = fb_set_persistent_menu(group_id, buttons)

Parameter

Parameter Penerangan
group_id ID Bot Facebook. Anda boleh menemuinya di bahagian Saluran projek MaviBot anda.
buttons Kamus yang menerangkan butang menu.

Struktur Kamus Butang

buttons = {
    "default": [
        ["postback", "Butang 1", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ]
}

Kunci default adalah wajib. Ia mentakrifkan butang yang dipaparkan untuk pengguna yang lokalnya tidak mempunyai menu tersuai.

Setiap butang diterangkan oleh tatasusunan:

["jenis_butang", "Teks butang", "Nilai"]

Format Butang yang Disokong

Butang Panggil Balik

["postback", "Teks butang", "teks_panggil_balik"]
Nilai Penerangan
postback Jenis butang.
Teks butang Teks yang dipaparkan pada butang.
teks_panggil_balik Teks yang dihantar ke bot apabila butang diklik.

Butang URL

["web_url", "Teks butang", "https://example.com"]
Nilai Penerangan
web_url Jenis butang.
Teks butang Teks yang dipaparkan pada butang.
URL Laman web yang dibuka apabila butang diklik.

Penyetempatan

Anda boleh memaparkan menu yang berbeza bergantung pada lokal pengguna.

Hanya tambah kunci tambahan pada kamus butang.

Contoh:

buttons = {
    "default": [
        ["postback", "Butang 1", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Butang", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ]
}

Dalam contoh ini, pengguna dengan lokal en_EN akan menerima menu yang berbeza.

Lokal yang Disokong

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

Cipta Menu Kekal untuk Pengguna Tertentu

Untuk mencipta menu yang hanya kelihatan kepada pengguna yang fungsi itu dipanggil, hantar 1 sebagai parameter ketiga.

response = fb_set_persistent_menu(group_id, buttons, 1)

Nota

Menu Kekal peringkat pengguna dikemas kini serta-merta.

Menu Kekal peringkat halaman mungkin mengambil masa sehingga 24 jam untuk dikemas kini.

Facebook juga mengehadkan kemas kini menu peringkat pengguna kepada 10 permintaan setiap pengguna setiap 10 minit.

Lumpuhkan Komposer

Anda boleh melumpuhkan komposer Messenger supaya pengguna boleh berinteraksi dengan bot hanya melalui Menu Kekal.

Ini berguna apabila bot hanya membenarkan tindakan yang telah ditetapkan.

Lumpuhkan Komposer untuk Semua Pengguna

response = fb_set_persistent_menu(group_id, buttons, "", 1)

Lumpuhkan Komposer untuk Pengguna Tertentu

response = fb_set_persistent_menu(group_id, buttons, 1, 1)

Parameter

Parameter Penerangan
group_id ID Bot Facebook.
buttons Kamus butang.
Parameter ke-3 Tetapkan kepada 1 untuk menggunakan menu hanya kepada pengguna semasa. Biarkan kosong untuk menggunakan pada halaman.
Parameter ke-4 Tetapkan kepada 1 untuk melumpuhkan komposer Messenger.

Nilai Pulangan

Jika fungsi berjaya dilaksanakan:

{"result":"success"}

Jika tidak, penerangan ralat akan dipulangkan.

Contoh:

Ralat menghurai data butang

atau

{
  "error": {
    "message": "(#100) param persistent_menu[0][call_to_actions] must be non-empty.",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": "AJtVczu7TEJJxbMfnO"
  }
}

Contoh

Cipta Menu untuk Semua Pengguna

buttons = {
    "default": [
        ["postback", "Butang 1", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Butang", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ]
}

response = fb_set_persistent_menu("123456789", buttons)

Cipta Menu untuk Semua Pengguna dan Lumpuhkan Komposer

buttons = {
    "default": [
        ["postback", "Butang 1", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Butang", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ]
}

response = fb_set_persistent_menu("123456789", buttons, "", 1)

Cipta Menu untuk Pengguna Semasa

buttons = {
    "default": [
        ["postback", "Butang 1", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ]
}

response = fb_set_persistent_menu("123456789", buttons, 1)

Cipta Menu Pengguna dan Lumpuhkan Komposer

buttons = {
    "default": [
        ["postback", "Butang 1", "teks_panggil_balik 1"],
        ["postback", "Butang 2", "teks_panggil_balik 2"],
        ["web_url", "Laman Web", "https://mavibot.ai/"]
    ]
}

response = fb_set_persistent_menu("123456789", buttons, 1, 1)

Padam Menu Kekal

Padam Menu Peringkat Halaman

response = fb_delete_persistent_menu(group_id)

Respons berjaya:

{"result":"success"}

Ralat yang mungkin:

Bot tidak ditemui

Padam Menu Peringkat Pengguna

response = fb_delete_persistent_menu(group_id, 1)

Respons berjaya:

{"result":"success"}

Ralat yang mungkin:

Bot tidak ditemui