Instagram messaging_postbacks webhook: ice breakers at buttons
Nagno-notify ang webhook field na messaging_postbacks ng Instagram sa isang app kapag may taong nag-tap ng ice breaker question, postback button sa template, o persistent menu item sa usapan sa isang professional account. Ang postback object ng event ay may dalang title, ang text na na-tap ng tao; payload, ang string na itinakda ng app para sa option na iyon; at mid, ang ID ng mensahe, mula sa Graph API v11.0.
Nagsa-subscribe ang easyCoexistence sa bawat naka-connect na Instagram account sa comments, messages at mentions, at ipinapasa ang mga event na iyon, kasama ang quick reply tap, sa inyong HTTPS endpoint habang dumarating ang mga ito, nilagdaan ng secret ng account na iyon at walang kopyang itinatabi.
Karamihan sa mga ice breaker question na maaaring itakda ng account sa pamamagitan ng Ice Breaker API ng Meta.
Graph API version kung saan kasama na ang mid sa postback events; ang field mismo ay nangangailangan ng v8.0 o mas bago.
Karamihan sa mga button sa isang button template na mensahe, na bawat isa ay postback o web_url button.
Oras para sumagot pagkatapos i-tap ng tao ang persistent menu item, na nagbubukas ng karaniwang conversation window.
Karamihan sa quick reply na maaaring ialok ng isang mensahe; ang na-tap na quick reply ay dumarating sa messages, hindi sa messaging_postbacks.
Kailan nagfa-fire ang messaging_postbacks?
Kapag may taong nag-tap ng isa sa mga structured option ng account sa isang usapan, kapag naka-subscribe na ang app at ang account sa field. Inililista ng mga gabay ng Meta ang mga sumusunod na pinagmumulan:
- Ice breaker question, isa sa hanggang 4 na iniaalok ng account kapag nagsimula ang usapan. Hindi available sa desktop.
- Postback button sa button template, hanggang 3 bawat mensahe, o sa generic template, hanggang 3 bawat element.
- Postback item sa persistent menu ng account.
- Ice breaker na na-tap sa bagong usapan na nabuksan mula sa ig.me link na may ref parameter: dala na rin ng postback ang referral.
- Self-messaging test, kung saan tina-tap ng account ang sarili nitong button: idinadagdag ng event ang
is_selfna nakatakda sa true.
Ano ang hitsura ng postback notification?
Isang messaging event na may postback object sa lugar ng mensahe na karaniwang dala ng DM. Ang halimbawa ng Meta para sa Instagram Login ay may dalang mid, title at payload, at ipinapakita naman ng ice breaker guide nito ang parehong object nang walang mid. Ganito ang hitsura ng notification:
{
"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>"
}
}
]
}
]
}Ano ang ibig sabihin ng bawat field?
Ang mga field na dokumentado ng Meta para sa postback, mula sa labas papasok:
- sender.id: ang Instagram-scoped ID ng taong nag-tap, ang ID na dapat sagutin. recipient.id at entry[].id: ang professional account.
- timestamp: kailan nag-tap ang tao, ayon sa ice breaker guide ng Meta.
- postback.title: ang tanong ng ice breaker o ang title ng button na nakita ng tao.
- postback.payload: ang string na itinakda para sa option na iyon noong ginawa ito, pinili ng app.
- postback.mid: ang ID ng mensahe na ipinadala ng tap sa account, mula sa Graph API v11.0.
- postback.referral: ref, source at type, kapag nabuksan ang usapan mula sa ig.me link na may ref parameter.
is_self: nakatakda sa true, sa tabi ng postback, kapag tina-tap ng account ang sarili nitong button sa self-messaging test.
Paano itinatakda ang ice breakers?
Gamit ang POST /<IG_ID>/messenger_profile sa graph.instagram.com: platform na nakatakda sa instagram at isang ice_breakers array na ang call_to_actions ay may hanggang 4 na pares ng question at payload, na may locale para sa bawat isinaling set. Inililista ito ng GET /me/messenger_profile?fields=ice_breakers, at inaalis naman ng DELETE na may fields na nakatakda sa ice_breakers. Ang payload na pinili rito ang ibinabalik ng messaging_postbacks kapag na-tap ang tanong.
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>" }
]
}
]
}Paano ipinapadala ang mga postback button?
Sa loob ng mensaheng ipinapadala ng account gamit ang POST /<IG_ID>/messages. Ang button template ay may text na hanggang 640 characters at 1 hanggang 3 button; ang generic template naman ay may hanggang 10 element, na bawat isa ay may hanggang 3 button. Ang button na uri ng postback ay ibinabalik ang payload nito sa messaging_postbacks kapag na-tap, samantalang ang web_url button ay nagbubukas ng page sa in-app browser. Ang persistent menu, na itinakda sa messenger_profile, ay tumatanggap ng parehong dalawang uri.
Gumagamit ba ng messaging_postbacks ang quick replies?
Hindi: dumarating ang mga ito sa messages. Ang na-tap na quick reply ay ipinopost ang title nito sa usapan bilang mensahe, at ang messages event ay may dalang text na nakatakda sa title na iyon at quick_reply.payload na nakatakda sa payload ng option. Ang isang mensahe ay maaaring mag-alok ng hanggang 13 quick reply na may hanggang 20 characters bawat isa, plain text lamang. Kasama rin sa listahan ng Meta sa Instagram Messaging guide ang mga pagpipiliang ice breaker at generic template sa mga iniuulat ng messages, pero walang halimbawang payload.
Nagbubukas ba ng conversation window ang isang tap?
Para sa persistent menu, sinasabi ito ng Meta: ang tap sa menu item ay nagbubukas ng karaniwang conversation window, at may 24 na oras ang account para sumagot. Sumagot gamit ang POST /<IG_ID>/messages at recipient.id na nakatakda sa sender.id ng postback. Ang sagot ng account ay bumabalik sa messages bilang echo, na may is_echo na nakatakda sa true.
Ipinapasa ba ng easyCoexistence ang mga postback?
Quick reply tap lamang. Dumarating ang mga ito sa messages, na naka-subscribe ang app ng easyCoexistence at ang bawat naka-connect na account, kaya umaabot ang mga ito sa inyong endpoint kasama ang quick_reply.payload. Ang mga tap sa ice breaker, button at menu ay dumarating sa messaging_postbacks, na hindi naka-subscribe ang easyCoexistence, kaya hindi ito ipinapasa.
Mga karaniwang pagkakamali
- Paghihintay ng quick reply sa messaging_postbacks. Dumarating ang quick reply sa messages, kasama ang quick_reply.payload sa tabi ng text ng option na na-tap.
- Pag-route batay sa postback.title. Ang title ay ang nakita ng tao at maaaring mag-iba ayon sa locale; mag-route batay sa payload, na itinakda ng app.
- Pag-asa sa mid sa mas lumang API version. Kasama ng Meta ang postback.mid mula sa Graph API v11.0 lamang.
- Pagtatakda ng higit sa 4 na ice breaker, o pagsubok sa mga ito sa desktop. Ang Ice Breaker API ng Meta ay tumatanggap ng hanggang 4 na tanong, at hindi available ang feature sa desktop.
Sumasagot ang send_social_dm sa tao sa loob ng 24-hour window. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumadagdag ng koneksyon, na may unang 3 araw na free trial.
Mga madalas itanong
Aling webhook field ang nag-uulat ng mga tap sa Instagram ice breaker?
messaging_postbacks. Dala ng postback object ang tanong bilang title at ang payload na itinakda para dito, pati ang mid mula sa Graph API v11.0.
Ilang ice breaker ang maaaring magkaroon ng isang Instagram account?
Hanggang 4 na tanong, itinakda gamit ang POST /<IG_ID>/messenger_profile at platform na nakatakda sa instagram, opsyonal kada locale.
Paano sumasagot sa Instagram postback?
Gamit ang POST /<IG_ID>/messages at recipient.id na nakatakda sa sender.id ng postback, ang Instagram-scoped ID ng taong nag-tap. Pagkatapos ng tap sa persistent menu, may 24 na oras ang account para sumagot ayon sa Meta.
Dapat bang i-route ang Instagram postback batay sa title o payload?
Batay sa payload, ang string na itinakda ng app para sa option. Ang title ang text na nakita ng tao, at maaaring mag-iba ayon sa locale.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong