Webhook ya maoni ya Instagram: payload, sehemu kwa sehemu
Sehemu ya comments ya webhook ya Instagram humjulisha programu mtu anapoandika maoni, au kujibu maoni, kwenye midia ya akaunti ya kitaalamu, ikiwemo Reels. Meta hutuma mabadiliko yenye sehemu iliyowekwa kuwa comments, ambayo thamani yake hubeba id ya maoni na maandishi yake, Instagram-scoped ID ya mwandishi na jina lake la mtumiaji katika from, id ya midia na product type yake, pamoja na parent_id maoni yanapokuwa jibu.
easyCoexistence inajisajili kwa maoni ya kila akaunti ya Instagram iliyounganishwa na kutuma matukio ya maoni ambayo Meta inayatuma kwa akaunti hiyo kwenye endpoint yako ya HTTPS yanapofika, yakisainiwa kwa siri ya akaunti hiyo na bila nakala kuhifadhiwa.
Ipo maoni yanapokuwa jibu, ikibeba ID ya maoni inayojibiwa.
Huongezwa from maoni yanapoandikwa na akaunti yenyewe kwenye midia yake, karibu na ID ya akaunti.
Sehemu tofauti kwa maoni wakati wa matangazo ya moja kwa moja (Live); arifa zake huacha matangazo yanapoisha.
Inahitajika kwa arifa za comments na live_comments; midia ya akaunti binafsi haitoi arifa yoyote.
Muda uliobaki wa kumtumia mwandishi wa maoni jibu moja la faragha, linalolengwa kwa ID ya maoni.
Sehemu ya comments hufanya kazi lini?
Mtu anapoandika maoni kwenye midia ambayo akaunti ya kitaalamu inamiliki, au kumtaja akaunti, mara programu na akaunti zote mbili zimejisajili kwenye sehemu hiyo. Kila maoni ni mabadiliko moja katika arifa, na visa hivi vyote vinashiriki umbo lake:
- Maoni mapya kwenye chapisho, Reel, Story au tangazo, yakiwa na media.
media_product_typeinayoonyesha midia iko kwenye uso gani. - Jibu chini ya maoni yaliyopo, lenye
parent_idyenye ID ya maoni inayojibiwa. - Maoni ambayo akaunti yenyewe inaandika kwenye midia yake, pamoja na majibu yake: from.id ni ID ya akaunti yenyewe, na from huongezwa
self_ig_scoped_id. - Kutajwa kwa akaunti kwa @: kwa Instagram Login, Meta inajumuisha kutajwa kwenye arifa ya comments badala ya sehemu yake yenyewe.
- Maoni wakati wa Live yanakuja kwenye sehemu tofauti,
live_comments, yenye umbo lilelile la thamani, na huacha matangazo yanapoisha.
Arifa ya maoni inaonekanaje?
POST yenye JSON ambayo object ni instagram na array ya entry. Kila entry ni akaunti moja ya kitaalamu: ID yake, muda ambao Meta ilituma arifa, na array ya changes yenye mabadiliko moja kwa kila maoni. Jibu kwenye Reel linaonekana hivi:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}Kila sehemu inamaanisha nini?
Sehemu ambazo rejea ya webhook ya Meta inaorodhesha kwa maoni, kutoka nje kuingia ndani:
- entry[].id: ID ya akaunti ya kitaalamu,
user_idambayo /me inarudisha kwake. Inakuonyesha maoni ni ya akaunti ipi. - entry[].time: wakati Meta ilituma arifa, kama Unix timestamp. Si wakati maoni yaliandikwa.
- changes[].field: comments, au
live_commentskwa matangazo ya moja kwa moja. Iangalie kabla ya kusoma value. - value.id: ID ya maoni, ile ya kujibu hadharani au kwa faragha, kuficha au kufuta.
- value.text: maandishi ya maoni, yanajumuishwa maoni yanapokuwa na maandishi.
- value.from.id na value.from.username: Instagram-scoped ID ya mwandishi na jina lake la mtumiaji. value.from.
self_ig_scoped_idhuonekana akaunti yenyewe iliandika maoni. - value.media.id na value.media.
media_product_type: midia iliyotolewa maoni na uso wake; rejea ya midia ya Meta inataja AD, FEED, STORY na REELS. - value.
parent_id: kwenye jibu, ID ya maoni inayojibiwa. Maoni ya ngazi ya juu hayana. - value.media.
ad_id,ad_titlenaoriginal_media_id: zimeorodheshwa kwenye rejea kwa maoni yaliyotolewa kwenye tangazo.
Sehemu ya maoni hairipoti nini?
Baadhi ya mambo ambayo kishughulikiaji kinaweza kutarajia yameachwa nje ya tukio au hayatumwi kamwe, kulingana na mwongozo wa usanidi na rejea za Meta:
- Maoni kwenye midia ya akaunti binafsi: Meta haituma arifa za maoni au kutajwa kwa ajili yake.
- ID za albamu: tukio halizijumuishi, na Meta inasema zitafutwe kwa kutumia ID ya maoni.
- ID za matangazo kwa midia inayotumika kwenye matangazo yanayobadilika (dynamic ads).
- Muda wa kuundwa kwa maoni: GET /<
COMMENT_ID>?fields=timestamp inaurudisha kwa ISO 8601. - Maoni ya Live baada ya matangazo kuisha, wakati arifa za midia ya moja kwa moja zinapoacha.
- Kutajwa kwenye Story, ambako API ya kutaja ya Meta haiungi mkono; vinafika kwa akaunti kama DM badala yake.
- Matukio ya zamani: Meta haina historia ya arifa ya kuuliza, kwa hiyo hifadhi unachohitaji kadri kila moja inavyofika.
Sehemu ya maoni inahitaji nini?
Kwa Instagram Login, ruhusa za instagram_business_basic na instagram_business_manage_comments, pamoja na Advanced Access, ambayo Meta inahitaji kwa arifa za comments na live_comments. Programu lazima iwe Live na ijisajili kwa comments kwenye App Dashboard, na kila akaunti lazima ijisajili kupitia POST /<IG_ID>/subscribed_apps ikiwa na comments miongoni mwa subscribed_fields zake. Meta inapendekeza sana webhook hii badala ya kuuliza mara kwa mara kwa maoni, kwa sababu inaepuka kikomo cha kiwango (rate limit).
Unajibuje maoni kutoka kwenye tukio?
Kwa vitambulisho vinavyobebwa nalo. POST /<COMMENT_ID>/replies yenye message hutuma jibu la hadharani chini ya maoni, kwa kutumia value.id. POST /<IG_ID>/messages yenye recipient.comment_id iliyowekwa kuwa value.id hutuma mwandishi jibu moja la faragha, ndani ya siku 7 tangu maoni yaandikwe, au wakati matangazo ya Live yanaendelea. from.id ni Instagram-scoped ID, lakini DM iliyotumwa moja kwa moja kwake inashindwa hadi mtu huyo amemtumia ujumbe akaunti, kwa hiyo jibu la faragha ndilo njia ya kumfikia kwa DM.
easyCoexistence inatumaje maoni?
Mara endpoint inapowekwa kwa akaunti kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa PUT /channels/:id/webhook kwenye Partner API, matukio hufika yanavyofika. easyCoexistence inajisajili kwa kila akaunti iliyounganishwa kwenye fields zinazobeba maoni, kutajwa na DM zake, inakagua sahihi ya Meta kwenye kila utumaji, inamjibu Meta mara moja, na kutuma kila entry ya akaunti hiyo kwa URL yako ya HTTPS ndani ya envelope:
- platform na
external_id: instagram, na ID ya Instagram ya akaunti, sawa na entry.id. account_id: kitambulisho cha muunganisho katika easyCoexistence, kilelist_social_accountsinachorudisha na zana za MCP zinachukua.- entry: entry ya Meta kwa akaunti, bila mabadiliko, kwa hiyo utumaji uliokusanywa unakuwa POST moja kwa kila entry. Sehemu ya object ya Meta na X-Hub-Signature-256 hazipitishwi.
- Utumaji: jaribio moja, kusubiri hadi sekunde 8, bila kufuata uelekezaji upya (redirects), kwenda anwani ya HTTPS inayotatuliwa kuwa IP ya umma. Hakuna nakala inayohifadhiwa na hakuna kujaribu tena.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}Kanuni za maoni-kwenda-DM zinafanya nini na tukio hilo hilo?
Zinalisoma pamoja na utumaji. Kanuni inalingana maoni yanapokuwa na mojawapo ya maneno yake muhimu, bila kujali herufi kubwa au ndogo, kwenye chapisho moja lililochaguliwa au kwenye yote, na inamtumia mwandishi DM ya kanuni hiyo kama jibu lake la faragha, pamoja na jibu la hadharani kama kanuni ina moja. Maoni ya akaunti yenyewe yanaruka, otomatiki zinazoanza kwenye maoni zinachukua yale ambayo hakuna kanuni iliyoyajibu, na maoni ambayo kanuni ilijibu bado yanafika kwenye endpoint yako. Jibu la hadharani la kanuni linaweza kurudi kama tukio jipya la comments kutoka kwa akaunti yenyewe.
Makosa ya kawaida
- Kutafuta comment_id. Chini ya Instagram Login ID ya maoni iko kwenye value.id; comment_id ni ya payload za usanidi mwingine wa kuingia wa Meta.
- Kujibu maoni ya akaunti yenyewe. Majibu yake yanarudi kama tukio la comments lenye from.id sawa na entry.id, na otomatiki inayojibu hayo inajizungumzia yenyewe.
- Kusoma entry.time kama wakati wa maoni. Inarekodi wakati Meta ilipotuma arifa; sehemu yake ya timestamp ya maoni ndiyo inayosema yaliandikwa lini.
- Kusubiri maoni ya Live kwenye sehemu ya comments. Yanafika kwenye live_comments, ambayo inahitaji usajili wake yenyewe na hunyamaza matangazo yanapoisha.
Kanuni za maoni-kwenda-DM na otomatiki hujibu maoni yale yale saa zote. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kadri unavyoongeza miunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, webhook ya maoni ya Instagram inajumuisha majibu kwa maoni?
Ndiyo. Jibu linafika kama tukio lake la comments, na parent_id ikiwa na ID ya maoni inayojibiwa.
Je, maoni kwenye Reels yanaanzisha webhook ya maoni ya Instagram?
Ndiyo. Maoni kwenye Reel yanakuja kwenye sehemu ya comments kama yale ya chapisho, na media.media_product_type inayatofautisha mawili hayo.
Kwa nini webhook yangu ya maoni ya Instagram haitumi arifa?
Mara nyingi programu si Live au haina Advanced Access, akaunti haikuwahi kujisajili kupitia /subscribed_apps, midia ni ya akaunti binafsi, au maoni yalikuwa kwenye Live, ambayo hutumia live_comments.
Je, webhook ya maoni inajumuisha jina la mtumiaji la mwandishi?
Ndiyo. value.from inabeba jina la mtumiaji la mtu pamoja na Instagram-scoped ID yake, kwa hiyo hakuna wito wa ziada unaohitajika kuonyesha aliyeandika maoni.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye