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

Periode Berkirim Pesan Standar

Periode Berkirim Pesan Standar adalah periode waktu 24 jam di mana Anda diizinkan 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 Berkirim Pesan Standar

Tindakan pengguna berikut akan membuka periode berkirim 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 Berkirim Pesan

Jenis pesan yang Anda kirim diatur dalam parameter messaging_type. Parameter ini adalah cara yang lebih eksplisit untuk memastikan pesan Anda mematuhi kebijakan berkirim 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 berkirim 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 berkirim pesan standar.

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

Tanda Pesan

Tanda Pesan memungkinkan Anda untuk mengirim pesan di luar periode berkirim 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 berkirim pesan yang memerlukan jalur eskalasi, tanda Agen Manusia memungkinkan perwakilan bisnis untuk menanggapi pesan pengguna secara manual dalam periode 7 hari.

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

Bisnis dengan Platform Messenger yang ingin mengirim pesan promosi di luar periode berkirim 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/v21.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/v21.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 API Unggah Lampiran.

Praktik Terbaik

Pesan Teks

Lampiran

Jenis Pesan Lainnya

Berkirim Pesan News (Sedang dikembangkan)

Berkirim Pesan Berita hanya tersedia untuk penerbit berita terdaftar yang terdaftar dengan Facebook News Page Index (NPI). Pesan Berita memungkinkan penerbit berita untuk mengirim pesan berita nonpromosi kepada orang-orang yang telah berlangganan untuk menerima pesan-pesan ini.

Berkirim pesan Berita tidak tersedia untuk API Messaging Instagram.

Notifikasi Satu Kali

Notifikasi Satu Kali memungkinkan Anda untuk meminta izin mengirimkan satu pesan tindak lanjut kepada pengguna setelah periode berkirim pesan standar berakhir. Jika orang tersebut menerima permintaan ini 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 API Messaging Instagram.

Balasan Pribadi

Balasan Pribadi memungkinkan Anda untuk mengirim pesan kepada seseorang ketika orang tersebut menerbitkan komentar di salah satu postingan atau iklan Anda, atau menerbitkan postingan pengunjung di Halaman atau akun Profesional Instagram Anda. Balasan pribadi 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 Marketing

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

Pesan Bersponsor

Pesan Bersponsor memungkinkan Anda untuk mengirim konten promosi atau nonpromosi, setelah periode berkirim pesan standar 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 keterangan dengan kata Bersponsor di atas pesan. Konten pesan bersponsor harus mematuhi kebijakan periklanan

Pesan Bersponsor tidak tersedia untuk API Messaging Instagram.

Langkah Berikutnya

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

Pelajari Selengkapnya

Pelajari selengkapnya tentang mengirim pesan menggunakan Platform Messenger.

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