Referensi Template Generik

Template generik memungkinkan Anda mengirim pesan terstruktur yang menyertakan gambar, teks, dan tombol. Template generik dengan beberapa template yang dijelaskan dalam array elements akan mengirim carousel item yang dapat digulir secara horizontal, masing-masing terdiri dari gambar, teks, dan tombol. Untuk detail penerapan selengkapnya, lihat Template Generik.

URI Permintaan

https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

Contoh Permintaan

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://petersfancybrownhats.com/company_image.png",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://petersfancybrownhats.com/view?item=103",
              "messenger_extensions": false,
              "webview_height_ratio": "tall",
              "fallback_url": "https://petersfancybrownhats.com/"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://petersfancybrownhats.com",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"DEVELOPER_DEFINED_PAYLOAD"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Contoh Tanggapan

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

Properti

`recipient`

Keterangan penerima pesan. Semua permintaan harus menyertakan salah satu dari id, phone_number, atau user_ref.

Properti	Jenis	Keterangan
`recipient.id`	String	Baik `PSID`, `phone_number`, maupun `user_ref` penerima pesan.
`recipient.phone_number`	String	*Opsional.* Nomor ponsel penerima dengan format +1(212)555-2368. Bot Anda harus disetujui untuk Pencocokan Pelanggan untuk mengirim pesan dengan cara ini.
`recipient.user_ref`	String	*Opsional.*`user_ref` dari plugin kotak centang.
`recipient.name`	Objek	*Opsional.* Digunakan hanya jika `phone_number` diatur. Tentukan nama orang dalam format: `{"first_name":"John", "last_name":"Doe"}` Memberikan nama akan meningkatkan peluang kecocokan.

`message`

Description of the message to be sent.

Property	Type	Description
`message.attachment`	Object	An object describing attachments to the message.

`message.attachment`

Property	Type	Description
`type`	String	Value must be `template`
`payload`	Object	`payload` template.

`message.attachment.payload`

Nama Properti	Jenis	Deskripsi
`template_type`	String	Nilainya harus `generic`
`elements`	Array<`element`>	Array yang berisi 1 objek elemen yang mendeskripsikan media dalam pesan. Maksimal 1 elemen didukung.
`sharable`	Boolean	*Opsional.* Atur ke `true` untuk mengaktifkan tombol berbagi native di Messenger untuk pesan template. Default-nya adalah `false`.

`message.attachment.payload.elements`

Template generik mendukung maksimal 10 elemen per pesan. Setidaknya satu properti harus diatur selain title.

Nama Properti	Jenis	Deskripsi
`title`	String	Judul untuk ditampilkan di template. Terbatas 80 karakter.
`subtitle`	String	*Opsional.* Subtitle untuk ditampilkan di template. Terbatas 80 karakter.
`image_url`	String	*Opsional.* URL gambar yang akan tampil di template.
`default_action`	Objek	*Opsional.* Tindakan default dijalankan saat template diketuk. Menerima properti yang sama seperti tombol URL, kecuali `title`.
`buttons`	Array<`button`>	*Opsional.* Array tombol untuk ditambahkan ke template. Maksimal 3 tombol per elemen didukung.