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, Standorte 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. Im persistenten Menü werden die folgenden Schaltflächentypen unterstützt:
● URL-Schaltflächen (web_url)
● Callback-Schaltflächen (postback)
So fügen Sie ein persistentes Menü für eine bestimmte Seite hinzu
response = fb_set_persistent_menu("group_id", buttons), wobei:
group_id - Facebook-Bot-ID (zu finden im "Channel" MaviBot-Menü)
buttons - ein Wörterbuch, das die Schaltflächen enthält
Beispiel für die Struktur des Schaltflächenwö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ächenwö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
So fügen Sie ein persistentes Menü für einen bestimmten Benutzer hinzu
Setzen Sie dazu den dritten Parameter der Funktion fb_set_persistent_menu auf 1, wie folgt: response = fb_set_persistent_menu('group_id', buttons, 1)
Dieses Menü ist für den Benutzer verfügbar, für den die Funktion aufgerufen wurde.
HINWEIS . Aktualisieren eines persistenten Menüs auf Benutzerebene wird in Echtzeit wirksam.
Das Aktualisieren eines persistenten Menüs auf Seitenebene kann jedoch bis zu 24 Stunden dauern.Einstellungen auf Benutzerebene sind begrenzt auf eine Rate von 10 Aufrufen pro Benutzer alle 10 Minuten.
So deaktivieren Sie die gesamte Kommunikation außer dem persistenten Menü
Um das persistente Menü zur einzigen Möglichkeit zu machen, wie ein Benutzer mit Ihrem Messenger-Bot interagieren kann, müssen Sie den Composer deaktivieren.
Warum sollten Sie das tun?
Es ist nützlich, wenn Ihr Bot für einen bestimmten Zweck oder eine vordefinierte Reihe von Optionen ausgelegt ist.
Wie geht das?
Um den Composer zu deaktivieren, übergeben Sie 1 als vierten Parameter in der Funktion:
um den Composer auf Seitenebene (für alle Benutzer) zu deaktivieren:
response = fb_set_persistent_menu('group_id', buttons, '', 1)
um den Composer für den Benutzer zu deaktivieren, für den die Funktion aufgerufen wird:
response = fb_set_persistent_menu('group_id', buttons, 1, 1)
wobei:
group_id - Facebook-Bot-ID (zu finden im "Channel" MaviBot-Menü)
buttons - ein Wörterbuch, das die Schaltflächen enthält
Bei Erfolg gibt die Funktion zurück:
{"result":"success"}
Andernfalls wird eine Fehlerbeschreibung zurückgegeben.
'Error parse buttons data' - Fehler im Schaltflächenwörterbuch
{"error":{"message":"(#100) param persistent_menu[0][call_to_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace_id":"AJtVczu7TEJJxbMfnO"}}
BEISPIELE:
Hinzufügen eines Menüs für alle Benutzer:
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)
Hinzufügen eines Menüs für alle Benutzer und Festlegen dieses Menüs als einzige Kommunikationsmethode für alle:
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)
Hinzufügen eines Menüs für den Benutzer, der den Block betreten hat, der die Funktion aufruft:
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)
Hinzufügen eines Menüs für den Benutzer, der den Block betreten hat, der die Funktion aufruft, und Festlegen dieses Menüs als einzige Kommunikationsmethode für alle Benutzer:
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)
Löschen des persistenten Menüs auf Seitenebene (für alle Benutzer):
response = fb_delete_persistent_menu('group_id')
Bei Erfolg gibt die Funktion zurück:
{"result":"success"}
Andernfalls wird eine Fehlerbeschreibung zurückgegeben.
'Bot not found'
Löschen des persistenten Menüs auf Benutzerebene:
response = fb_delete_persistent_menu('group_id', 1)
Bei Erfolg gibt die Funktion zurück:
{"result":"success"}
Andernfalls wird eine Fehlerbeschreibung zurückgegeben.
"Bot not found"