Webhook messaging_postbacks Instagram: pemecah ais dan butang
Medan webhook messaging_postbacks Instagram memberitahu aplikasi apabila seseorang mengetik soalan pemecah ais, butang postback dalam templat, atau item menu kekal dalam perbualan dengan akaun profesional. Objek postback bagi acara itu membawa title, teks yang diketik oleh orang tersebut; payload, rentetan yang ditetapkan aplikasi untuk pilihan itu; dan mid, ID mesej, daripada Graph API v11.0.
easyCoexistence melanggan setiap akaun Instagram yang disambungkan kepada komen, mesej dan sebutan, lalu memajukan acara itu, termasuk ketikan balasan pantas, ke endpoint HTTPS anda sebaik sahaja ia tiba, ditandatangani dengan rahsia akaun itu dan tanpa sebarang salinan disimpan.
Kebanyakan soalan pemecah ais yang boleh ditetapkan oleh akaun melalui Ice Breaker API Meta.
Versi Graph API ketika acara postback mula menyertakan mid; medan itu sendiri memerlukan v8.0 atau lebih baharu.
Kebanyakan butang dalam mesej templat butang, setiap satu sama ada butang postback atau web_url.
Masa untuk membalas selepas seseorang mengetik item menu kekal, yang membuka tetingkap mesej standard.
Kebanyakan balasan pantas yang ditawarkan satu mesej; balasan pantas yang diketik tiba pada messages, bukan messaging_postbacks.
Bilakah messaging_postbacks dicetuskan?
Apabila seseorang mengetik salah satu pilihan berstruktur akaun dalam perbualan, sebaik sahaja aplikasi dan akaun itu melanggan medan tersebut. Panduan Meta menyenaraikan sumber berikut:
- Soalan pemecah ais, salah satu daripada sehingga 4 yang ditawarkan akaun apabila perbualan bermula. Tidak tersedia pada desktop.
- Butang postback dalam templat butang, sehingga 3 setiap mesej, atau dalam templat generik, sehingga 3 setiap elemen.
- Item postback dalam menu kekal akaun.
- Pemecah ais yang diketik dalam perbualan baharu yang dibuka daripada pautan ig.me dengan parameter ref: postback kemudian turut membawa referral.
- Ujian mesej kendiri, apabila akaun mengetik butangnya sendiri: acara itu menambah
is_selfyang ditetapkan kepada true.
Bagaimana rupa notifikasi postback?
Acara mesej dengan objek postback berada di tempat DM akan mempunyai mesejnya. Contoh Meta untuk Instagram Login membawa mid, title dan payload, dan panduan pemecah aisnya menunjukkan objek yang sama tanpa mid. Notifikasi kelihatan seperti ini:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"postback": {
"mid": "<MESSAGE_ID>",
"title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
"payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
}
}
]
}
]
}Apakah maksud setiap medan?
Medan yang didokumenkan Meta untuk postback, dari luar ke dalam:
- sender.id: ID bercakupan Instagram bagi orang yang mengetik, iaitu ID untuk dibalas. recipient.id dan entry[].id: akaun profesional.
- timestamp: bila orang itu mengetik, mengikut panduan pemecah ais Meta.
- postback.title: soalan pemecah ais atau tajuk butang yang dilihat oleh orang itu.
- postback.payload: rentetan yang ditetapkan untuk pilihan itu semasa ia dicipta, dipilih oleh aplikasi.
- postback.mid: ID mesej yang dihantar ketikan itu kepada akaun, daripada Graph API v11.0.
- postback.referral: ref, source dan type, apabila perbualan dibuka daripada pautan ig.me dengan parameter ref.
is_self: ditetapkan kepada true, bersebelahan postback, apabila akaun mengetik butangnya sendiri dalam ujian mesej kendiri.
Bagaimana pemecah ais ditetapkan?
Dengan POST /<IG_ID>/messenger_profile pada graph.instagram.com: platform ditetapkan kepada instagram dan tatasusunan ice_breakers yang call_to_actions memegang sehingga 4 pasangan soalan dan payload, dengan locale untuk setiap set yang diterjemahkan. GET /me/messenger_profile?fields=ice_breakers menyenaraikannya, dan DELETE dengan fields ditetapkan kepada ice_breakers memadamkannya. Payload yang dipilih di sini ialah apa yang dipulangkan messaging_postbacks apabila soalan diketik.
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"platform": "instagram",
"ice_breakers": [
{
"call_to_actions": [
{ "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
{ "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
]
}
]
}Bagaimana butang postback dihantar?
Di dalam mesej yang dihantar akaun dengan POST /<IG_ID>/messages. Mesej templat butang membawa text sehingga 640 aksara dan 1 hingga 3 butang; templat generik membawa sehingga 10 elemen, setiap satu dengan sehingga 3 butang. Butang jenis postback memulangkan payload-nya pada messaging_postbacks apabila diketik, manakala butang web_url membuka halaman dalam pelayar dalam aplikasi. Menu kekal, yang ditetapkan pada messenger_profile, menerima kedua-dua jenis ini.
Adakah balasan pantas menggunakan messaging_postbacks?
Tidak: ia tiba pada messages. Balasan pantas yang diketik memasukkan tajuknya ke dalam perbualan sebagai mesej, dan acara messages membawa text yang ditetapkan kepada tajuk itu serta quick_reply.payload yang ditetapkan kepada payload pilihan itu. Satu mesej boleh menawarkan sehingga 13 balasan pantas, setiap satu sehingga 20 aksara, teks biasa sahaja. Panduan Meta Instagram Messaging juga menyenaraikan pemilihan pemecah ais dan templat generik antara perkara yang dilaporkan messages, tanpa contoh payload.
Adakah ketikan membuka tetingkap mesej?
Bagi menu kekal, Meta menyatakannya: ketikan pada item menu membuka tetingkap mesej standard, dan akaun mempunyai 24 jam untuk membalas. Balas dengan POST /<IG_ID>/messages dan recipient.id ditetapkan kepada sender.id postback itu. Balasan akaun kembali pada messages sebagai echo, dengan is_echo ditetapkan kepada true.
Adakah easyCoexistence memajukan postback?
Hanya ketikan balasan pantas. Ia tiba pada messages, yang dilanggan oleh aplikasi easyCoexistence dan setiap akaun yang disambungkan, jadi ia sampai ke endpoint anda dengan quick_reply.payload. Ketikan pemecah ais, butang dan menu tiba pada messaging_postbacks, yang tidak dilanggan oleh easyCoexistence, jadi ia tidak dimajukan.
Kesilapan biasa
- Menunggu balasan pantas pada messaging_postbacks. Balasan pantas tiba pada messages, dengan quick_reply.payload di sebelah teks pilihan yang diketik.
- Penghalaan mengikut postback.title. Tajuk ialah apa yang dilihat orang itu dan boleh berbeza mengikut locale; halakan mengikut payload, yang ditetapkan aplikasi.
- Menjangka mid pada versi API lama. Meta menyertakan postback.mid daripada Graph API v11.0 sahaja.
- Menetapkan lebih daripada 4 pemecah ais, atau mengujinya pada desktop. Ice Breaker API Meta menerima sehingga 4 soalan, dan ciri itu tidak tersedia pada desktop.
send_social_dm menjawab orang itu dalam tetingkap 24 jam. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.
Soalan lazim
Medan webhook yang mana melaporkan ketikan pemecah ais Instagram?
messaging_postbacks. Objek postback membawa soalan sebagai title dan payload yang ditetapkan untuknya, serta mid daripada Graph API v11.0.
Berapa banyak pemecah ais yang boleh dimiliki akaun Instagram?
Sehingga 4 soalan, ditetapkan dengan POST /<IG_ID>/messenger_profile dan platform ditetapkan kepada instagram, secara pilihan mengikut locale.
Bagaimana saya membalas postback Instagram?
Dengan POST /<IG_ID>/messages dan recipient.id ditetapkan kepada sender.id postback itu, ID bercakupan Instagram bagi orang yang mengetik. Selepas ketikan menu kekal, Meta memberi akaun 24 jam untuk membalas.
Patutkah saya menghalakan postback Instagram mengikut title atau payload?
Mengikut payload, rentetan yang ditetapkan aplikasi untuk pilihan itu. title ialah teks yang dilihat orang itu, yang boleh berbeza mengikut locale.
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