MasukMulai uji coba gratis
easyCoexistence API resmi

API profil Messenger: sapaan, tombol Get Started, ice breakers dan menu persisten

Profil Messenger sebuah Halaman Facebook diatur melalui /{page-id}/messenger_profile dengan token Halaman dan izin pages_messaging: POST menulis properti seperti get_started, greeting, ice_breakers, persistent_menu dan commands, GET membaca dengan fields, dan DELETE menghapus properti yang disebut dalam array fields. Meta mengizinkan 10 panggilan per 10 menit per Halaman, dan hanya properti yang dikirim yang ditimpa.

easyCoexistence membalas percakapan Messenger sebuah Halaman dengan send_social_dm dalam jendela 24 jam, dari Claude, ChatGPT, atau kode Anda sendiri, dengan pesan baru diteruskan ke endpoint Anda saat masuk.

10 per 10 min

Jumlah panggilan API Profil Messenger yang diizinkan per Halaman dalam setiap interval 10 menit.

4 questions

Jumlah maksimal ice breakers yang diatur API; jika keduanya diatur, ice breakers API didahulukan atas tombol Get Started.

20 items

Jumlah maksimal item tingkat atas dalam menu persisten; judul setiap item dibatasi 30 karakter.

24 hours

Berapa lama pembaruan menu persisten tingkat Halaman bisa memakan waktu; menu yang diatur untuk satu orang diperbarui secara real time.

Deprecated

Teks sapaan, yang menurut referensi sapaan Meta tidak lagi berfungsi di Messenger untuk Android dan iOS.

Apa yang dimuat profil Messenger?

Pengaturan yang menjadi titik awal pengalaman Messenger sebuah Halaman. API Profil Messenger milik Meta mencantumkan properti-properti ini, masing-masing diatur dan dibaca pada endpoint yang sama; untuk aplikasi dalam Development Mode, pengaturan hanya terlihat oleh orang yang memiliki peran di aplikasi tersebut:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

Bagaimana properti dibaca, diatur, dan dihapus?

Dengan tiga metode pada satu endpoint, dipanggil dengan token Halaman. POST menerima body JSON berisi properti dan hanya menimpa yang disebutkan, GET menerima fields sebagai daftar dipisahkan koma, dan DELETE menerima body JSON yang array fields-nya menyebutkan apa yang dihapus; POST dan DELETE menjawab dengan result success. Contoh mengatur tombol Get Started dan menu dalam satu panggilan:

Get Started and a persistent menu in one POST
POST /{page-id}/messenger_profile
{
  "get_started": { "payload": "GET_STARTED" },
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        { "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
        { "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
      ]
    }
  ]
}

{ "result": "success" }

Bagaimana tombol Get Started bekerja?

Tombol ini berada di layar sambutan, yang menampilkan nama Halaman, foto profil, foto sampul, dan perkiraan waktu rata-rata bisnis membalas. Saat diketuk, Get Started dikirim ke percakapan, mengirim get_started.payload ke aplikasi sebagai event messaging_postbacks, dan membuka jendela pesan standar. Meta mencatat tombol ini tidak didukung saat Messenger berjalan di browser dalam aplikasi Facebook, dan menu persisten memerlukan tombol ini diatur lebih dulu.

Apakah teks sapaan masih berfungsi?

Tidak di ponsel. Referensi Meta kini berjudul [Deprecated] Greeting Text: fitur ini tidak lagi berfungsi di Messenger untuk Android dan iOS, dan meskipun API mungkin masih menerima properti greeting, pelanggan tidak akan melihatnya, sehingga Meta meminta pengembang untuk menghindarinya. Sesuai dokumentasi, greeting berisi satu teks per locale, dengan default wajib, hingga 160 karakter, dipersonalisasi dengan {{user_first_name}}, {{user_last_name}}, atau {{user_full_name}}, dan mengaturnya memerlukan peran Administrator di Halaman.

Bagaimana ice breakers bekerja?

Ice breakers berisi hingga 4 pertanyaan yang bisa diketuk orang untuk membuka percakapan; pertanyaan dikirim ke thread seolah-olah orang tersebut yang menanyakannya, dan payload-nya kembali sebagai event postback. Sejak April 2022 ice breakers dilokalisasi: setiap objek dalam ice_breakers berisi call_to_actions dan locale, locale default wajib ada, dan DELETE pada ice_breakers menghapus semuanya. Meta mengurutkan elemen yang bersaing untuk percakapan baru:

  • Ice breakers API didahulukan atas tombol Get Started jika keduanya diatur.
  • Keduanya didahulukan sebelum pertanyaan kustom yang diatur di kotak masuk Halaman, yang penyuntingannya dinonaktifkan selama ice breakers API diatur.

