Instagram webhook events: comments, mentions at DMs
Iniuulat ng Instagram webhook events ang aktibidad sa professional account habang nangyayari: bagong comments, @mentions, at DMs. Ipinapadala ng Meta ang bawat isa bilang JSON sa HTTPS endpoint ng naka-connect na app, at muling sinusubukan ng Meta ang nabigong delivery dito nang hanggang 36 na oras. Ipinapasa ng easyCoexistence ang bawat event sa endpoint ninyo nang isang beses, pinipirmahan bawat account, nang walang retry. Sa Instagram Login, nasa loob ng comments notification ang mentions.
Gaano katagal sinusubukang muli ng Meta ang nabigong delivery sa endpoint ng app bago ito itapon.
Karamihan ng update ay pinagsasama ng Meta sa isang webhook delivery, bagaman hindi ito ginagarantiya.
Flag na itinatakda ng Meta sa mga event ng mensahe na ipinadala ng account mismo.
Ang media sa public accounts lamang ang nagti-trigger ng comment at mention notifications.
Anong mga event ang mayroon?
Para sa professional account na naka-connect gamit ang Instagram Login, tatlong uri ng aktibidad ang dumarating bilang events:
- Comments: bagong comment sa media ng account, kasama ang comment ID, Instagram-scoped ID at username ng author, ang text, at ang media ID at type.
- Mentions: sa Instagram Login, nasa loob ng comments notification ang mga ito at hindi bilang sariling field.
- Mensahe: DM sa account, kasama ang sender, recipient, timestamp, at mismong mensahe, kabilang ang text, attachment, at Story replies.
Paano nakakarating sa endpoint ninyo ang mga event?
Ipinapadala ng Meta ang Instagram webhooks sa app na ikinonekta ng account. Tinatanggap ito ng easyCoexistence at ipinapasa ang bawat isa sa HTTPS endpoint na itinakda ninyo para sa account na iyon, habang dumarating, at pinipirmahan ng secret para sa account na iyon.
Itakda ang endpoint gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang Partner API sa PUT /channels/:id/webhook. Ipinapakita nang isang beses ang signing secret. Kapag inulit ang pagtatakda ng endpoint, bagong secret ang ibinibigay, at ang pagpasa ng null bilang URL ay nagpapatay ng forwarding.
Ano ang itsura ng isang delivery?
Isang POST na may JSON body na naglalaman ng platform, ang account_id na ibinibigay ng list_social_accounts para sa koneksyon, ang external_id ng Instagram account, at entry: ang webhook entry ng Meta para sa event, hindi binago. Ganito rin ang pagdating ng DM, pero ang messaging array ang nasa lugar ng changes. Ganito ang itsura ng bagong comment:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}Paano i-verify ang isang delivery?
Bawat delivery ay may X-EC-Signature header sa anyong t=<unix>,v1=<hex>, kung saan ang v1 ay HMAC-SHA256 ng timestamp, isang tuldok, at ang raw request body, gamit ang signing secret ng account bilang key. I-compute ito sa raw body eksakto kung paano ito natanggap, ikumpara nang constant time, at tanggihan ang timestamp na mas luma sa 5 minuto.
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}Inuulit ba ang isang delivery?
Hindi ng easyCoexistence: ipinapasa nito ang bawat event nang isang beses, sa memorya, at walang kopyang maaaring ulitin. Sumagot ng 2xx agad at gawin ang trabaho pagkatapos, at i-store ang kailangan ninyo pagdating nito, dahil wala ring history ng nakaraang notification na maaaring i-query sa Meta.
Sinusubukang muli ng Meta mismo ang nabigong delivery sa app nang hanggang 36 na oras, kaya maaaring dumating minsan nang dalawang beses ang parehong event. I-deduplicate ito sa comment ID o sa mid ng mensahe.
Ano pa ang dapat i-check ng handler?
Ilang detalye sa payload ng Meta na nakakalito sa unang handler:
is_echo: ang event ng mensahe na mayis_echona true ay ipinadala ng account mismo, kaya hindi na kailangan ng sagot.- Story replies: ang DM na tumutugon sa Story ay may
reply_tona naglalaman ng ID at URL ng Story. - Story mentions: dumarating bilang mensahe na ang attachment type ay
story_mention. - time: kung kailan ipinadala ng Meta ang notification, hindi kung kailan ginawa ang comment o mensahe; ang sariling timestamp ng mensahe ay nasa messaging entry nito.
- Album IDs: wala ito sa comment events; hanapin ang album gamit ang comment ID.
Mga karaniwang pagkakamali
- Paggawa ng trabaho bago sumagot. Hindi nagre-retry ang forwarding, kaya magbalik agad ng 2xx at iproseso ang event pagkatapos.
- Pag-verify ng signature sa na-parse na JSON. I-compute ang HMAC sa raw body eksakto kung paano ito dumating.
- Pagsagot sa echo. Ang event ng mensahe na may is_echo ay ipinadala ng account mismo, at ang pagsagot dito ay nagsisimula ng loop.
- Paglaktaw sa deduplication. Maaaring ideliver ulit ng Meta ang parehong event pagkatapos ng failure, kaya i-key sa comment ID o sa mid ng mensahe.
Ipinapasa ng easyCoexistence ang comments, mentions, at DMs ng Instagram account sa HTTPS endpoint ninyo habang dumarating, pinipirmahan ng secret para sa account na iyon, at walang kopyang itinatago sa daan. I-on ito gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang Partner API. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may free trial sa unang 3 araw.
Mga madalas itanong
Ano ang ibig sabihin ng time field sa Instagram webhook?
Kung kailan ipinadala ng Meta ang notification, hindi kung kailan ginawa ang comment o mensahe. Ang sariling timestamp ng DM ay nasa messaging entry nito.
Inuulit ba ng Meta ang nabigong Instagram webhook deliveries?
Oo. Sinusubukang muli ng Meta ang nabigong delivery sa app nang hanggang 36 na oras, kaya maaaring minsan dumating nang dalawang beses ang parehong event: i-deduplicate sa comment ID o sa mid ng mensahe. Ipinapasa ng easyCoexistence ang bawat event sa endpoint ninyo nang isang beses, kaya sumagot agad ng 2xx.
Ilang update ang kayang laman ng isang Instagram webhook delivery?
Hanggang 1,000 kapag pinagsama ng Meta, bagaman hindi ginagarantiya ng Meta ang pagsasama-sama. I-loop ang buong entry array sa halip na basahin lamang ang unang item.
May sariling event ba ang mentions?
Wala sa Instagram Login. Isinasama ng Meta ang mentions sa comments notification, kaya dumarating ang mga ito sa parehong daan ng comments.
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