Riferimento per l'API Attachment Upload

L'API Attachment Upload consente di caricare risorse che possono essere inviate nei messaggi in un secondo momento, evitando così di dover caricare più volte file di uso comune. L'API supporta il salvataggio delle risorse da un URL e dal tuo file system locale.

Puoi inoltre utilizzare l'API Send per inviare contemporaneamente un messaggio con un allegato e salvare l'allegato per un uso successivo. Per maggiori informazioni, vedi la sezione Caricamento e invio di seguito.

Caricamento di un allegato

Per caricare un allegato invia una richiesta POST all'endpoint </Your-page-id/message_attachments con message.attachment con type e payload. Per poter utilizzare la risorsa in più messaggi, imposta payload.is_reusable su true.

Esempio di richiesta di caricamento da un URL

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto come page_access_token con i tuoi valori.

curl -X POST "https://graph.facebook.com/v21.0/Your-page-id/message_attachments" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image", 
               "payload":{
                 "url":"https://your-url.com/image.jpg",
                 "is_reusable": true
               }
             }
           }
         }'

Esempio di richiesta di caricamento da un file

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto come page_access_token con i tuoi valori.

curl -X POST -H "Content-Type: application/json" -d '{
   "message": {
     "attachment": {
       "type": "image"
     }
   },
   "filedata": "@/path-to-your-file/image.jpg",
   "type": "image/png"
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/message_attachments?access_token={PAGE_ACCESS_TOKEN}"

In caso di azione eseguita correttamente, l'app riceverà un oggetto JSON con attachment_id impostato sull'ID del tuo allegato da utilizzare nei messaggi.

{"attachment_id": "Your-attachment-ID"}

Invio di un messaggio con una risorsa caricata

Per inviare un messaggio con una risorsa che hai caricato in precedenza con message.attachment.payload.is_reusable impostato su true, invia una richiesta POST all'endpoint /Your-page-id/messages con recipient.id e l'oggetto message.attachment con type e payload.attachment_id.

Esempio di richiesta di caricamento da un file

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto come page_access_token con i tuoi valori.

curl -X POST -H "Content-Type: application/json" -d '{
    "recipient": {
      "id": "{PSID}"
    },
    "message": {
      "attachment": {
        "type": "image",
        "payload": {
          "attachment_id": "Your-attachment-ID"
        }
      }
    }
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/messages?access_token={PAGE_ACCESS_TOKEN}"

In caso di azione eseguita correttamente, l'app riceverà un oggetto JSON con success impostato su true.

{"success": "true"}

Caricamento e invio

Puoi anche caricare contenuti multimediali e inviarli in un'unica richiesta API.

Esempio di richiesta di caricamento da un URL

Formattato per una maggiore leggibilità. Sostituisci i valori corsivi in grassetto come page_access_token con i tuoi valori.

curl -X POST -H "Content-Type: application/json" -d '{
   "recipient": {
     "id": "{PSID}"
   },
   "message": {
     "attachment": {
       "type": "image",
       "payload": {
         "url": "https://your-url.com/image.jpg"
       }
     }
   }
  }' "https://graph.facebook.com/v21.0/{PAGE_ID}/messages?access_token={PAGE_ACCESS_TOKEN}"

In caso di azione eseguita correttamente, l'app riceverà un oggetto JSON con success impostato su true.

{"success": "true"}

Proprietà

Per gli allegati da un URL, fornisci le seguenti proprietà nel corpo della richiesta come oggetto JSON. Per gli allegati da file, invia le proprietà come dati del modulo.

message

message.attachment

message.attachment.payload

Codici di errore