Riferimento per `persistent_menu`

Puoi impostare il menu always-on per il tuo bot in modo da aiutare le persone a scoprire e ad accedere più facilmente alla tua funzionalità per l'intera durata della conversazione.

Il menu always-on è sempre disponibile all'utente. Questo menu deve contenere azioni di livello superiore che gli utenti possono attuare in qualsiasi momento. Avere un menu always-on comunica in maniera semplice le funzionalità di base del tuo bot per i nuovi utenti e per gli utenti che tornano. Il menu si presenta automaticamente in un thread se la persona torna dopo essere stata assente per un certo periodo di tempo. Queste impostazioni fanno parte del Riferimento per l'API Messenger Profile

Il menu always-on può anche essere impostato e modificato a livello utente. Per ulteriori informazioni in merito, consulta Menu di livello utente.

Requisiti

Per utilizzare il menu always-on, devi:

Impostare un pulsante Inizia.
Avere il ruolo di 'Amministratore' per la Pagina associata al bot.

Formato `persistent_menu`

Esempio di menu always-on

{
    "persistent_menu": [
        {
            "locale": "default",
            "composer_input_disabled": false,
            "call_to_actions": [
                {
                    "type": "postback",
                    "title": "Talk to an agent",
                    "payload": "CARE_HELP"
                },
                {
                    "type": "postback",
                    "title": "Outfit suggestions",
                    "payload": "CURATION"
                },
                {
                    "type": "web_url",
                    "title": "Shop now",
                    "url": "https://www.originalcoastclothing.com/",
                    "webview_height_ratio": "full"
                }
            ]
        }
    ]
}

Proprietà

Proprietà	Tipo	Descrizione
`locale`	Stringa	Un array di oggetti che definiscono il menu always-on per diverse lingue. Verrà visualizzato il menu con la proprietà `locale` corrispondente alla lingua della persona. Almeno un oggetto nell'array `persistent_menu` deve specificare `"locale": "default"`. Questo è il menu che utilizzeremo per il fallback nel caso in cui non venga trovato alcun oggetto con proprietà `locale` corrispondente alla lingua dell'utente. Consulta la lista delle lingue supportate.
`composer_input_disabled`	Booleano	Disabilita il campo dello strumento di composizione di Messenger se impostato su `true`. Questo significa che è possibile interagire con il tuo bot solo tramite menu always-on, postback, pulsanti e visualizzazioni web. L'impostazione predefinita è `false`.
`disabled_surfaces`	Array	Array di nomi di interfacce per disabilitare il menu always-on. Attualmente è supportato solo `customer_chat_plugin`.
`call_to_actions`	Array<`menu_item`>	Un array di voci di menu di livello superiore per il menu always-on. Sono consentiti un massimo di 3 elementi. Elemento obbligatorio se `"composer_input_disabled": true`.

Oggetto `menu_item`

Proprietà	Tipo	Descrizione
`type`	Stringa	Il tipo di elemento del menu. I valori supportati sono: `web_url`: specifica che l'elemento è un pulsante con URL. `postback`: specifica che l'elemento è un pulsante con postback.
`title`	Stringa	Titolo da visualizzare sull'elemento del menu. Limite di 30 caratteri.
`url`	Stringa	URL da aprire quando viene toccato il pulsante. Elemento obbligatorio se il tipo è `web_url`.
`payload`	Stringa	Dati che verranno rispediti al tuo webhook come evento `messaging_postbacks`. Elemento obbligatorio se il tipo è `postback`. Limite di 1000 caratteri.
`webview_height_ratio`	Stringa	*Facoltativo.* Altezza della visualizzazione web. I valori validi includono: `compact`, `tall`, `full`.
`messenger_extensions`	Booleano	*Facoltativo.* Deve essere `true` se il tipo di elemento è `web_url` e nella visualizzazione web sarà utilizzato l'SDK per le estensioni di Messenger.
`fallback_url`	Stringa	*Facoltativo.* URL da aprire nella visualizzazione web per i client che non supportano l'SDK per le estensioni di Messenger. Se non è definito, come fallback sarà utilizzato `url`. Può essere specificato solo se `"messenger_extensions": true`.
`webview_share_button`	Stringa	*Facoltativo.* Impostalo su `hide` per disabilitare la condivisione nella visualizzazione web (per informazioni riservate).

Disabilitazione del menu always-on

In alcuni casi potrebbe essere preferibile disabilitare il menu always-on per il tuo bot nel plug-in per la chat. A tale scopo, aggiungi "disabled_surfaces": ["CUSTOMER_CHAT_PLUGIN"] quando imposti il menu always-on:

Esempio di payload dell'API Messenger Profile

{
  "persistent_menu":[
    {
      "locale":"default",
      "disabled_surfaces": ["CUSTOMER_CHAT_PLUGIN"],
      "composer_input_disabled": false,      
      "call_to_actions":[
        {
          "title":"My Account",
          "type":"postback",
          "payload":"PAYBILL_PAYLOAD"
        }
      ]
    }
  ]
}

Rate limit

Le chiamate all'API Messenger Profile sono limitate a 10 chiamate API per intervallo di 10 minuti. Questo rate limit viene applicato per Pagina.

Tieni presente che le chiamate al menu di livello utente sono limitate a 10 chiamate API per utente per un intervallo di 10 minuti. Questo rate limiting viene applicato per Pagina.

Riferimento per persistent_menu