Log masukMulakan percubaan percuma
easyCoexistence API rasmi

API profil Messenger: ucapan, butang Get Started, ice breakers dan menu kekal

Profil Messenger Halaman Facebook ditetapkan melalui /{page-id}/messenger_profile dengan token akses Halaman dan pages_messaging: POST menulis sifat seperti get_started, greeting, ice_breakers, persistent_menu dan commands, GET membaca sifat-sifat itu dengan fields, dan DELETE memadam sifat yang dinyatakan dalam tatasusunan fields. Meta membenarkan 10 panggilan setiap 10 minit bagi setiap Halaman, dan hanya sifat yang dihantar akan ditimpa.

easyCoexistence membalas perbualan Messenger sebuah Halaman dengan send_social_dm dalam tetingkap 24 jam, daripada Claude, ChatGPT atau kod anda sendiri, dengan mesej baharu diteruskan ke titik akhir anda sebaik tiba.

10 per 10 min

Bilangan panggilan API Profil Messenger yang dibenarkan bagi setiap Halaman dalam setiap selang 10 minit.

4 questions

Bilangan maksimum ice breakers yang ditetapkan oleh API; apabila kedua-duanya ditetapkan, ice breakers API didahulukan daripada butang Get Started.

20 items

Bilangan maksimum item peringkat atas dalam menu kekal; tajuk setiap item terhad kepada 30 aksara.

24 hours

Tempoh kemas kini menu kekal peringkat Halaman boleh mengambil masa; menu yang ditetapkan untuk seorang pengguna dikemas kini secara masa nyata.

Deprecated

Teks ucapan alu-aluan, yang menurut rujukan greeting Meta tidak lagi berfungsi pada Messenger untuk Android dan iOS.

Apakah yang terkandung dalam profil Messenger?

Tetapan yang menjadi permulaan pengalaman Messenger sesebuah Halaman. API Profil Messenger Meta menyenaraikan sifat-sifat ini, setiap satu ditetapkan dan dibaca pada titik akhir yang sama; bagi aplikasi dalam Mod Pembangunan, tetapan itu hanya kelihatan kepada orang yang mempunyai peranan pada aplikasi:

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 sifat dibaca, ditetapkan dan dipadam?

Dengan tiga kaedah pada satu titik akhir, dipanggil dengan token Halaman. POST menerima badan JSON bagi sifat dan hanya menimpa sifat yang dinyatakan, GET menerima fields sebagai senarai dipisahkan koma, dan DELETE menerima badan JSON yang tatasusunan fields-nya menamakan perkara yang hendak dipadam; POST dan DELETE membalas dengan result success. Menetapkan butang 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 butang Get Started berfungsi?

Ia terletak pada skrin alu-aluan, yang memaparkan nama Halaman, gambar profil dan foto muka depan serta tempoh biasanya perniagaan mengambil masa untuk membalas. Apabila diketik, Get Started dihantar ke dalam perbualan, get_started.payload dihantar kepada aplikasi sebagai acara messaging_postbacks dan tetingkap mesej standard dibuka. Meta menyatakan butang ini tidak disokong apabila Messenger dijalankan dalam pelayar dalam aplikasi Facebook, dan menu kekal perlu ditetapkan dahulu.

Adakah teks ucapan masih berfungsi?

Tidak pada telefon. Rujukan Meta kini bertajuk [Deprecated] Greeting Text: ciri ini tidak lagi berfungsi pada Messenger untuk Android dan iOS, dan walaupun API mungkin masih menerima sifat greeting, pelanggan tidak akan melihatnya, justeru Meta meminta pembangun mengelakkannya. Seperti yang didokumenkan, greeting menyimpan satu teks bagi setiap lokal, dengan default diwajibkan, sehingga 160 aksara, diperibadikan dengan {{user_first_name}}, {{user_last_name}} atau {{user_full_name}}, dan penetapannya memerlukan peranan Administrator pada Halaman.

Bagaimana ice breakers berfungsi?

Ia menyenaraikan sehingga 4 soalan yang boleh diketik oleh pengguna untuk membuka perbualan; soalan itu dihantar dalam perbualan seolah-olah pengguna itu yang bertanya, dan payload-nya kembali sebagai acara postback. Sejak April 2022 ia diselaraskan mengikut lokal: setiap objek dalam ice_breakers memegang call_to_actions dan locale, lokal lalai diwajibkan, dan DELETE bagi ice_breakers memadam semuanya. Meta menyusun kedudukan elemen yang bersaing untuk perbualan baharu:

  • Ice breakers API didahulukan daripada butang Get Started apabila kedua-duanya ditetapkan.
  • Kedua-duanya didahulukan sebelum soalan tersuai yang ditetapkan dalam peti masuk Halaman, yang penyuntingannya dilumpuhkan semasa ice breakers API ditetapkan.

Bagaimana menu kekal dibina?

