Câmpurile webhook Instagram: lista completă
Pentru un cont profesional pe Instagram Login, tabelul de câmpuri webhook din documentația Meta listează comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover și standby, mențiunile fiind livrate în interiorul comments; exemplele includ și message_edit. Fiecare necesită instagram_business_basic, plus instagram_business_manage_comments sau, pentru majoritatea câmpurilor de mesagerie, instagram_business_manage_messages. story_insights nu este oferit cu Instagram Login.
easyCoexistence abonează fiecare cont Instagram conectat la comments, messages și mentions și trimite aceste evenimente către endpoint-ul dumneavoastră HTTPS pe măsură ce sosesc, semnate cu secretul contului respectiv.
Câmpurile cu care un produs Instagram nou din App Dashboard pornește abonat, printre care comments, messages și message_reactions.
Câmpurile se selectează pentru aplicație, nu pe cont: un cont primește câmpurile selectate de aplicație.
Nivelul de acces pe care ghidul de configurare Meta îl listează pentru webhook-urile Instagram Login și pe care îl cere pentru notificările comments și live_comments.
Marcat ca indisponibil pentru Instagram Login în tabelul de câmpuri al Meta, care îl oferă cu Facebook Login și Unified Login.
Când Meta a introdus webhook-ul message_edit pentru Business Login for Instagram și Facebook Login for Business.
Ce câmpuri webhook oferă Instagram Login?
Acestea, din tabelul de câmpuri al Meta, cu ce declanșează fiecare, preluat din exemple și din referința webhook. Fiecare câmp necesită și instagram_business_basic pe lângă permisiunea indicată, iar Meta cere Advanced Access pentru notificările comments și live_comments.
Ce câmpuri nu sunt disponibile cu Instagram Login?
Trei rânduri din tabelul de câmpuri al Meta nu au permisiune pentru Instagram Login, deci o aplicație pe Instagram Login nu le primește, iar încă un câmp există doar în afara acestuia:
story_insights: metricile unei Story la expirare, cu Facebook Login sau Unified Login șiinstagram_manage_insights. Referința Meta pentru insights media spune că webhook-ul de insights nu este suportat cu Instagram Login.messaging_policy_enforcementșiresponse_feedback: doar în coloana pentru API-ul de mesagerie Instagram al Meta.- mentions ca un câmp separat: Facebook Login și Unified Login îl listează, cu
instagram_manage_comments, în timp ce Instagram Login include mențiunile în comments.
Cum te abonezi la câmpuri?
În două locuri. În App Dashboard, la setările webhook ale produsului Instagram, salvezi URL-ul de callback și token-ul de verificare, ceea ce declanșează cererea de verificare a Meta, apoi selectezi câmpurile; un produs Instagram nou pornește abonat la opt dintre ele. Apoi abonezi fiecare cont cu POST /<IG_ID>/subscribed_apps pe graph.instagram.com, cu subscribed_fields setat la câmpurile selectate în dashboard, separate prin virgulă.
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages,message_reactions
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }Poate primi fiecare cont câmpuri diferite?
Nu. Ghidul de configurare al Meta spune că nu se pot selecta câmpuri pentru fiecare cont al utilizatorului aplicației: un cont primește câmpurile selectate pentru aplicație. subscribed_fields din abonamentul contului are rolul de a lista câmpurile din dashboard, deci un handler trebuie să se aștepte la orice câmp selectat de aplicație și să decidă după ce conține fiecare eveniment, nu după ce a cerut un singur cont.
Cum deosebești câmpurile într-o notificare?
După forma intrării. Câmpurile de comentarii sosesc într-un array changes, fiecare modificare indicând câmpul ei. Câmpurile de mesagerie sosesc într-un array messaging fără nume de câmp, iar cheia de lângă sender, recipient și timestamp le deosebește:
- changes[].field: comments sau
live_comments, cu comentariul în value. - message: messages, inclusiv ecourile mesajelor contului, care au
is_echosetat la true. - reaction:
message_reactions. postback:messaging_postbacks. read:messaging_seen.message_edit:message_edit. - referral lângă sender:
messaging_referral. Un referral în interiorul message aparține lui messages, dintr-o conversație nouă sau dintr-un anunț Click-to-Direct. pass_thread_control,take_thread_controlsaurequest_thread_control:messaging_handover, așa cum le listează referința webhook a Meta.
Ce câmpuri abonează easyCoexistence?
comments, messages și mentions, lista cu care se abonează fiecare cont Instagram la conectare. Cu Instagram Login, mențiunile vin în interiorul comments, deci abonamentul acoperă comentariile și mesajele directe, printre acestea aflându-se ecourile, răspunsurile la Story, menționările în Story și atașamentele. Celelalte câmpuri din tabel sunt livrate de Meta unei aplicații abonate la ele și nu fac parte din abonamentul unei conexiuni. Odată ce un endpoint este setat cu set_social_webhook_destination sau cu Partner API, easyCoexistence verifică semnătura Meta, răspunde imediat Meta și trimite prin POST fiecare intrare a contului către acesta:
- platform și
external_id: instagram, iar ID-ul contului de Instagram, egal cu entry.id. account_id: ID-ul conexiunii în easyCoexistence, cel pe care îl folosesc uneltele MCP.- entry: intrarea Meta pentru cont, nemodificată. Câmpul object al Meta și antetul său X-Hub-Signature-256 nu sunt transmise mai departe.
- X-EC-Signature: t=<unix>,v1=<hex>, un HMAC-SHA256 al marcajului de timp, al unui punct și al corpului brut, cu secretul propriu al contului.
- Livrare: o singură încercare de până la 8 secunde, fără redirecționări urmate, fără copie păstrată și fără reîncercări.
Greșeli frecvente
- Așteptarea unui câmp mentions cu Instagram Login. Meta include mențiunile în notificarea comments, deci un handler legat de câmpul mentions nu rulează niciodată.
- Presupunerea că un cont primește doar câmpurile din abonamentul propriu. Meta livrează câmpurile selectate pentru aplicație, deci ramificați după ce conține fiecare eveniment.
- Tratarea lui message.referral și a unui referral de nivel superior ca un singur eveniment. Primul ține de messages; al doilea este messaging_referral, pentru un link ig.me deschis într-o conversație existentă.
- Așteptarea story_insights cu Instagram Login. Meta îl marchează indisponibil acolo, deci citiți metricile unei Story din endpoint-ul de insights cât timp este încă activă.
Evenimentele nu sunt stocate implicit; un cont cu o automatizare activată își păstrează DM-urile și comentariile timp de 7 zile. Setați endpoint-ul cu set_social_webhook_destination din Claude sau ChatGPT, ori cu Partner API. De la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Există un câmp webhook separat pentru mențiuni cu Instagram Login?
Nu. Meta include mențiunile în notificarea comments pentru Instagram Login; mentions este un câmp propriu doar cu Facebook Login și Unified Login.
Este story_insights disponibil cu Instagram Login?
Nu. Tabelul de câmpuri al Meta îl marchează indisponibil pentru Instagram Login, iar referința Meta pentru insights media spune că webhook-ul de insights nu este suportat acolo.
Ce permisiuni necesită webhook-ul de mesaje Instagram?
instagram_business_basic și instagram_business_manage_messages, cu Advanced Access, pe care ghidul de configurare Meta îl listează pentru webhook-urile Instagram Login.
Când a adăugat Meta webhook-ul message_edit pentru Instagram?
Pe 10 septembrie 2025, pentru Business Login for Instagram și Facebook Login for Business. O editare sosește în array-ul messaging sub cheia message_edit.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la