Mengirim Pesan

Untuk mengirimkan pesan kepada seseorang di Messenger, percakapan harus diinisiasi oleh orang tersebut. Platform Messenger memiliki beberapa jenis pesan yang dapat Anda kirim. Pesan yang dikirim dengan Platform Messenger memiliki kebijakan dan pedoman untuk jenis konten dan dalam kondisi apa pesan tersebut dapat dikirim.

Komponen Pesan

Semua permintaan Send API dari aplikasi Anda untuk mengirim pesan harus menyertakan hal berikut:

• ID Halaman untuk Halaman Facebook atau Halaman Facebook yang tertaut ke akun Profesional Instagram, mengirimkan pesan
• ID untuk orang yang menerima pesan
• Token akses Halaman yang diminta dari Halaman yang mengirim pesan
• Izin dari orang yang menerima pesan
• Jenis pesan
• Konten pesan

Untuk informasi selengkapnya tentang komponen pesan, buka Referensi Send API.

Periode Pengiriman Pesan Standar

Periode Pengiriman Pesan Standar adalah periode waktu 24 jam yang diizinkan bagi Anda untuk mengirim pesan kepada seseorang. Ketika seseorang mengirim pesan ke Halaman atau akun Profesional Instagram Anda atau memulai percakapan melalui plugin web, aplikasi Anda memiliki hingga 24 jam untuk mengirim pesan.

Pesan yang dikirim dalam periode 24 jam mungkin berisi konten promosi.

Tindakan Pengguna yang Membuka Periode Pengiriman Pesan Standar

Tindakan pengguna berikut akan membuka periode pengiriman pesan standar 24 jam:

• Seseorang mengirim pesan ke Halaman atau akun Profesional Instagram Anda
• Seseorang mengeklik tombol ajakan bertindak seperti Memulai percakapan
• Seseorang mengeklik iklan yang Mengarah ke Messenger dan kemudian mengirim pesan ke Halaman atau akun Profesional Instagram Anda
• Seseorang mengirim pesan ke Halaman melalui plugin, seperti plugin Kirim ke Messenger atau Kotak Centang
• Seseorang mengeklik tautan m.me yang membawanya ke percakapan yang ada antara orang tersebut dan Halaman
• Seseorang mengeklik tautan ig.me yang membawanya ke percakapan yang ada antara orang tersebut dan akun Profesional Instagram
• Seseorang menanggapi pesan, seperti pesan marketing
• Seseorang mengomentari postingan di Halaman atau akun Profesional Instagram Anda
• Seseorang menerbitkan postingan pengunjung di Halaman Anda

Kami tahu orang-orang mengharapkan tanggapan yang cepat, oleh karena itu, kami sangat mendorong Anda untuk menanggapi sesegera mungkin dalam periode 24 jam ini. Orang-orang memiliki opsi untuk memblokir atau menyenyapkan percakapan kapan saja.

ID Penerima

ID untuk orang yang menerima pesan diatur di parameter objek recipient dan bisa berupa salah satu jenis ID berikut:

• ID Lingkup Halaman (PSID) – ID yang diberikan kepada seseorang saat pertama kali orang tersebut mengirim pesan ke Halaman Anda. ID unik ini mewakili interaksi antara Halaman Anda dan orang tersebut.

• Referensi Pengguna–ID yang diberikan kepada orang yang menggunakan plugin atau tombol postback untuk mengirim pesan ke Halaman Anda.

• ID Postingan atau Komentar: ID yang diberikan kepada orang yang menerbitkan postingan di Halaman Anda atau mengomentari postingan. Digunakan untuk mengirim balasan pribadi kepada orang tersebut.

Harap diperhatikan bahwa ID pengguna dari integrasi Facebook Login berlingkup aplikasi dan tidak berfungsi dengan platform Messenger.

Jenis Pengiriman Pesan

Jenis pesan yang Anda kirim diatur dalam parameter messaging_type. Parameter ini adalah cara yang lebih eksplisit untuk memastikan pesan Anda mematuhi kebijakan pengiriman pesan dan preferensi penerima.

Jenis pesan berikut didukung:

• Tanggapan – Pesan yang Anda kirim merupakan tanggapan terhadap pesan yang diterima. Pesan dapat berisi konten promosi dan nonpromosi dan harus dikirim selama periode pengiriman pesan standar.

• Pembaruan – Pesan yang Anda kirim dikirim secara proaktif dan tidak menanggapi pesan yang diterima. Pesan dapat berisi konten promosi dan nonpromosi dan harus dikirim selama periode pengiriman pesan standar.

• Pesan Ditandai – Pesan yang Anda kirim dikirim di luar periode pengiriman pesan standar. Pesan ini harus menyertakan tanda pesan yang cocok dengan kasus penggunaan yang diizinkan untuk tanda tersebut dan berisi konten nonpromosi.

