Referensi API Unggah 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 Referensi Send API.

Mengunggah lampiran

Untuk mengunggah lampiran, kirim permintaan POST ke endpoint /Your-page-id/message_attachment dengan 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/v19.0/Your-page-id/message_attachment" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image", 
               "payload":{
                 "url":"https.your-url.com/image.jp",
                 "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 "https://graph.facebook.com/v19.0/Your-page-id/message_attachment" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image"
             }
           },
           "filedata":"@/path-to-your-file/image.png";"type":"image/png"
         }'

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 "https://graph.facebook.com/v19.0/Your-page-id/messages" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image",
               "payload":{
                 "attachment_id":"Your-attachment-ID"
               }
             }
           }
         }'

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