IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Matukio ya webhook ya Instagram: maoni, kutajwa na DM

Matukio ya webhook ya Instagram yanaripoti shughuli kwenye akaunti ya kitaaluma inapotokea: maoni mapya, @mentions na DM. Meta hutuma kila tukio kama JSON kwenye endpoint ya HTTPS ya programu iliyounganishwa na kujaribu tena uwasilishaji ulioshindwa kwenye endpoint hiyo kwa hadi saa 36. easyCoexistence hupeleka kila tukio kwenye endpoint yako mara moja, likisainiwa kwa kila akaunti, bila kujaribu tena. Kwa Instagram Login, kutajwa hufika ndani ya arifa ya maoni.

36 hours

Muda ambao Meta hujaribu tena uwasilishaji ulioshindwa kwenye endpoint ya programu kabla ya kuuacha.

1,000

Mara nyingi Meta huunganisha masasisho kuwa uwasilishaji mmoja wa webhook, ingawa haihakikishi kuunganisha.

is_echo

Alama ambayo Meta huweka kwenye matukio ya ujumbe ambayo akaunti yenyewe ilituma.

Public

Ni media ya akaunti za umma pekee ndiyo huanzisha arifa za maoni na kutajwa.

Ni matukio gani yapo?

Kwa akaunti ya kitaaluma iliyounganishwa kwa Instagram Login, aina tatu za shughuli hufika kama matukio:

  • Maoni: maoni mapya kwenye media ya akaunti, pamoja na kitambulisho cha maoni, kitambulisho cha Instagram cha mwandishi na jina lake la mtumiaji, maandishi, na kitambulisho na aina ya media.
  • Kutajwa: kwa Instagram Login hufika ndani ya arifa ya maoni badala ya kuwa sehemu yake yenyewe.
  • Ujumbe: DM kwa akaunti, pamoja na mtumaji, mpokeaji, muhuri wa muda na ujumbe wenyewe, ikiwemo maandishi, viambatisho na majibu ya Story.

Matukio hufikaje kwenye endpoint yako?

Meta huwasilisha webhook za Instagram kwa programu ambayo akaunti iliunganishwa nayo. easyCoexistence huzipokea na kupeleka kila moja kwenye endpoint ya HTTPS uliyoweka kwa akaunti hiyo, inapofika, ikisainiwa kwa siri ya akaunti hiyo.

Weka endpoint kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa Partner API kupitia PUT /channels/:id/webhook. Siri ya kusaini huonyeshwa mara moja tu; kuweka endpoint tena hutoa siri mpya, na kupitisha null kama URL huzima usambazaji.

Uwasilishaji unaonekanaje?

POST yenye mwili wa JSON unaobeba jukwaa, account_id ambayo list_social_accounts hutoa kwa muunganisho, external_id ya akaunti ya Instagram, na entry: webhook entry ya Meta kwa tukio hilo, bila mabadiliko. DM hufika kwa namna hiyo hiyo, ikiwa na safu ya messaging badala ya changes. Maoni mapya yanaonekana hivi:

A forwarded comment event
{
  "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>" }
        }
      }
    ]
  }
}

Unathibitishaje uwasilishaji?

Kila uwasilishaji hubeba kichwa X-EC-Signature chenye umbo t=<unix>,v1=<hex>, ambapo v1 ni HMAC-SHA256 ya muhuri wa muda, nukta na mwili ghafi wa ombi, ukitumia siri ya kusaini ya akaunti. Hesabu juu ya mwili ghafi kama ulivyopokelewa, linganisha kwa muda usiobadilika, na kataa muhuri wa muda ulio zaidi ya dakika 5.

Node.js: verifying X-EC-Signature
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));
}

Je, uwasilishaji hujaribiwa tena?

Si na easyCoexistence: usambazaji hupeleka kila tukio mara moja, kwa muda mfupi kwenye kumbukumbu, bila kuhifadhi nakala ya kujaribu tena. Jibu kwa 2xx haraka na fanya kazi baadaye, na hifadhi unachohitaji mara tu kinapofika, kwani Meta haihifadhi historia ya arifa zilizopita inayoweza kuulizwa pia.

Meta yenyewe hujaribu tena uwasilishaji ulioshindwa kwa programu hadi saa 36, kwa hiyo tukio lile lile linaweza kufika mara mbili wakati mwingine: ondoa marudio kwa kutumia kitambulisho cha maoni au mid ya ujumbe.

Mshughulikiaji anapaswa kukagua nini kingine?

Mambo machache katika payload za Meta yanayomkwaza mshughulikiaji wa kwanza:

  • is_echo: tukio la ujumbe lenye is_echo kuwa true lilitumwa na akaunti yenyewe, kwa hiyo halihitaji jibu.
  • Majibu ya Story: DM inayojibu Story hubeba reply_to yenye kitambulisho na URL ya Story.
  • Kutajwa kwenye Story: hufika kama ujumbe ambao aina yake ya kiambatisho ni story_mention.
  • time: wakati Meta ilipotuma arifa, si wakati maoni au ujumbe ulipofanywa; muhuri wa muda wa ujumbe wenyewe uko kwenye ingizo lake la messaging.
  • Vitambulisho vya albamu: matukio ya maoni hayavijumuishi; tafuta albamu kwa kutumia kitambulisho cha maoni.

Makosa ya kawaida

  • Kufanya kazi kabla ya kujibu. Usambazaji haujaribu tena, kwa hiyo rudisha 2xx mara moja na uchakate tukio baadaye.
  • Kuthibitisha saini kwenye JSON iliyochambuliwa. Hesabu HMAC juu ya mwili ghafi kama ulivyofika.
  • Kujibu echo. Tukio la ujumbe lenye is_echo ni lile akaunti iliyotuma, na jibu kwake huanzisha mzunguko.
  • Kuruka uondoaji wa marudio. Meta inaweza kutuma tukio lile tena baada ya kushindwa, kwa hiyo tumia kitambulisho cha maoni au mid ya ujumbe kama ufunguo.
Kufanya hili ukitumia EasyCoexistence

easyCoexistence husambaza maoni, kutajwa na DM za akaunti ya Instagram kwenye endpoint yako ya HTTPS inapofika, zikisainiwa kwa siri ya akaunti hiyo bila nakala yoyote kuhifadhiwa njiani. Washa kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa Partner API. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inavyopungua kadri unavyoongeza miunganisho, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Sehemu ya time katika webhook ya Instagram inamaanisha nini?

Wakati Meta ilipotuma arifa, si wakati maoni au ujumbe ulipofanywa. Muhuri wa muda wa DM uko kwenye ingizo lake la messaging.

Je, Meta hujaribu tena uwasilishaji wa webhook wa Instagram ulioshindwa?

Ndiyo. Meta hujaribu tena uwasilishaji ulioshindwa kwa programu hadi saa 36, kwa hiyo tukio lile lile linaweza kufika mara mbili wakati mwingine: ondoa marudio kwa kutumia kitambulisho cha maoni au mid ya ujumbe. easyCoexistence husambaza kila tukio kwenye endpoint yako mara moja, kwa hiyo jibu kwa 2xx haraka.

Uwasilishaji mmoja wa webhook wa Instagram unaweza kubeba masasisho mangapi?

Hadi 1,000 Meta inapoyaunganisha, ingawa Meta haihakikishi kuunganisha. Pitia safu nzima ya entry badala ya kusoma kipengee cha kwanza tu.

Je, kutajwa kuna tukio lake?

Si kwa Instagram Login. Meta huweka kutajwa ndani ya arifa ya maoni, kwa hiyo hufika kwenye njia ile ile na 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