Tag Pesan

Tag Pesan memungkinkan Anda untuk mengirim pesan di luar periode pengiriman pesan standar. Pesan-pesan ini adalah pembaruan yang relevan secara pribadi untuk seseorang. Contoh: Anda dapat mengirim pembaruan tentang pengiriman dan pengantaran, reservasi atau penerbangan yang akan datang, atau pemberitahuan tentang akun pelanggan. Untuk alur pengiriman pesan yang memerlukan jalur eskalasi, tag Agen Manusia memungkinkan perwakilan bisnis untuk menanggapi pesan pengguna secara manual dalam periode 7 hari.

Tag Pesan tidak boleh digunakan untuk mengirim konten promosi, termasuk tetapi tidak terbatas pada promo, penawaran, kupon, dan diskon. Penggunaan Tag Pesan di luar kasus penggunaan yang disetujui dapat berakibat pembatasan pada kemampuan akun Halaman atau Instagram untuk mengirim pesan. Lihat Kebijakan Platform Messenger dan Instagram Messaging API untuk detailnya.

Bisnis yang menggunakan Platform Messenger dan ingin mengirim pesan promosi di luar periode pengiriman pesan standar 24 jam harus menggunakan Pesan Bersponsor atau Notifikasi Satu Kali.

Jenis Konten

Pesan yang Anda kirim dapat berisi jenis konten berikut:

Mengirimkan Teks Dasar

Untuk mengirim pesan teks dasar kepada orang yang mengirim pesan ke Halaman Anda, kirim permintaan POST ke endpoint /PAGE-ID/messages, dengan id kode literal objek recipient diatur ke ID lingkup Halaman (PSID) milik orang itu, parameter message_type diatur ke RESPONSE, dan text objek parameter message diatur ke teks pesan.

Contoh Permintaan

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v25.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

Saat berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID penerima dan ID pesan.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Mengirim Lampiran Media

Untuk mengirim pesan dengan media, seperti GIF atau gambar, atau template, tambahkan konten ke permintaan API dalam objek lampiran pesan JSON.

Untuk mengirim pesan dengan gambar kepada orang yang mengirim pesan ke Halaman Anda, kirim permintaan POST ke endpoint /PAGE-ID/messages, dengan id kode literal objek recipient diatur ke ID lingkup Halaman (PSID) orang itu, parameter message_type diatur ke RESPONSE, dan kode type objek attachment parameter message diatur ke image, serta kode url objek payload diatur ke URL untuk gambar.

Contoh Permintaan

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Saat berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID penerima dan ID pesan.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Mengirim audio, video, atau file dari URL akan menggunakan format yang sama.

Anda juga dapat mengirim media dari server Anda atau dari konten yang telah Anda unggah sebelumnya ke server Meta. Pelajari selengkapnya tentang mengunggah file menggunakan Attachment Upload API.

Mengirim Lampiran Beberapa Media

Untuk mengirim pesan dengan beberapa gambar, tambahkan konten ke permintaan API dalam array lampiran pesan JSON. Satu-satunya jenis media yang diizinkan adalah gambar, dan dibatasi hingga 30 gambar sekaligus.

Untuk mengirim pesan dengan beberapa gambar kepada orang yang mengirim pesan ke Halaman Anda, kirim permintaan POST ke endpoint /PAGE-ID/messages, dengan id kode literal objek recipient diatur ke ID lingkup Halaman (PSID) orang itu, parameter message_type diatur ke RESPONSE, dan kode type objek attachments parameter yang mengandung array message diatur ke image, serta kode url objek payload diatur ke URL untuk gambar.

Contoh Permintaan

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "1254459154682919"
  },
  "message": {
    "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "http://www.messenger-rocks.com/image.jpg"
        }
      }
    ]
  }
}' "https://graph.facebook.com/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

Saat berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID penerima dan ID pesan.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

Mengirim Balasan ke Pesan

Untuk mengirim balasan pesan tertentu di masa lalu dalam obrolan, kirimkan permintaan POST ke /PAGE-ID/messages dengan kode berikut:

• id kunci literal objek recipient ditetapkan ke ID lingkup halaman (PSID) seseorang
• message_type diatur ke RESPONSE
• detail pesan Anda di objek parameter pesan
• mid kunci literal objek reply_to diatur ke ID pesan dari pesan tertentu dalam obrolan yang ingin Anda balas

Pesan tersebut dapat berupa pesan yang dikirim oleh Halaman Anda atau pengguna.

Contoh Permintaan

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "<PSID>",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}" 

Saat berhasil, aplikasi Anda akan menerima tanggapan JSON berikut dengan ID penerima dan ID pesan.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U…"
} 

Praktik Terbaik

Pesan Teks

