Modello con contenuti multimediali
Il modello con contenuti multimediali ti consente di inviare immagini, GIF e video come messaggio strutturato con un pulsante facoltativo. Video e GIF animate inviati tramite il modello con contenuti multimediali sono riproducibili nella conversazione.
Il modello con contenuti multimediali può essere inviato tramite l'API Send e dalla visualizzazione Web di Messenger con la funzione beginShareFlow() dell'SDK per le estensioni di Messenger.
Solo immagini e video
Attualmente, il modello con contenuti multimediali supporta solo l'invio di immagini e video. L'audio non è supportato al momento.
Contenuti
Invio di contenuti multimediali mediante ID allegato
Per inviare un'immagine, invia una richiesta POST all'API Send con la seguente proprietà payload nel corpo della richiesta, in cui attachment_id è un ID generato dall'API Attachment Upload. Per le richieste che usano la proprietà attachment_id, è previsto il supporto di immagini e video.
Per informazioni complete sulle proprietà della richiesta, consulta il riferimento per il modello con contenuti multimediali.
Riutilizzo dei contenuti multimediali dagli URL di Facebook
Gli ID allegato non sono supportati per i contenuti multimediali provenienti dagli URL di Facebook. Questi file sono già memorizzati nella cache e devono essere allegati al modello con contenuti multimediali con il loro URL di Facebook.
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"<PSID>"
},
"message":{
"attachment": {
"type": "template",
"payload": {
"template_type": "media",
"elements": [
{
"media_type": "<image|video>",
"attachment_id": "<ATTACHMENT_ID>"
}
]
}
}
}
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"Invio di contenuti multimediali mediante URL di Facebook
Il modello con contenuti multimediali ti consente di inviare video e foto caricati su Facebook inviando una richiesta POST all'endpoint /messages con l'URL di Facebook nella proprietà url della richiesta:
Per informazioni complete sulle proprietà della richiesta, consulta il riferimento per il modello con contenuti multimediali.
Solo URL di Facebook
Il modello con contenuti multimediali non accetta nessun URL esterno, ma solo quelli di Facebook. Per inviare un'immagine o un video con un URL esterno, effettua il caricamento usando l'API Attachment Upload e ottieni un attachment_id.
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"<PSID>"
},
"message":{
"attachment": {
"type": "template",
"payload": {
"template_type": "media",
"elements": [
{
"media_type": "<image|video>",
"url": "<FACEBOOK_URL>"
}
]
}
}
}
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"Ottenimento di un URL di Facebook
Per ottenere l'URL di Facebook per un'immagine o un video, segui questa procedura:
- Clicca sulla miniatura dell'immagine o sull'anteprima del video per aprire la visualizzazione a dimensione intera.
- Copia l'URL dalla barra degli indirizzi del browser.
Gli URL di Facebook sono nel formato di base seguente:
| Tipo di contenuto multimediale | Origine contenuti multimediali | Formato URL |
|---|---|---|
Video | Pagina Facebook |
|
Video | Account Facebook |
|
Immagine | Pagina Facebook |
|
Immagine | Account Facebook |
|
Aggiunta di un pulsante
Puoi anche inserire pulsanti nel modello con contenuti multimediali. Il numero e i tipi di pulsanti supportati variano se stai usando il modello con contenuti multimediali con beginShareFlow() dell'SDK per le estensioni di Messenger o in caso di invio con l'API Send:
Send API: puoi allegare fino a 3 pulsanti di qualsiasi tipo.beginShareFlow(): puoi allegare solo un pulsante di tipo URL.
Per aggiungere un pulsante al tuo modello con contenuti multimediali, aggiungi un array buttons alla definizione del modello nel corpo della richiesta.
Per maggiori informazioni sui pulsanti disponibili, consulta Pulsanti.
"elements": [
{
"media_type": "image",
"url": "<MEDIA_URL>",
"buttons": [
{
"type": "web_url",
"url": "<WEB_URL>",
"title": "View Website",
}
]
}
]Risposta API
Una volta eseguita correttamente l'operazione, la Piattaforma Messenger risponderà con recipient_id e message_id del messaggio inviato:
{
"recipient_id": "1254477777772919",
"message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}