Kas ir pastāvīgā izvēlne?

Pastāvīgā izvēlne ļauj attēlot pastāvīgu izvēlni ar jūsu uzņēmuma galvenajām darbībām, piemēram, darba laiku, veikalu atrašanās vietām, produktiem vai citām bieži izmantotām opcijām. Izvēlne vienmēr ir redzama sarunas laikā ar jūsu Facebook Messenger botu.

Atbalstītie pogu veidi

Pastāvīgā izvēlne atbalsta šādus pogu veidus:

  • URL pogas (web_url)
  • Atzvanīšanas pogas (postback)

Izveidot pastāvīgo izvēlni

Izmantojiet šādu funkciju, lai izveidotu pastāvīgo izvēlni Facebook lapai:

response = fb_set_persistent_menu(group_id, buttons)

Parametri

Parametrs Apraksts
group_id Facebook Bota ID. To varat atrast sava MaviBot projekta sadaļā Kanāls.
buttons Vārdnīca, kas apraksta izvēlnes pogas.

Pogu vārdnīcas struktūra

buttons = {
    "default": [
        ["postback", "Poga 1", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ]
}

Atslēga default ir obligāta. Tā nosaka pogas, kas tiek rādītas lietotājiem, kuru lokalizācijai nav pielāgotas izvēlnes.

Katra poga ir aprakstīta ar masīvu:

["button_type", "Pogas teksts", "Vērtība"]

Atbalstītie pogu formāti

Atzvanīšanas poga

["postback", "Pogas teksts", "callback_text"]
Vērtība Apraksts
postback Pogu veids.
Pogas teksts Uz pogas redzamais teksts.
callback_text Teksts, kas tiek nosūtīts botam, kad poga tiek nospiesta.

URL poga

["web_url", "Pogas teksts", "https://example.com"]
Vērtība Apraksts
web_url Pogu veids.
Pogas teksts Uz pogas redzamais teksts.
URL Vietne, kas tiek atvērta, kad poga tiek nospiesta.

Lokalizācija

Atkarībā no lietotāja lokalizācijas varat rādīt dažādas izvēlnes.

Vienkārši pievienojiet papildu atslēgas pogu vārdnīcai.

Piemērs:

buttons = {
    "default": [
        ["postback", "Poga 1", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Poga", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ]
}

Šajā piemērā lietotāji ar lokalizāciju en_EN saņems citu izvēlni.

Atbalstītās lokalizācijas

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

Izveidot pastāvīgo izvēlni konkrētam lietotājam

Lai izveidotu izvēlni, kas ir redzama tikai tam lietotājam, kuram funkcija tiek izsaukta, kā trešo parametru nododiet 1.

response = fb_set_persistent_menu(group_id, buttons, 1)

Piezīme

Lietotāja līmeņa pastāvīgās izvēlnes tiek atjauninātas nekavējoties.

Lapas līmeņa pastāvīgās izvēlnes atjaunināšana var aizņemt līdz 24 stundām.

Turklāt Facebook ierobežo lietotāja līmeņa izvēlnes atjauninājumus līdz 10 pieprasījumiem vienam lietotājam ik pēc 10 minūtēm.

Atspējot komponētāju

Varat atspējot Messenger komponētāju, lai lietotāji varētu mijiedarboties ar botu tikai caur pastāvīgo izvēlni.

Tas ir noderīgi, ja botam vajadzētu atļaut tikai iepriekš noteiktas darbības.

Atspējot komponētāju visiem lietotājiem

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

Atspējot komponētāju konkrētam lietotājam

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

Parametri

Parametrs Apraksts
group_id Facebook Bota ID.
buttons Pogu vārdnīca.
3. parametrs Iestatiet uz 1, lai izvēlni piemērotu tikai pašreizējam lietotājam. Atstājiet tukšu, lai piemērotu lapai.
4. parametrs Iestatiet uz 1, lai atspējotu Messenger komponētāju.

Atgrieztās vērtības

Ja funkcija tiek veiksmīgi izpildīta:

{"result":"success"}

Pretējā gadījumā tiek atgriezts kļūdas apraksts.

Piemērs:

Error parse buttons data

vai

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

Piemēri

Izveidot izvēlni visiem lietotājiem

buttons = {
    "default": [
        ["postback", "Poga 1", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Poga", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ]
}

response = fb_set_persistent_menu("123456789", buttons)

Izveidot izvēlni visiem lietotājiem un atspējot komponētāju

buttons = {
    "default": [
        ["postback", "Poga 1", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ],
    "en_EN": [
        ["postback", "Poga", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ]
}

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

Izveidot izvēlni pašreizējam lietotājam

buttons = {
    "default": [
        ["postback", "Poga 1", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ]
}

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

Izveidot lietotāja izvēlni un atspējot komponētāju

buttons = {
    "default": [
        ["postback", "Poga 1", "callback_text 1"],
        ["postback", "Poga 2", "callback_text 2"],
        ["web_url", "Vietne", "https://mavibot.ai/"]
    ]
}

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

Dzēst pastāvīgo izvēlni

Dzēst lapas līmeņa izvēlni

response = fb_delete_persistent_menu(group_id)

Veiksmīga atbilde:

{"result":"success"}

Iespējamā kļūda:

Bot not found

Dzēst lietotāja līmeņa izvēlni

response = fb_delete_persistent_menu(group_id, 1)

Veiksmīga atbilde:

{"result":"success"}

Iespējamā kļūda:

Bot not found