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.
Bilangan panggilan API Profil Messenger yang dibenarkan bagi setiap Halaman dalam setiap selang 10 minit.
Bilangan maksimum ice breakers yang ditetapkan oleh API; apabila kedua-duanya ditetapkan, ice breakers API didahulukan daripada butang Get Started.
Bilangan maksimum item peringkat atas dalam menu kekal; tajuk setiap item terhad kepada 30 aksara.
Tempoh kemas kini menu kekal peringkat Halaman boleh mengambil masa; menu yang ditetapkan untuk seorang pengguna dikemas kini secara masa nyata.
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:
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:
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_settingsdengan 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.
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