Modello generico
Il modello generico è un semplice messaggio strutturato che include titolo, sottotitolo, immagine e fino a tre pulsanti. Puoi anche specificare un oggetto default_action che imposta un URL. Questo viene aperto nella visualizzazione web di Messenger quando l'elemento viene toccato.
Contenuti
Payload del modello
Per una lista completa delle proprietà del modello, consulta il riferimento per i modelli generici.
"payload": {
"template_type":"generic",
"elements":[
{
"title":"Invio di un carosello di modelli generici
La piattaforma Messenger supporta l'invio di un carosello a scorrimento orizzontale di modelli generici.
Per creare un carosello a scorrimento, includi fino a 10 modelli generici nell'array elements del payload.
"payload": {
"template_type":"generic",
"elements":[Esempio di richiesta
Per i dettagli completi sulle richieste e le proprietà, consulta il riferimento per i modelli generici.
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"<PSID>"
},
"message":{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"elements":[
{
"title":"Welcome!",
"image_url":"https://petersfancybrownhats.com/company_image.png",
"subtitle":"We have the right hat for everyone.",
"default_action": {
"type": "web_url",
"url": "https://petersfancybrownhats.com/view?item=103",
"messenger_extensions": false,
"webview_height_ratio": "tall",
"fallback_url": "https://petersfancybrownhats.com/"
},
"buttons":[
{
"type":"web_url",
"url":"https://petersfancybrownhats.com",
"title":"View Website"
},{
"type":"postback",
"title":"Start Chatting",
"payload":"DEVELOPER_DEFINED_PAYLOAD"
}
]
}
]
}
}
}
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"Esempio di risposta
{
"recipient_id": "1254477777772919",
"message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}
Best practice
Usalo per messaggi con una gerarchia delle informazioni coerente (ad es. anteprime di prodotti o articoli, previsioni meteo).
Usa le proporzioni corrette per la tua immagine. Le foto nel modello generico che non sono 1,91:1 saranno ridimensionate o ritagliate.
Non usarlo se il tuo messaggio non ha informazioni strutturate o non necessita di una gerarchia.
Non usarlo se desideri che le persone possano ingrandire la tua immagine a schermo intero.
Non usare gif nel modello se vuoi che siano animate. Le gif sono supportate, ma non saranno animate.
Carosello
Usa un carosello quando c'è un ordine di priorità per i tuoi contenuti, cioè il primo articolo è probabilmente il più interessante.
Cerca di garantire coerenza. Se una bolla ha una foto, includi una foto in tutte.
Riduci al minimo il numero di modelli generici nel carosello. Un numero eccessivo rende difficile per le persone ricordare tutte le opzioni.
Non mischiare i tipi di contenuti. Se includi un articolo accanto a una lista di prodotti, la tua esperienza potrebbe causare confusione.
Non usare un carosello quando è importante che le persone vedano tutto quello che c'è nella lista, poiché potrebbero non scorrere fino alla fine. Considera invece di utilizzare un modello lista.