Templat Media

Dengan templat media, Anda dapat mengirimkan gambar, GIF, dan video sebagai pesan berstruktur dengan tombol opsional. Video dan animasi GIF yang dikirimkan dengan templat media dapat diputar di dalam percakapan.

Templat media dapat dikirimkan melalui API Kirim dan dari webview Messenger dengan menggunakan fungsi beginShareFlow() SDK Ekstensi Messenger.

Hanya Gambar dan Video Saja

Pada saat ini, templat media hanya mendukung pengiriman gambar dan video. Audio saat ini tidak didukung.

Konten

Mengirim Media dengan ID Lampiran
Mengirim Media dengan URL Facebook
- Memperoleh URL Facebook
Menambahkan Tombol
Tanggapan API

Mengirim Media dengan ID Lampiran

Untuk mengirim gambar, kirimkan permintaan POST ke API Kirim, dengan properti payload di isi permintaan yang attachment_id di dalamnya adalah ID yang dibuat dari API unggah lampiran. Gambar dan video didukung untuk permintaan yang menggunakan properti attachment_id.

Untuk detail properti permintaan selengkapnya, lihat Referensi Templat Media.

Menggunakan Ulang Media dari URL Facebook

ID Lampiran tidak didukung untuk media yang berasal dari URL Facebook. File ini telah disimpan dalam cache dan harus dilampirkan ke templat media dengan URL Facebook-nya.

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

Mengirim Media dengan URL Facebook

Templat media membuat Anda dapat mengirimkan video dan foto yang diunggah ke Facebook dengan mengirimkan permintaan POST ke endpoint /messages dengan URL Facebook di properti url permintaan:

Untuk detail properti permintaan selengkapnya, lihat Referensi Templat Media.

Hanya URL Facebook Saja

Templat media tidak memperbolehkan URL eksternal apa pun, hanya memperbolehkan URL di Facebook. Untuk mengirimkan gambar atau video dengan URL eksternal, unggah dengan menggunakan API Unggah Kiriman dan dapatkan 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>"

Mendapatkan URL Facebook

Untuk mendapatkan URL Facebook untuk gambar atau video, lakukan hal berikut:

Klik gambar mini atau video mini untuk membuka tampilan ukuran penuhnya.
Salin URL dari bilah alamat browser Anda.

URL Facebook harus berupa format dasar berikut:

Jenis Media	Sumber Media	Format URL
Video	Halaman Facebook	`https://business.facebook.com/<PAGE_NAME>/videos/<NUMERIC_ID>`
Video	Akun Facebook	`https://www.facebook.com/<USERNAME>/videos/<NUMERIC_ID>/`
Gambar	Halaman Facebook	`https://business.facebook.com/<PAGE_NAME>/photos/<NUMERIC_ID>`
Gambar	Akun Facebook	`https://www.facebook.com/photo.php?fbid=<NUMERIC_ID>`

Menambahkan Tombol

Secara opsional, tombol juga dapat dilampirkan ke templat media. Jumlah dan jenis tombol yang didukung berbeda-beda, bergantung pada apakah Anda menggunakan templat media dengan beginShareFlow() SDK Ekstensi Messenger, atau mengirimkannya dengan API Kirim:

Send API: Dapat melampirkan hingga 3 tombol jenis apa pun.
beginShareFlow(): Hanya 1 tombol jenis URL yang dapat dilampirkan.

Untuk menambahkan tombol ke templat media Anda, tambahkan susunan buttons ke definisi templat isi permintaan Anda.

Untuk tombol lainnya yang tersedia, lihat Tombol.

"elements": [
   {
      "media_type": "image",
      "url": "<MEDIA_URL>",
      "buttons": [
         {
            "type": "web_url",
            "url": "<WEB_URL>",
            "title": "View Website",
         }
      ]
   }
]

Tanggapan API

Jika berhasil, Platform Messenger akan memberi tanggapan dengan kiriman pesan recipient_id dan message_id:

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}