Platform Messenger

Menyimpan Aset

Untuk mengoptimalkan pengiriman aset, Anda dapat secara opsional meminta Platform Messenger menyimpan aset saat dikirimkan. Hal ini berguna jika Anda berencana untuk mengirim lampiran yang sama berulang kali, karena menghilangkan kebutuhan untuk mengunggah aset bersama setiap permintaan.

Platform Messenger menawarkan dua API yang memungkinkan Anda untuk menyimpan aset untuk digunakan nanti: Send API, dan API Unggah Lampiran. Kedua API mendukung penghematan aset dari URL dan dari sistem file lokal Anda.

Konten

Jenis Aset yang Didukung

Platform Messenger mendukung penyimpanan jenis aset berikut, dengan ukuran hingga 25 MB:

  • gambar
  • audio - tajuk Content-Type harus menggunakan jenis audio. Contoh: audio/mp3.
  • video
  • file

Menyimpan dengan Send API

Send API memungkinkan Anda untuk menyimpan aset yang dikirim dengan pesan, sebagai alternatif metode mengunggah aset terlebih dahulu dengan API Unggah Lampiran. Untuk melakukan ini, kirimkan permintaan POST dengan payload.is_reusable diatur ke true ke endpoint /messages.

Menyimpan dari URL

Untuk menyimpan aset dari sebuah URL, tentukan URL sumber dalam properti payload.url dari objek attachment pesan Anda:

{
  "recipient":{
    "id":"

For a complete list of API calls and request properties, see the Send API Reference.

Menyimpan dari File

Untuk menyimpan aset dari sistem file lokal Anda, kirim permintaan pesan ke Send API sebagai data formulir, dan tentukan lokasi file di kolom filedata permintaan:

curl  \
  -F 'recipient={"id":"<PSID>"}' \
  -F 'message={"attachment":{"type":"<ASSET_TYPE>", "payload":{"is_reusable":true}}}' \
  -F 'filedata=@/tmp/shirt.png;type=image/png' \
  "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

For a complete list of API calls and request properties, see the Send API Reference.

Tanggapan API

Tanggapan akan berisi attachment_id yang dapat digunakan untuk melampirkan aset ke pesan di masa mendatang. Harap diperhatikan bahwa ID ini bersifat pribadi dan hanya halaman yang aslinya mengirim lampiran yang dapat menggunakannya kembali.

{
  "recipient_id": "1254444444682919",
  "message_id": "mid.$cAAJsujCd2ORkHh27-ld7NhzuqrUK",
  "attachment_id": "687799999980546"
}

Menyimpan dengan API Unggah Lampiran

API Unggah Lampiran memungkinkan Anda untuk mengunggah aset terlebih dahulu. Hal ini berguna jika Anda tahu sebelumnya bahwa Anda akan perlu mengirim aset tertentu berulang kali. Untuk melakukan hal ini, kirim permintaan POST ke endpoint /message_attachments.

Untuk daftar lengkap panggilan API dan properti permintaan, lihat Referensi API Unggah Lampiran.

Menyimpan dari URL

Untuk menyimpan aset dari sebuah URL, tentukan URL sumber dalam properti payload.url dari objek attachment pesan Anda:

curl -X POST -H "Content-Type: application/json" -d '{
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "is_reusable": true,
        "url":"http://www.messenger-rocks.com/image.jpg"
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/message_attachments?access_token=<PAGE_ACCESS_TOKEN>"

Untuk daftar lengkap panggilan API dan properti permintaan, lihat Referensi API Unggah Lampiran.

Menyimpan dari File

Untuk menyimpan aset dari sistem file lokal Anda, kirim permintaan pesan ke API Unggah Lampiran sebagai data formulir, dan tentukan lokasi file di kolom filedata permintaan:

curl  \
  -F 'recipient={"id":"<PSID>"}' \
  -F 'message={"attachment":{"type":"<ASSET_TYPE>", "payload":{"is_reusable":true}}}' \
  -F 'filedata=@/tmp/shirt.png;type=image/png' \
  "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Tanggapan API

Tanggapan akan berisi attachment_id yang dapat digunakan untuk melampirkan aset ke pesan di masa mendatang. Harap diperhatikan bahwa ID ini bersifat pribadi dan hanya halaman yang aslinya mengirim lampiran yang dapat menggunakannya kembali.

{
  "attachment_id":"1857777774821032"
}

Mengirim Aset Tersimpan

Setelah Anda memiliki attachment_id untuk aset tersimpan, Anda dapat menggunakannya untuk melampirkan aset ke pesan. Untuk informasi selengkapnya, lihat Mengirim Pesan - Melampirkan Aset Tersimpan.

Dukungan Developer