Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Instagram webhook olayları: yorumlar, @mention'lar ve DM'ler

Instagram webhook olayları, profesyonel bir hesaptaki etkinliği olduğu anda bildirir: yeni yorumlar, @mention'lar ve DM'ler. Meta her birini bağlı uygulamanın HTTPS uç noktasına JSON olarak POST eder ve başarısız teslimatı bu uç noktaya 36 saate kadar yeniden dener. easyCoexistence her olayı, hesap başına imzalı olarak ve yeniden deneme olmadan, uç noktanıza bir kez iletir. Instagram Login kullanıldığında, mention'lar yorum bildiriminin içinde gelir.

36 hours

Meta'nın, uygulamanın uç noktasına başarısız bir teslimatı düşürmeden önce ne kadar süre yeniden denediği.

1,000

Meta çoğu güncellemeyi tek bir webhook teslimatında toplar, ancak toplamayı garanti etmez.

is_echo

Meta'nın, hesabın kendisi tarafından gönderilen mesaj olaylarına koyduğu bayrak.

Public

Yalnızca herkese açık hesaplardaki medya, yorum ve mention bildirimlerini tetikler.

Hangi olaylar var?

Instagram Login ile bağlanmış profesyonel bir hesap için üç tür etkinlik olay olarak gelir:

  • Yorumlar: hesabın medyasına yapılan yeni bir yorum; yorum kimliği, yazarın Instagram kapsamlı kimliği ve kullanıcı adı, metin, medya kimliği ve türüyle birlikte.
  • Mention'lar: Instagram Login ile kendi alanlarında değil, yorum bildiriminin içinde gelir.
  • Mesajlar: hesaba gelen bir DM; gönderen, alıcı, zaman damgası ve metin, ekler ve hikaye yanıtları dahil mesajın kendisiyle birlikte.

Olaylar uç noktanıza nasıl ulaşır?

Meta Instagram webhook'larını, hesabın bağlandığı uygulamaya teslim eder. easyCoexistence bunları alır ve her birini, geldiği anda, o hesap için belirlediğiniz HTTPS uç noktasına iletir; her biri o hesaba özel bir gizli anahtarla imzalanır.

Uç noktayı Claude veya ChatGPT üzerinden set_social_webhook_destination ile ya da Partner API ile PUT /channels/:id/webhook üzerinden ayarlayın. İmzalama anahtarı bir kez gösterilir; uç noktayı yeniden ayarlamak yeni bir anahtar üretir, URL yerine null vermek iletmeyi kapatır.

Bir teslimat nasıl görünür?

JSON gövdesi olan bir POST isteğidir; gövdede platform, list_social_accounts ile alınan account_id, Instagram hesabının external_id alanı ve entry alanı yer alır: olay için Meta'nın webhook girdisi, değiştirilmeden. DM de aynı biçimde gelir; tek fark, changes yerine messaging dizisinin bulunmasıdır. Yeni bir yorum şöyle görünür:

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>" }
        }
      }
    ]
  }
}

Bir teslimatı nasıl doğrularsınız?

Her teslimat, X-EC-Signature başlığını t=<unix>,v1=<hex> biçiminde taşır. v1, zaman damgasının, bir noktanın ve ham istek gövdesinin HMAC-SHA256 değeridir; hesabın imzalama anahtarıyla üretilir. HMAC'i alındığı haliyle ham gövde üzerinden hesaplayın, karşılaştırmayı sabit zamanlı yapın ve 5 dakikadan eski bir zaman damgasını reddedin.

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));
}

Bir teslimat yeniden deneniyor mu?

easyCoexistence tarafından hayır: yönlendirme her olayı bir kez, bellekte iletir ve yeniden deneyebileceği bir kopya tutmaz. 2xx yanıtını hızla verin, işi sonra yapın ve gelir gelmez ihtiyaç duyduğunuz her şeyi kaydedin; çünkü Meta da sorgulanabilecek bir geçmiş bildirim kaydı tutmaz.

Meta, başarısız bir teslimatı uygulamaya 36 saate kadar kendisi yeniden dener; bu yüzden aynı olay nadiren iki kez ulaşabilir: yorum kimliği ya da mesajın mid değerine göre yinelenenleri ayıklayın.

Bir işleyici başka neyi kontrol etmeli?

Meta'nın payload'larında, ilk işleyiciyi takılıp kaldıran birkaç ayrıntı var:

  • is_echo: is_echo değeri true olan bir mesaj olayı, hesabın kendisi tarafından gönderilmiştir; yanıt gerektirmez.
  • Hikaye yanıtları: bir hikayeye yanıt veren DM, hikayenin kimliği ve URL'si ile birlikte reply_to alanını taşır.
  • Hikaye mention'ları: attachment türü story_mention olan bir mesaj olarak gelir.
  • time: Meta'nın bildirimi gönderdiği zaman; yorumun ya da mesajın yapıldığı zaman değil. Mesajın kendi zaman damgası messaging girdisinde yer alır.
  • Albüm kimlikleri: yorum olaylarında bulunmaz; albümü yorum kimliğiyle arayın.

Yaygın hatalar

  • Yanıt vermeden işi yapmak. Yönlendirme yeniden deneme yapmaz, bu yüzden 2xx yanıtını hemen dönün ve olayı sonra işleyin.
  • İmzayı ayrıştırılmış JSON üzerinde doğrulamak. HMAC'i ham gövde üzerinden, geldiği haliyle hesaplayın.
  • Echo'lara yanıt vermek. is_echo değeri true olan bir mesaj hesabın gönderdiği bir mesajdır; ona yanıt vermek bir döngü başlatır.
  • Yinelenenleri ayıklamamak. Meta, bir hatadan sonra aynı olayı yeniden teslim edebilir; yorum kimliğine ya da mesaj mid değerine göre ayırın.
Bunu EasyCoexistence'la yapmak

easyCoexistence, Instagram hesabının yorumlarını, mention'larını ve DM'lerini geldikleri anda HTTPS uç noktanıza iletir; hesaba özel bir anahtarla imzalanır ve iletim sırasında hiçbir kopya tutulmaz. Etkinleştirmek için Claude veya ChatGPT üzerinden set_social_webhook_destination ile ya da Partner API ile ayarlayın. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; bağlantı ekledikçe düşer, ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Instagram webhook'undaki time alanı ne anlama gelir?

Meta'nın bildirimi gönderdiği zamandır; yorumun ya da mesajın yapıldığı zaman değil. Bir DM'in kendi zaman damgası messaging girdisinde yer alır.

Meta, başarısız Instagram webhook teslimatlarını yeniden dener mi?

Evet. Meta, başarısız bir teslimatı uygulamaya 36 saate kadar yeniden dener; bu yüzden aynı olay nadiren iki kez ulaşabilir: yorum kimliğine ya da mesajın mid değerine göre yinelenenleri ayıklayın. easyCoexistence her olayı uç noktanıza bir kez iletir; bu nedenle 2xx yanıtını hızla verin.

Tek bir Instagram webhook teslimatı kaç güncelleme içerebilir?

Meta topladığında en fazla 1.000; ancak Meta toplamayı garanti etmez. Yalnızca ilk öğeyi okumak yerine tüm entry dizisini gezin.

Mention'ların kendi olayı var mı?

Instagram Login ile yok. Meta mention'ları yorum bildirimine ekler; bu yüzden yorumlarla aynı yoldan gelirler.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi