Was ist ein persistentes Menü
Ein persistentes Menü ermöglicht es Ihnen, ein Menü mit den Hauptfunktionen Ihres Unternehmens zu erstellen und zu senden, wie z. B. Geschäftszeiten, Filialstandorte und Produkte. Es ist während einer Unterhaltung einer Person mit Ihrem Unternehmen in Messenger stets sichtbar.
Unterstützte Schaltflächen:
Das persistente Menü besteht aus einer Reihe von Schaltflächen. Folgende Schaltflächentypen werden im persistenten Menü unterstützt:
● URL-Schaltflächen (web_url)
● Callback-Schaltflächen (postback)
So fügen Sie ein persistentes Menü hinzu
response = ig_set_persistent_menu(login, buttons), wobei:
login - Ihr Instagram-Login (zu finden im "Channel" MaviBot-Menü)
buttons - ein Wörterbuch, das die Schaltflächen enthält
Beispiel für die Struktur des Schaltflächen-Wörterbuchs:
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "<https://mavibot.ai/"]]}\
default - ein erforderlicher Schlüssel, der das Array der standardmäßig anzuzeigenden Schaltflächen im Menü definiert, unabhängig von der Lokalisierung des Benutzers.
Der Wert sollte ein Array von Schaltflächen sein. Jede Schaltfläche wird als separates Array im folgenden Format beschrieben:
["button_type", "Button display text", "Callback text sent to the bot"]
Schaltflächentypen und ihre Beschreibung:
&#xNAN;- Callback-Schaltfläche:
["postback", "Button display text", "Callback text sent to the bot"]
&#xNAN;- URL-Schaltfläche:
["web_url", "Link display text", "https://example.com"]
So konfigurieren Sie das Menü basierend auf der Benutzerlokalisierung
Sie können Schaltflächen für verschiedene Regionen einrichten, indem Sie dem Schaltflächen-Wörterbuch zusätzliche Schlüssel hinzufügen, die bestimmten Gebietsschemata entsprechen.
Zum Beispiel, um Schaltflächen für das englische Gebietsschema hinzuzufügen:
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/"]]}
Hinweis: In diesem Fall repräsentiert der Schlüssel das Gebietsschema, für das die Schaltflächen angezeigt werden.
Unterstützte Gebietsschemata:
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
Beispiel einer Anfrage:
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 = ig_set_persistent_menu('login', buttons)
Bei erfolgreicher Ausführung gibt die Funktion zurück:
{"result":"success"}
Andernfalls wird eine Fehlerbeschreibung zurückgegeben:
"Error parse buttons data" weist auf einen Fehler im Schaltflächen-Wörterbuch hin.
{"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}
So löschen Sie ein permanentes Menü
response = ig_delete_persistent_menu('login'), wobei login - Kontoname
Bei erfolgreicher Ausführung gibt die Funktion zurück:
{"result":"success"}
Andernfalls wird eine Fehlerbeschreibung zurückgegeben:
"Bot not found"