• Buat sesingkat mungkin. Pertimbangkan ukuran layar dan perilaku pengguliran; pesan ringkas lebih mudah diikuti orang. Cobalah mengirim beberapa pesan terpisah, bukan satu pesan yang panjang.
• Jangan gunakan teks sebagai pengganti gambar, tabel, bagan, dan gambar. Pesan terstruktur atau bahkan tampilan web mungkin lebih cocok dengan kebutuhan Anda.
• Jangan menulis percakapan yang panjang. Jika Anda perlu menyampaikan beberapa hal, cobalah mengirim beberapa pesan terpisah dan bukan satu pesan panjang.

Lampiran

• Perhatikan kualitas. Gunakan gambar berwarna dengan resolusi tinggi untuk membuat pesan Anda menonjol.
• Pertimbangkan rasio aspek. Tinjau bagaimana gambar Anda bisa dipotong ketika muncul di gelembung pesan.
• Jangan menaruh banyak teks di gambar Anda. Gunakan pesan teks sebagai gantinya, atau gabungkan gambar dan teks dengan template umum.

Jenis Pesan Lainnya

Pesan Marketing

Pesan Marketing memungkinkan Anda meminta izin kepada seseorang untuk mengirim beberapa pesan marketing setelah periode pengiriman pesan standar berakhir. Jika orang tersebut menyetujui permintaan ini yang ditujukan untuk menerima notifikasi-notifikasi ini, Anda akan dapat mengirim pesan promosi berulang otomatis kepada orang tersebut dengan informasi tentang penjualan atau rilis produk mendatang, serta info terkini.

Pengiriman Pesan Berita (Dalam pengembangan)

Pengiriman Pesan Berita hanya tersedia untuk media berita terdaftar yang terdaftar dengan Indeks Halaman Berita (NPI) Facebook. Pengiriman Pesan Berita memungkinkan media berita untuk mengirim pesan berita nonpromosi kepada orang-orang yang telah berlangganan untuk menerima pesan-pesan ini.

Pengiriman pesan berita tidak tersedia untuk Instagram Messaging API.

Notifikasi Satu Kali

Notifikasi Satu Kali memungkinkan Anda untuk meminta izin mengirimkan satu pesan tindak lanjut kepada pengguna setelah periode pengiriman pesan standar berakhir. Jika orang tersebut menyetujui permintaan ini yang ditujukan untuk menerima notifikasi satu kali, Anda akan dapat mengirim satu pesan yang sensitif terhadap waktu dan relevan secara pribadi, seperti pengingat janji temu atau pemberitahuan kembali ada stok.

Notifikasi Satu Kali tidak tersedia untuk Instagram Messaging API.

Balasan Privat

Balasan Privat memungkinkan Anda untuk mengirim pesan kepada seseorang ketika orang tersebut mempublikasikan komentar di salah satu postingan atau iklan Anda, atau mempublikasikan postingan pengunjung di Halaman atau akun Profesional Instagram Anda. Balasan privat hanya dapat berupa satu pesan, yang secara otomatis akan berisi tautan ke postingan atau komentar, dan harus dikirim dalam tujuh hari sejak orang tersebut menerbitkan postingan atau komentar.

Pesan Bersponsor

Pesan Bersponsor memungkinkan Anda untuk mengirim konten promosi atau nonpromosi, setelah periode pengiriman pesan standar telah kedaluwarsa, kepada orang yang sebelumnya telah mengirim pesan ke Halaman atau akun Profesional Instagram Anda. Pesan Bersponsor tampak seperti pesan normal dalam percakapan tetapi diberi anotasi dengan kata Bersponsor di atas pesan. Konten pesan bersponsor harus mematuhi kebijakan periklanan.

Pesan Bersponsor tidak tersedia untuk Instagram Messaging API.

Pesan Utilitas

Pesan Utilitas memungkinkan Anda mengirim pesan template yang telah disetujui sebelumnya yang mencakup pesanan, pembaruan akun, dan janji temu. Pesan-pesan ini sangat dipersonalisasi dengan nomor akun, ID pesanan, nomor pelacakan pengiriman, tanggal dan waktu janji temu dan dapat memiliki ajakan bertindak yang memungkinkan pengguna untuk membatalkan pesanan, menjadwalkan ulang janji temu, dan tindakan lain yang memudahkan interaksi dengan bisnis.

Langkah Berikutnya

Pelajari tentang komponen yang dapat Anda tambahkan ke pesan dalam percakapan Anda.

Pelajari Selengkapnya

Pelajari selengkapnya tentang mengirim pesan menggunakan Platform Messenger.

• Referensi API Unggah Lampiran – Pelajari selengkapnya tentang mengunggah dan mengirimkan media.
• Referensi Send API – Pelajari selengkapnya tentang semua tag, konten, dan lampiran yang dapat Anda kirim.
• Batas Laju – Pelajari tentang batas laju untuk mengirim pesan menggunakan Platform Messenger.