Sebagai tatasusunan menu, satu bagi setiap lokal dengan default diwajibkan, masing-masing memegang sehingga 20 call_to_actions berjenis web_url atau postback. Tajuk menerima sehingga 30 aksara dan payload postback sehingga 1,000, dan composer_input_disabled ditetapkan kepada true menjadikan menu, butang dan webview sebagai satu-satunya cara untuk berinteraksi. Keperluan Meta sebelum ia muncul:

  • Butang Get Started sudah ditetapkan, dan kebenaran pages_messaging.
  • Halaman yang diterbitkan, dan aplikasi ditetapkan kepada awam.
  • Peranan Administrator pada Halaman bagi sesiapa yang menetapkannya.
  • Messenger v106 atau lebih baharu pada iOS atau Android, di luar pelayar dalam aplikasi Facebook.
  • Perubahan peringkat Halaman boleh mengambil masa sehingga 24 jam; menu bagi seorang pengguna, yang ditetapkan melalui custom_user_settings dengan PSID, dikemas kini secara masa nyata.

Apakah arahan?

Kata kunci yang boleh dipanggil oleh pengguna pada bila-bila masa, daripada menu arahan di sebelah komposer, dengan menaip tanda sengkang ke hadapan atau simbol @, atau daripada tetingkap timbul apabila mereka menaip perkataan yang sepadan. Setiap lokal memegang 1 hingga 100 arahan, dengan nama 1 hingga 32 aksara tanpa garis miring di hadapan dan penerangan 1 hingga 64; apabila arahan ditetapkan, ia didahulukan berbanding menu kekal. Arahan yang dipanggil sampai ke aplikasi dalam acara messages, dalam message.commands.

Apakah fungsi whitelisted_domains dan account_linking_url?

Kedua-duanya berkhidmat untuk pengalaman di luar perbualan itu sendiri. whitelisted_domains menyenaraikan sehingga 50 domain yang boleh dibuka oleh webview Messenger untuk SDK Messenger Extensions dan plugin kotak semak, setiap satu dilayan melalui HTTPS di bawah nama yang layak sepenuhnya, tidak sekali-kali alamat IP atau localhost, dan penetapannya memerlukan peranan Administrator pada Halaman. account_linking_url ialah panggilan balik HTTPS yang memautkan akaun Messenger seseorang kepada akaunnya dengan perniagaan.

Bagaimana easyCoexistence menetapkan profil Messenger Halaman?

Ia tidak: tiada alat yang memanggil {page-id}/messenger_profile, dan token Halaman tidak diberikan, jadi menetapkan profil berada di luar sambungan ini. Arahan yang dipanggil pengguna tiba dalam acara messages yang diteruskan oleh easyCoexistence dan dibaca oleh automasi; ketukan yang dilaporkan Meta sebagai acara messaging_postbacks, daripada Get Started, item menu postback dan ice breakers, tidak diteruskan, kerana Halaman dilanggan kepada feed, messages dan mention.

Kesilapan biasa

  • Menetapkan menu kekal sebelum Get Started. Keperluan Meta termasuk butang Get Started, jadi tetapkan get_started dahulu.
  • Tidak menyertakan lokal lalai. Ice breakers, menu dan arahan masing-masing memerlukan objek dengan locale ditetapkan kepada default sebagai cadangan.
  • Memanggil API profil dalam gelung. Meta membenarkan 10 panggilan setiap 10 minit bagi setiap Halaman, jadi letakkan beberapa sifat dalam satu POST.
  • Menjangka perubahan menu serta-merta. Kemas kini menu peringkat Halaman boleh mengambil masa sehingga 24 jam untuk sampai kepada pengguna.
Menggunakan EasyCoexistence untuk ini

Menetapkan profil Messenger tidak termasuk dalam alatnya. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Bolehkah menu kekal berbeza bagi setiap pengguna?

Boleh. custom_user_settings dengan PSID pengguna menggantikan menu Halaman bagi pengguna itu, dikemas kini secara masa nyata dan membenarkan 10 panggilan bagi setiap pengguna dalam 10 minit.

Lokal manakah yang disokong oleh profil Messenger?

Yang tersenarai dalam senarai lokal yang disokong Meta, seperti en_GB, pt_BR atau ja_JP, serta default, cadangan yang digunakan apabila tiada lokal sepadan dengan pengguna.

Siapakah yang boleh menukar profil Messenger sesebuah Halaman?

Aplikasi dengan token Halaman yang membawa pages_messaging. Menu kekal, ucapan alu-aluan dan senarai domain turut memerlukan peranan Administrator pada Halaman.

Berapakah kos easyCoexistence untuk Halaman Facebook?

Setiap Halaman ialah satu sambungan: US$ 9 hingga US$ 0.75 setiap sambungan sebulan, harga menurun apabila bilangan sambungan anda bertambah, dan 3 hari pertama percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada