Dokumen ini berisi catatan perubahan untuk versi Platform Messenger saat ini. Platform Messenger mengikuti Versi Graph API.
Versi terbaru adalah: v21.0
response_feedback
MessengerPeristiwa webhook response_feedback
yang baru memberitahukan Anda saat pengguna memberikan umpan balik pada pesan yang Anda kirim, dengan mengklik salah satu tombol "jempol ke atas"/"jempol ke bawah"/"Tanggapan baik"/"Tanggapan buruk". Lihat selengkapnya tentang webhook di sini.
Aplikasi Anda sekarang dapat melakukan 300 (meningkat dari 100) panggilan per detik per akun Profesional Instagram untuk pesan yang berisi teks, tautan, tanggapan, dan stiker. Pelajari selengkapnya.
Komponen API Instagram baru ini:
graph.instagram.com
instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
Memantau Catatan Perubahan Platform Instagram untuk perubahan termasuk perbaikan bug dan fitur baru
ig_reel
sekarang akan menjadi jenis lampiran yang didukung untuk webhook pesan. Lampiran reel Instagram akan memiliki jenis ig_reel
dan payload lampiran akan mencakup judul, url, dan id video reel.
ig_reel
dan reel
sekarang akan menjadi jenis lampiran yang didukung di webhook pesan. Lampiran reel Instagram akan memiliki jenis ig_reel
, dan payload lampiran akan mencakup judul, url, dan id video reel. Lampiran reel Facebook akan memiliki jenis reel
, dan payload lampiran akan mencakup judul, url, dan id video reel.
Bisnis yang menggunakan Perutean Percakapan Messenger sekarang dapat mengonfigurasi kemampuan pengambilalihan kontrol utas pada level aplikasi individu. Konfigurasi pengambilalihan asli yang dipasangkan dengan aplikasi standar sekarang sudah tidak digunakan lagi dengan semua nilai yang dimigrasikan. Pelajari selengkapnya di sini.
Berlaku untuk semua versi
Selain ad_id
dan ad_title
, original_media_id
akan ditampilkan di objek media
dari kolom comments
, tepatnya di objek value
, saat seseorang berkomentar di postingan Instagram atau postingan iklan Instagram yang dipromosikan. Untuk informasi selengkapnya, lihat Siapkan Webhooks untuk Instagram.
message_edits
Peristiwa WebhookPeristiwa webhook message_edits
yang baru memberitahu Anda ketika pengguna mengedit pesan yang telah dikirim sebelumnya. Pelajari selengkapnya tentang peristiwa webhook ini di sini.
"Reel" sekarang akan menjadi jenis lampiran yang didukung untuk webhook pesan yang dikirim untuk percakapan Messenger. Lampiran reel akan dikategorikan sebagai jenis reel
dan payload lampiran akan mencakup judul, URL, dan ID video reel.
Perintah adalah kata kunci yang dapat diketuk dan dapat dipanggil oleh pengguna kapan saja untuk melakukan tindakan tertentu dalam pengalaman Messenger. Perintah terdiri dari perintah itu sendiri dan sebuah petunjuk, yang memberikan informasi kepada pengguna tentang apa yang dilakukannya. Contoh, saat pengguna mengetik "bantu saya memesan penerbangan dan hotel ke Meksiko untuk minggu terakhir di bulan Desember", mereka menjalankan perintah penerbangan dan hotel yang dikonfigurasi oleh bisnis perjalanan. Pelajari selengkapnya di sini.
Menu perintah adalah menu baru yang kami perkenalkan yang akan muncul secara otomatis saat Anda mengatur perintah. Jika Anda sudah menetapkan menu persisten untuk pengalaman Messenger Anda, menu perintah akan menggantikannya. Pelajari selengkapnya di sini.
Orang-orang kini dapat membagikan pengalaman pengiriman pesan Anda dari halaman profil bisnis di Messenger. Hal ini membantu mendorong penemuan pengalaman Messenger Anda dari mulut ke mulut. Pelajari selengkapnya di sini.
Perintah akan muncul di profil bisnis setelah Anda mengonfigurasi perintah untuk pengalaman Messenger Anda. Orang dapat menavigasi ke profil bisnis dengan mengetuk nama halaman di bagian atas dan mempelajari tentang perintah yang Anda sediakan di pengalaman Messenger.
Layar sambutan menampilkan daftar perintah yang didukung oleh pengalaman pengiriman pesan, sehingga memudahkan orang-orang untuk memahami tindakan apa yang dapat dilakukan oleh pengalaman Messenger. Pelajari selengkapnya di sini.
Jika Anda mengembangkan aplikasi untuk mengirim dan menerima pesan untuk halaman Anda sendiri, Anda tidak perlu memeriksa ulasan aplikasi. Perhatikan bahwa jika Anda berencana mengambil informasi profil pengguna, Anda masih harus melalui tinjauan aplikasi untuk mendapatkan izin yang diperlukan guna mengakses Profile API Pengguna.
Perutean Percakapan sekarang tersedia untuk Instagram. Perutean Percakapan memungkinkan Meta merutekan percakapan antara bisnis Anda dan pelanggan, atau calon pelanggan, ke aplikasi yang telah Anda tentukan untuk memberikan tanggapan dalam percakapan tersebut. Perutean ini memungkinkan bisnis Anda membuat percakapan yang kaya dengan orang-orang dan meminimalkan panggilan API ke server Meta.
Akses API Label Khusus dan API Persona telah dipulihkan untuk bisnis yang beroperasi di Eropa, dan untuk orang-orang di Eropa dan Jepang yang terhubung dengan bisnis secara global.
Bisnis dan agensi kini dapat dengan mudah menghubungkan iklan Klik ke Messenger dan Klik ke Instagram Direct mereka ke pesan sambutan yang dibuat di aplikasi mitra tanpa harus menggunakan snippet kode JSON. Pesan sambutan akan muncul sebagai dropdown di pengelola iklan saat membuat iklan Klik ke Messenger dan Klik ke Instagram Direct. Pelajari selengkapnya di sini.
Balasan Pribadi sekarang tersedia untuk komentar di Facebook Reels.
Pembaruan pada Balasan Pribadi untuk grup, kolom baru yang mendukung informasi pemberi komentar melalui kolom from
dan konteks induk melalui parent_id
yang diperkenalkan ke Webhooks group_feed
. Anda mungkin perlu memperbarui server Webhooks Anda untuk menangani kolom baru ini.
Sebagai sebuah bisnis, Anda dapat menggunakan beberapa penyedia pengiriman pesan pihak ketiga untuk berbagai percakapan dengan pelanggan Anda, seperti penciptaan prospek, promo marketing tentang produk Anda, atau pertanyaan dukungan pelanggan. Perutean percakapan memungkinkan Anda menentukan mitra mana yang mengontrol percakapan pelanggan pada waktu tertentu, sehingga pelanggan mendapatkan informasi yang mereka perlukan. Anda dapat membuat dan mengelola aturan perutean pesan di pengaturan Halaman.
Template tombol mengirimkan pesan teks dengan maksimum tiga tombol terlampir. Template ini berguna untuk menawarkan pilihan kepada penerima pesan, seperti tanggapan yang telah ditentukan sebelumnya untuk suatu pertanyaan, atau tindakan yang harus diambil. Jenis tombol yang didukung adalah postback
dan web_url
.
Sebagai sebuah bisnis, Anda dapat menggunakan beberapa penyedia pengiriman pesan pihak ketiga untuk berbagai percakapan dengan pelanggan Anda, seperti penciptaan prospek, promo marketing tentang produk Anda, atau pertanyaan dukungan pelanggan. Perutean percakapan memungkinkan Anda menentukan mitra mana yang mengontrol percakapan pelanggan pada waktu tertentu, sehingga pelanggan mendapatkan informasi yang mereka perlukan. Anda dapat membuat dan mengelola aturan perutean pesan di pengaturan Halaman.
Template tombol mengirimkan pesan teks dengan maksimum tiga tombol terlampir. Template ini berguna untuk menawarkan pilihan kepada penerima pesan, seperti tanggapan yang telah ditentukan sebelumnya untuk suatu pertanyaan, atau tindakan yang harus diambil. Jenis tombol yang didukung adalah postback
dan web_url
.
Berkirim Pesan di Instagram sekarang tersedia untuk akun Profesional Instagram untuk bisnis atau Kreator.
Anda sekarang dapat menambahkan topik panggilan agar pelanggan atau orang-orang yang tertarik dengan bisnis Anda menghubungi bisnis Anda.
Anda sekarang dapat membuat iklan yang menyertakan alur klik untuk berlangganan yang memungkinkan Anda untuk meminta pelanggan atau orang-orang yang tertarik dengan bisnis Anda untuk setuju ikut serta menerima pesan marketing.
Perutean Multiaplikasi kini tersedia untuk Instagram Direct dan Messenger.
Balasan Pribadi
Bisnis Anda sekarang dapat mengirim Balasan Pribadi kepada seseorang yang mengomentari Postingan Grup Facebook.
Notifikasi Berulang
Notifikasi Berulang sekarang dikenal sebagai Pesan Marketing.
Template
Template Berstruktur sekarang tersedia untuk mengumpulkan informasi pengiriman dari pelanggan.
Messaging Insights API
Metrik dan parameter baru tersedia untuk Messaging Insights API.
Notifikasi Berulang untuk Platform Messenger
Properti title
untuk notifikasi berulang permintaan ikut sertatidak lagi diperlukan. Jika title
tidak diatur, default-nya adalah "Updates and promotions". Perubahan ini berlaku untuk permintaan ikut serta yang dikirim dari Halaman Facebook atau akun Profesional Instagram.
Notifikasi Berulang untuk Platform Messenger
Properti notification_messages_frequency
untuk notifikasi berulang permintaan ikut sertatidak berlaku lagi dan tidak akan ditampilkan dalam permintaan GET
atau notifikasi Webhooks. Namun, token pesan notifikasi yang dibuat sebelum 2 Februari 2023 untuk notifikasi berulang mingguan atau bulanan akan didukung dan notification_message_frequency
akan ditampilkan dalam notifikasi Webhooks.
Anda sekarang dapat mengirim hingga tiga pesan tindak lanjut kepada orang yang telah memilih untuk menerima notifikasi berulang. Ketiga pesan tindak lanjut semuanya harus dikirim dalam waktu 2 menit dari pesan tindak lanjut pertama.
Endpoint GET /PAGE-ID/notification_message_tokens
sekarang tersedia untuk Berkirim Pesan di Instagram.
Properti next_eligible_time
untuk endpoint Token Pesan Notifikasi sekarang tersedia. Kolom ini menampilkan waktu ketika Anda dapat mengirim notifikasi berulang berikutnya menggunakan token pesan notifikasi tersebut.
Messenger API untuk Instagram
Anda sekarang dapat mengirim GIF dalam pesan yang dikirimkan dari akun Profesional Instagram menggunakan Messenger API untuk Instagram.
API Unggah Lampiran sekarang mendukung media pengunggahan untuk pesan yang dikirim dari akun Profesional Instagram.
Informasi referensi untuk iklan yang mengeklik percakapan Instagram (CTD) sekarang diberikan dalam notifikasi Webhooks pesan.
Mulai 31 Maret 2023, Anda tidak lagi dapat mengunduh file CVS dari dasbor Analytics Messenger. Kunjungi Messaging Insights API untuk mempelajari cara mendapatkan insight ini.
Login Bisnis untuk Instagram memudahkan Anda untuk onboarding pengguna Instagram yang masih perlu mengonfigurasi akun mereka untuk akses API melalui modal pop up dan langkah-langkah yang lebih sedikit.
Kami telah menindaklanjuti iklan Penciptaan Prospek yang Mengarah ke Messenger agar menjadi lebih mudah melalui:
API Peristiwa Berkirim Pesan mendukung peristiwa lead_submitted
. Bisnis dapat menggunakan peristiwa ini untuk melaporkan pengajuan prospek dari iklan Arahkan ke Messenger. Peristiwa berkirim pesan baru ini dirilis sebagai Beta Terbuka. Pelaporan di Pengelola Iklan akan segera hadir.
Menu Konsisten kini tersedia untuk Berkirim Pesan di Instagram.
Berkirim Pesan di Instagram sekarang mendukung Balasan pribadi untuk komentar di Instagram Live Stories dan postingan iklan. Anda mungkin perlu memperbarui server webhooks Anda untuk menangani kolom baru ini.
Anda sekarang bisa mendapatkan daftar semua Token Pesan Notifikasi yang valid menggunakan endpoint GET /PAGE-ID/notification_message_tokens
.
ID aplikasi tidak akan lagi dikaitkan dengan token pesan notifikasi. Semua aplikasi yang tertaut ke Halaman sekarang akan menerima notifikasi Webhooks ikut serta ketika seseorang telah memilih untuk menerima notifikasi berulang.
Kolom payload lampiran pesan berikut telah ditambahkan:
image_aspect_ratio
– Mengatur gambar ke rasio aspek horizontal atau persegi untuk permintaan ikut sertaelements
– Membuat carousel gambar untuk permintaan ikut sertanotification_message_tokens
– Mendapatkan daftar token pesan notifikasi saat ini notification_messages_cta_text
– Menyesuaikan teks ajakan bertindak untuk permintaan ikut sertaCara-cara berikut telah ditambahkan untuk mendapatkan ikut serta notifikasi berulang:
Kolom title
telah ditambahkan ke Notifikasi Webhooks Notifikasi Berulang.
Balasan Pribadi sekarang tersedia untuk komentar di Instagram Reels.
Anda sekarang dapat mengirim pesan Instagram dengan audio dan video yang telah diunggah ke server Meta atau dikirim dari server Anda.
API Profil Pengguna mendukung pengambilan kolom nama pengguna Instagram dari pelanggan di Graph API v14.0 dan yang lebih baru.
Notifikasi Berulang adalah pembaruan besar ke Messenger API untuk memungkinkan bisnis mengirim pesan proaktif, otomatis yang mendorong interaksi ulang. Notifikasi Berulang membantu bisnis menyampaikan pesan pribadi yang berpusat pada pelanggan di setiap tahap perjalanan pelanggan.
Notifikasi Berulang untuk Messenger API untuk InstagramKami mengumumkan Notifikasi Berulang bagi Messenger API untuk Instagram sebagai versi beta. Develope dapat mendaftar ke daftar minat untuk versi beta sebelum Juli.
Batas Laju API Kirim Instagram bertambahKami telah meningkatkan batas laju untuk API Kirim menjadi 100 panggilan API per detik untuk setiap Akun Profesional Instagram.
parameter rujukan ig.meBisnis dapat menambahkan tautan ig.me di situs web, email, dan kemasan produk untuk memudahkan pengguna memulai percakapan dengan bisnis di Instagram. Kami menambahkan kemampuan merek untuk menambahkan parameter rujukan ke tautan ig.me ini untuk menciptakan pengalaman berkirim pesan yang dipersonalisasi.
Alur Onboarding Baru API InstagramKami mengumumkan alur onboarding baru untuk API Instagram sebagai versi beta. Developer dapat mendaftar untuk daftar minat beta kami sebelum 29 Juni.
Kami telah meluncurkan Menu Persisten untuk dukungan Messenger API untuk Instagram. Ini memungkinkan pengguna untuk menemukan dan berinteraksi dengan fitur utama suatu Halaman.
Sesuai pengumuman tertanggal 14 September 2021, semua halaman Facebook sekarang akan dimigrasikan untuk mendukung perilaku Protokol Serah Terima yang baru. Kami berharap semua Halaman sudah dimigrasi pada tanggal 18 Maret 2022. Baca bagian perubahan sela untuk detail selengkapnya. Berikut adalah ringkasan peningkatan utama yang diumumkan sebelumnya.
Kami membuat peningkatan pada Protokol Serah Terima yang membantu developer dan bisnis meluncurkan pengalaman berkirim pesan (yaitu aplikasi) dengan cepat, mempermudah melewati kontrol percakapan antara aplikasi, dan memastikan terciptanya pengalaman pengguna yang luar biasa dengan melarang aplikasi menyela percakapan yang sedang berlangsung. Peningkatan penting termasuk mode Eksklusif, mode Idle, API baru untuk kontrol yang lebih baik atas kepemilikan utas, dan menghapus persyaratan untuk menetapkan peran utama atau sekunder untuk aplikasi
Kami telah meluncurkan pengaturan penyesuaian Titik Masuk Plugin Obrolan melalui API serta fitur pengaturan pihak pertama kami. Ini akan memberi bisnis opsi untuk memilih ikon poin entri dan labelnya dari serangkaian preset yang paling sesuai dengan pencitraan merek mereka. Untuk detail selengkapnya, lihat dokumentasi developer kami.
Messenger API untuk Instagram kini tersedia untuk jenis akun Kreator Instagram dengan pengikut kurang dari 500 ribu. Lihat detailnya di dokumentasi developer.
https://ig.me/m/{ig_profile_handle}
di situs web, email, dan lainnya. Baca dokumentasi developer untuk detail selengkapnya.Peningkatan Protokol Serah Terima
API Label Khusus—Kami membuat pembaruan menarik untuk API Label Khusus yang memungkinkan bisnis membuat, memperbarui, dan menghapus label serta menyinkronkan label antara Kotak Masuk Halaman Facebook dan apa pun fitur lain yang mungkin digunakan bisnis untuk berkomunikasi dengan pelanggan mereka.
v12.0
+ API Label Khusus name
akan diganti dengan page_label_name
. Perubahan ini akan berlaku pada semua versi lama Graph API mulai 14 Desember 2021. Developer harus memanfaatkan page_label_name
di berbagai panggilan API dan Webhooks CRUD (buat, ambil, perbarui, hapus).Pembaruan Messenger API untuk Eropa dan Jepang—Kami telah memulihkan Template Masukan Pelanggan di Messenger API yang tidak tersedia untuk bisnis di Eropa, dan untuk orang-orang di Eropa dan Jepang yang terhubung dengan bisnis secara global. Detailnya di sini.
Messenger API untuk pembaruan Instagram
Webhooks Tanggapan—Kami telah memperbarui reaksi emoji untuk menampilkan format unicode baru dan mendukung beberapa tanggapan emoji. Buka dokumentasi developer dan migrasikan ke versi baru sebelum 14 Desember 2021 untuk terus mendukung reaksi emoji.
API Profil Pengguna—Kami telah memperbarui API Profil Pengguna untuk menyertakan kolom tambahan yang tersedia untuk umum di aplikasi Instagram. Silakan buka dokumentasi developer untuk detailnya.
Penghentian IGID—API Percakapan tidak akan lagi menampilkan kolom IGID
dan bergantung sepenuhnya pada kolom IGSID
. Lihat dokumentasi developer untuk detail agar dapat bermigrasi sebelum 14 Desember 2021.
API Penyesuaian Plugin Obrolan Facebook—Kami meluncurkan pengaturan penyesuaian Plugin Obrolan melalui API. Dengan rilis baru ini, developer akan dapat mengedit fitur termasuk posisi, warna, salam, pengaturan mode tamu, dll. yang saat ini hanya tersedia menggunakan fitur pihak pertama kami hari ini.
Webhooks Gema Pesan sekarang akan menyertakan ID aplikasi sebagai bagian dari Graph API v12.0
—Saat bisnis menanggapi percakapan Messenger dari Kotak Masuk Halaman Facebook, aplikasi lain yang terhubung ke Halaman dapat mendengarkan Webhooks Gema Pesan. Aplikasi ini akan menerima Webhooks gema dengan ID aplikasi kotak masuk Halaman Facebook (263902037430900
).
Perubahan berikut berlaku untuk v11.0+
Menambahkan <mid>
ke peristiwa messaging_postback
untuk Messenger & Messenger API untuk Instagram Graph API V11.0+—Kami menambahkan kolom ID Pesan (<mid>
) sebagai bagian dari muatan messaging_postback
untuk membantu mengurangi overhead rekayasa bagi partner kami yang harus mengandalkan Conversations API untuk mengambil riwayat percakapan lalu membandingkannya dengan peristiwa Webhooks. Lihat detail selengkapnya di sini.
Template maskapai tidak berlaku lagi—Template maskapai tidak akan didukung lagi mulai Graph API v11. Penghentian penggunaan Graph API versi sebelumnya akan dilakukan 6 bulan setelah pengumuman perubahan ini pada tanggal 6 Desember 2021. Kami rekomendasikan maskapai untuk mengirimkan template Boarding Pass dan Check-in sebagai gambar yang konsisten dengan cara mereka biasanya mengirimkan notifikasi ini di saluran lain.
Messenger API untuk Instagram—Kami telah membuka Messenger API untuk Instagram bagi semua developer yang memungkinkan merek menawarkan pengalaman berkirim pesan di Instagram dalam skala besar. Sekarang, developer dapat menambahkan berkirim pesan di Instagram ke dalam aplikasi mereka dan membangun pengalaman untuk berkirim pesan di Instagram. Developer dapat membantu bisnis menggunakan aplikasi yang berbeda untuk memanfaatkan alur kerja yang ada, mendorong percakapan yang lebih bermakna, meningkatkan kepuasan pelanggan, dan meningkatkan penjualan. Pelajari selengkapnya di sini. Penggunaan Messenger API untuk Instagram harus menaati Kebijakan Developer, khususnya kebijakan yang terdaftar di bawah "Messenger dan API Messaging Instagram", juga dokumentasi teknis.
Tanda pesan Agen Manusia sekarang tersedia untuk semua developer—Tanda ini memungkinkan bisnis untuk menanggapi pesan pengguna di Messenger dan Instagram secara manual di luar periode berkirim pesan standar 24 jam hingga 7 hari. Tanda ini berguna terutama untuk kasus penggunaan seperti penutupan akhir pekan atau untuk pertanyaan yang memerlukan penyelesaian lebih dari 24 jam. Developer harus mengajukan izin tanda Agen Manusia melalui Dasbor Aplikasi meskipun aplikasi Anda sebelumnya telah disetujui untuk tanda pesan Agen Manusia. Navigasikan ke bagian "Izin dan Fitur" di dasbor aplikasi dan ajukan izin "Agen Manusia". Pelajari selengkapnya di sini.
Template Masukan Pelanggankini tersedia sebagai Beta—Kami meluncurkan template native dalam Messenger yang mendukung format survei umum seperti CSAT (Customer Satisfaction), NPS (Net Promoter Score), CES (Customer Effort Score), dan teks formulir bebas. Template native lebih mudah untuk diintegrasikan karena dibuat di API Kirim, menghilangkan kebutuhan untuk membangun solusi survei khusus menggunakan Tampilan web dan memudahkan developer untuk mengumpulkan skor di seluruh saluran yang menggunakan format survei serupa. Pelajari selengkapnya di sini.