Referensi API Unggahan Lampiran

API Unggah Lampiran memungkinkan Anda untuk mengunggah aset yang dapat dikirim dalam pesan nantinya. Hal ini memungkinkan Anda agar tidak perlu mengunggah file yang umum digunakan berkali-kali. API mendukung menyimpan aset dari URL dan dari sistem file lokal Anda.

Anda juga dapat menggunakan Send API untuk mengirim pesan secara bersamaan dengan lampiran dan menyimpan lampiran untuk digunakan nanti. Untuk informasi selengkapnya, lihat bagian Unggah dan kirim di bawah.

Unggah lampiran

Untuk mengunggah lampiran, kirim POST permintaan ke endpoint /Your-page-id/message_attachments menggunakan message.attachment dengan type dan payload. Agar dapat menggunakan aset di beberapa pesan, atur payload.is_reusable ke true.

Contoh permintaan untuk unggahan dari URL

Diformat agar mudah dibaca. Ganti nilai cetak tebal, cetak miring, seperti page_access_token, dengan nilai Anda.

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
               }
             }
           }
         }'

Contoh permintaan untuk unggahan dari file

Diformat agar mudah dibaca. Ganti nilai cetak tebal, cetak miring, seperti page_access_token, dengan nilai Anda.

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}"

Jika berhasil, aplikasi Anda akan menerima objek JSON dengan attachment_id disetel ke ID lampiran Anda untuk digunakan dalam pesan Anda.

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

Mengirim pesan dengan aset yang diunggah

Untuk mengirim pesan dengan aset yang telah Anda unggah sebelumnya, unggah dengan message.attachment.payload.is_reusable diatur ke true, kirim permintaan POST ke endpoint /Your-page-id/messages dengan recipient.id, dan objek message.attachment dengan type dan payload.attachment_id.

Contoh permintaan untuk unggahan dari file

Diformat agar mudah dibaca. Ganti nilai cetak tebal, cetak miring, seperti page_access_token, dengan nilai Anda.

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}"

Setelah berhasil, aplikasi Anda akan menerima objek JSON dengan success diatur ke true.

{"success": "true"}

Unggah dan kirim

Anda juga dapat mengunggah media dan mengirimkannya dalam satu permintaan API.

Contoh permintaan untuk unggahan dari URL

Diformat agar mudah dibaca. Ganti nilai cetak tebal, cetak miring, seperti page_access_token, dengan nilai Anda.

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}"

Setelah berhasil, aplikasi Anda akan menerima objek JSON dengan success diatur ke true.

{"success": "true"}

Properti

Untuk lampiran dari URL, sediakan properti berikut di isi permintaan sebagai objek JSON. Untuk lampiran dari file, kirim properti sebagai data formulir.

message

message.attachment

message.attachment.payload

Kode Kesalahan