Webhook ya ujumbe wa Instagram: payload ya DM, echo na sehemu
Sehemu ya webhook ya ujumbe wa Instagram hupeleka DM za akaunti ya kitaalamu kadri zinavyofika: maandishi, viambatisho, machapisho yaliyoshirikiwa, majibu ya Story, kutajwa, majibu ya ndani na kufutwa. Kila tukio liko ndani ya orodha ya `messaging`, pamoja na ID ya mtumaji wa Instagram, mpokeaji, muda na kitu cha ujumbe. Ujumbe ambao akaunti yenyewe hutuma hurudi kwenye sehemu hiyo hiyo ukiwa na is_echo imewekwa kuwa true.
easyCoexistence inasajili kila akaunti ya Instagram iliyounganishwa kwenye messages na inatuma DM zake, pamoja na echo, kwenye HTTPS endpoint yako kadri zinavyofika, zikisainiwa kwa siri ya akaunti hiyo; usambazaji hauhifadhi nakala, na DM hazihifadhiwi kwa chaguo-msingi.
Imewekwa kuwa true kwenye tukio la ujumbe kwa ujumbe ambao akaunti yenyewe imetuma.
Dirisha la kawaida la kutuma ujumbe kwa vitendo vingi vya watumiaji, ambapo programu inaweza kumjibu mtu huyo.
Aina ya kiambatisho kwa chapisho lililoshirikiwa; aina ya zamani ya kushiriki iliungwa mkono hadi 1 Februari 2026 pekee.
Aina ya kiambatisho cha tukio la DM ambalo Meta hutuma mtu anapoitaja akaunti kwenye Story yake.
Subcode ya hitilafu, chini ya code 200, akaunti ikizima ufikiaji wa ujumbe wa moja kwa moja (DM).
Tukio la `messages` huanzishwa lini?
Mtu anapotuma DM kwa akaunti ya kitaalamu, na akaunti inapotuma moja. Mifano na marejeleo ya Meta yanaorodhesha kesi hizi, kila moja ni tukio lenye kitu cha ujumbe:
- Maandishi, na midia kama viambatisho: picha, video, sauti na faili.
- Chapisho au Reel lililoshirikiwa, kama kiambatisho cha
ig_post,ig_reelau reel. - Jibu kwa Story ya akaunti, lenye
reply_to.story, na Story inayoitaja akaunti, kama kiambatisho chastory_mention. - Jibu la ndani kwa ujumbe wa awali, lenye
reply_to.mid, na jibu la haraka, lenyequick_reply.payload. - Ujumbe ambao mtu amefuta (
is_deleted), midia isiyoungwa mkono (is_unsupported), na ujumbe kutoka kwa mtu aliyebonyeza tangazo la Click-to-Direct (referral). - Ujumbe ambao akaunti imetuma, ambao hurudi ukiwa na
is_echoimewekwa kuwa true.
Arifa ya ujumbe inaonekanaje?
POST yenye JSON ambayo object ni instagram. Tofauti na maoni, ujumbe upo ndani ya orodha ya `messaging` ndani ya entry ya akaunti, na kila kipengele kina sender, recipient, timestamp na `message`. Jibu kwa Story ya akaunti linaonekana hivi:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL_FOR_THE_STORY>",
"id": "<STORY_ID>"
}
}
}
}
]
}
]
}Kila sehemu inamaanisha nini?
Sehemu ambazo Meta inaandika kwa tukio la ujumbe chini ya Instagram Login, kuanzia nje kuelekea ndani:
- entry[].id: ID ya akaunti ya kitaalamu. entry[].time: wakati Meta ilipotuma arifa; sampuli za Meta za ujumbe zinaitoa kwa milisekunde.
- sender.id na recipient.id: kwenye DM inayoingia, ID ya Instagram ya mtu huyo na ID ya akaunti; kwenye echo, hizo mbili zimegeuzwa.
- timestamp: wakati ujumbe ulipotumwa, kwa milisekunde katika sampuli za Meta. Panga ujumbe kwa hii, si kwa mpangilio wa kufika.
- message.mid: ID ya ujumbe, kwa kuondoa marudio, kuitikia, na kujibu ujumbe huo kwa
reply_to.mid. - message.text: kipo ujumbe unapokuwa na maandishi.
- message.attachments[]: kila moja ina type na payload, mara nyingi url. Payload ya
ig_postya chapisho lililoshirikiwa huongezaig_post_media_idna title, ambayo ni maelezo ya chapisho. - message.
reply_to: mid kwa jibu la ndani, au story pamoja na url na id ya Story kwa jibu kwa Story. - message.
quick_reply.payload na message.referral: jibu la haraka lililochaguliwa, na ref,ad_id, source, type naads_context_dataza tangazo la Click-to-Direct. - message.
is_deleted,is_echo,is_selfnais_unsupported: huonekana tu zikiwa true. - message.
admin_textnahandoff_reason: kwenye programu zinazostahili, arifa kwamba programu ya Meta, kama Meta Business Agent, imekabidhi mazungumzo; inaweza kufika bila mid wala maandishi.
Echo hufanyaje kazi?
Akaunti inapotuma ujumbe, Meta pia hutuma tukio la ujumbe kwa ajili yake, na is_echo imewekwa kuwa true. Kisha sender.id ni akaunti na recipient.id ni ID ya Instagram ya mtu, na jaribio ambalo akaunti inajituma pia lina is_self. Echo zinarekodi kile akaunti ilichosema, jambo ambalo kumbukumbu ya mazungumzo inahitaji, lakini kishughulikiaji kinachoamua kujibu lazima kuziruka. Meta haitumi echo akaunti inapoitikia ujumbe au kuondoa mwitikio.
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448061203,
"messaging": [
{
"sender": { "id": "<IG_ID>" },
"recipient": { "id": "<IGSID>" },
"timestamp": 1793448060950,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<REPLY_TEXT>",
"is_echo": true
}
}
]
}
]
}Unajibu ID gani?
sender.id, ID ya Instagram ya mtu huyo. Meta huiunda mtu anapotuma ujumbe kwa akaunti au kutoa maoni kwenye maudhui yake, na ni mahususi kwa mtu huyo na akaunti hiyo. POST /<IG_ID>/messages yenye recipient.id ikiwekwa kwake hutuma jibu. Tukio halibebi jina wala jina la mtumiaji; GET /<IGSID> yenye sehemu kama name na username huyarudisha, kwa sababu mtu aliyetuma ujumbe kwa akaunti ametoa ridhaa ambayo utafutaji huo unahitaji.
Ujumbe unafungua vipi dirisha la saa 24?
Programu inaweza kumtumia mtu ujumbe tu baada ya yeye kutuma ujumbe kwa akaunti, na ndani ya dirisha la huduma kwa wateja la kawaida ambalo kitendo chake kinafungua. Kwa vitendo vingi hudumu saa 24, na hadi siku 7 kutoka ujumbe wa kwanza uliotumwa baada ya kubonyeza tangazo la Click-to-Direct. Ujumbe mpya kutoka kwa mtu hufungua dirisha jipya, kwa hiyo muda wake wa mwisho ndio wa kufuatilia; echo ni ujumbe wa akaunti yenyewe na haiongezi chochote. Majibu yaliyoandikwa na mtu yanaweza kutumia dirisha tofauti la Meta la Human Agent la siku 7, lililowekwa lebo human_agent.
Tukio la ujumbe halibebi nini?
Mambo kadhaa ambayo kishughulikiaji kinaweza kuyatafuta hayapo, kulingana na marejeleo ya Meta ya ujumbe:
- Jina au jina la mtumiaji la mtu: ID ya Instagram pekee, ambayo GET /<IGSID> huitafsiri.
- Midia ya kuonekana mara moja: hufika kama kiambatisho cha muda mfupi bila URL.
- Picha kamili ya carousel: mwitikio kwa picha moja katika chapisho la carousel, au kutuma tena yake, huripoti picha ya kwanza.
- Mwitikio, mabadiliko na risiti za kusoma, ambazo huja kwenye sehemu zao wenyewe.
- Alama ya kusoma: ujumbe uliopelekwa kwa webhook unabaki haujasomwa kwenye kikasha cha Instagram hadi jibu litumwe.
Sehemu nyingine za ujumbe ambazo Meta inaorodhesha ni zipi?
Orodha ya sehemu na mifano ya Meta ya Instagram Login inataja hizi mbali na `messages`, kila moja ikiwa tukio la ujumbe lenyewe. easyCoexistence inasajili kila akaunti kwenye `messages`, `comments` na `mentions` pekee, kwa hiyo hakuna hata moja kati ya hizi iko kwenye kile inachotuma mbele:
message_reactions: mtu anaitikia ujumbe au anaondoa mwitikio, pamoja na reaction.mid, action yenye react au unreact, na reaction na emoji.message_edit: mtu anahariri ujumbe, pamoja namessage_edit.mid, maandishi mapya nanum_edit.messaging_postbacks: mtu anagusa icebreaker au kitufe cha kiolezo, pamoja na postback.mid, title na payload.messaging_referral: mtu aliyeko tayari kwenye mazungumzo anafungua kiungo cha ig.me chenye kigezo cha ref.messaging_seen: mtu anasoma ujumbe, pamoja na read.mid.messaging_optins,messaging_handoverna standby: mbili za mwisho ni kwa programu zinazoshiriki mazungumzo chini ya itifaki ya handover ya Meta.
Akaunti lazima iwashe nini?
Ruhusu ufikiaji wa ujumbe. Meta inahitaji akaunti ya kitaalamu iwashe hili kabla ujumbe wake usimamiwe kupitia API, katika programu ya Instagram chini ya Mipangilio, Ujumbe na majibu ya Story, Udhibiti wa ujumbe, Zana zilizounganishwa. Ufikiaji ukiwa umezimwa, utumaji unashindwa na code 200, subcode 2534041. Programu pia inahitaji instagram_business_basic na instagram_business_manage_messages, pamoja na Advanced Access ili kuhudumia akaunti ambazo haimiliki wala kuisimamia.
easyCoexistence inatuma DM vipi?
Kama maoni: kila kipengele ambacho Meta inatuma kwa akaunti hutumwa kwa POST kwenye HTTPS endpoint yako ndani ya bahasha ya platform, account_id, external_id na entry, ikisainiwa kwenye X-EC-Signature kwa siri ya akaunti, mara moja na bila nakala yoyote kuhifadhiwa. Echo hutumwa pamoja na nyingine, kwa hiyo angalia is_echo kabla ya kujibu. Ili kujibu, piga send_social_dm yenye account_id na sender.id ya tukio kama recipient_id, ndani ya dirisha la saa 24. Otomatiki zinazoanza kwa DM zinaendeshwa kwenye matukio hayo hayo.
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "image", "payload": { "url": "<URL_FOR_THE_MEDIA>" } }
]
}
}
]
}
}Makosa ya kawaida
- Kujibu echo. Tukio lenye is_echo imewekwa ni ujumbe wa akaunti yenyewe, na jibu kwake linaingiza akaunti kwenye mzunguko na yenyewe.
- Kudhani ujumbe daima una maandishi. Viambatisho, machapisho yaliyoshirikiwa, kutajwa kwenye Story na kufutwa hufika bila sehemu ya maandishi, kwa hiyo fanya uamuzi kwa kile kitu cha ujumbe kinachoshikilia.
- Kupanga ujumbe kwa mpangilio wa kufika. Meta inaweza kupeleka ujumbe nje ya mpangilio baada ya hitilafu, kwa hiyo yapange kwa timestamp.
- Kuchanganua `time` na `timestamp` kama sekunde. Sampuli za ujumbe za Meta zinatoa zote mbili kwa milisekunde, na zikisomwa kama sekunde zinageuka tarehe za mbali sana baadaye.
send_social_dm hujibu ndani ya dirisha la saa 24, na otomatiki zinaweza kujibu zenyewe kwa maandishi yaliyowekwa au AI. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka unavyoongeza muunganisho, na siku 3 za kwanza ni kipindi cha majaribio bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, timestamp za webhook ya ujumbe wa Instagram ziko kwa sekunde au milisekunde?
Milisekunde, kwenye sampuli za Meta za ujumbe, kwa timestamp na muda wa entry. Zikisomwa kama sekunde, zinageuka tarehe za mbali sana baadaye.
Ninapataje jina la mtumaji kutoka webhook ya DM ya Instagram?
Piga GET /<IGSID> yenye sehemu kama name na username. Tukio lina ID ya Instagram ya mtu huyo pekee.
Kwa nini webhook zangu za DM za Instagram hazifiki?
Hakikisha akaunti imewasha Ruhusu ufikiaji wa ujumbe, kwamba imesajiliwa kwenye messages kupitia /subscribed_apps, na kwamba programu iko Live yenye Advanced Access kwa akaunti ambazo haimiliki.
Je, easyCoexistence inasambaza miitikio ya ujumbe wa Instagram?
Hapana. Miitikio huja kwenye message_reactions, na easyCoexistence inasajili akaunti kwenye messages, comments na mentions pekee.
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