Bagaimana menu persisten dibangun?

Sebagai array menu, satu per locale dengan default wajib, masing-masing berisi hingga 20 call_to_actions bertipe web_url atau postback. Judul dibatasi 30 karakter dan payload postback hingga 1.000, dan composer_input_disabled yang diatur ke true membuat menu, tombol, dan webview menjadi satu-satunya cara berinteraksi. Syarat Meta sebelum menu muncul:

  • Tombol Get Started sudah diatur, dan izin pages_messaging ada.
  • Halaman sudah dipublikasikan, dan aplikasi diatur ke publik.
  • Peran Administrator di Halaman bagi siapa pun yang mengaturnya.
  • Messenger v106 atau lebih baru di iOS atau Android, di luar browser dalam aplikasi Facebook.
  • Perubahan tingkat Halaman bisa memakan waktu hingga 24 jam; menu untuk satu orang, diatur melalui custom_user_settings dengan PSID, diperbarui secara real time.

Apa itu perintah?

Kata kunci yang bisa dipanggil orang kapan saja, dari menu perintah di samping kolom tulis, dengan mengetik garis miring atau tanda @, atau dari popover saat mereka mengetik kata yang cocok. Setiap locale berisi 1 hingga 100 perintah, dengan nama 1 hingga 32 karakter tanpa garis miring di depan dan deskripsi 1 hingga 64 karakter; saat perintah diatur, perintah didahulukan atas menu persisten. Perintah yang dipanggil sampai ke aplikasi di dalam event messages, di message.commands.

Apa fungsi whitelisted_domains dan account_linking_url?

Keduanya melayani pengalaman di luar percakapan itu sendiri. whitelisted_domains mencantumkan hingga 50 domain yang boleh dibuka webview Messenger untuk Messenger Extensions SDK dan plugin checkbox, masing-masing disajikan melalui HTTPS dengan nama domain lengkap, tidak pernah alamat IP atau localhost, dan mengaturnya memerlukan peran Administrator di Halaman. account_linking_url adalah callback HTTPS yang menautkan akun Messenger seseorang dengan akunnya pada bisnis tersebut.

Bagaimana easyCoexistence mengatur profil Messenger sebuah Halaman?

Tidak: tidak ada alat yang memanggil {page-id}/messenger_profile, dan token Halaman tidak diberikan, sehingga pengaturan profil berada di luar koneksi ini. Perintah yang dipanggil orang tiba di event messages yang diteruskan easyCoexistence dan dibaca oleh otomasi; ketukan yang dilaporkan Meta sebagai event messaging_postbacks, dari Get Started, item menu postback, dan ice breakers, tidak diteruskan, karena Halaman berlangganan ke feed, messages, dan mention.

Kesalahan umum

  • Mengatur menu persisten sebelum Get Started. Syarat Meta mencakup tombol Get Started, jadi atur get_started lebih dulu.
  • Melewatkan locale default. Ice breakers, menu, dan perintah masing-masing memerlukan objek dengan locale diatur ke default sebagai acuan cadangan.
  • Memanggil API profil dalam loop. Meta mengizinkan 10 panggilan per 10 menit per Halaman, jadi gabungkan beberapa properti dalam satu POST.
  • Berharap perubahan menu langsung terlihat. Pembaruan menu tingkat Halaman bisa memakan waktu hingga 24 jam untuk sampai ke orang-orang.
Melakukan ini dengan EasyCoexistence

Mengatur profil Messenger tidak termasuk dalam alatnya. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah menu persisten berbeda untuk tiap orang?

Bisa. custom_user_settings dengan PSID orang tersebut menimpa menu Halaman untuk orang itu, diperbarui secara real time, dan mengizinkan 10 panggilan per orang dalam 10 menit.

Locale apa saja yang didukung profil Messenger?

Yang ada dalam daftar locale yang didukung Meta, seperti en_GB, pt_BR, atau ja_JP, ditambah default, acuan cadangan yang dipakai saat tidak ada locale yang cocok dengan orang tersebut.

Siapa yang bisa mengubah profil Messenger sebuah Halaman?

Aplikasi dengan token Halaman yang membawa pages_messaging. Menu persisten, sapaan, dan daftar domain juga memerlukan peran Administrator di Halaman.

Berapa biaya easyCoexistence untuk Halaman Facebook?

Setiap Halaman adalah satu koneksi: US$ 9 hingga US$ 0.75 per koneksi per bulan, harga turun seiring bertambahnya jumlah koneksi Anda, dan 3 hari pertama gratis.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada