Webhook voor Instagram-reacties: de payload, veld voor veld
De comments-webhook van Instagram meldt een app wanneer iemand reageert op media van een professioneel account, of op een reactie daarop, inclusief Reels. Meta stuurt een wijziging met field gelijk aan comments, waarvan de value de ID en tekst van de reactie bevat, het Instagram-scoped ID en de gebruikersnaam van de auteur in from, de ID en het producttype van de media, en parent_id wanneer de reactie een antwoord is.
easyCoexistence abonneert elk verbonden Instagram-account op comments en stuurt de comments-gebeurtenissen die Meta ervoor levert zodra ze binnenkomen door naar je HTTPS-endpoint, ondertekend met het geheim van dat account en zonder kopie te bewaren.
Aanwezig wanneer de reactie een antwoord is, met de ID van de reactie waarop wordt gereageerd.
Wordt aangevuld met from wanneer het account reageert op de eigen media, naast de eigen ID van het account.
Apart veld voor reacties tijdens een Live-uitzending; de meldingen stoppen wanneer de uitzending eindigt.
Vereist voor meldingen van comments en live_comments; media van privé-accounts veroorzaken geen melding.
Resterende tijd om de reageerder één privé-reactie te sturen, geadresseerd met de ID van de reactie.
Wanneer vuurt het comments-veld?
Wanneer iemand reageert op media die het professionele account bezit, of het account vermeldt, zodra de app en het account beide op het veld geabonneerd zijn. Elke reactie is één wijziging in de melding, en deze gevallen delen dezelfde vorm:
- Een nieuwe reactie op een post, een Reel, een Story of een advertentie, met media.
media_product_typedat aangeeft op welk oppervlak de media staat. - Een antwoord op een bestaande reactie, met
parent_idmet de ID van de reactie waarop wordt geantwoord. - Een reactie die het account zelf plaatst op de eigen media, inclusief de antwoorden: from.id is de eigen ID van het account, en from voegt
self_ig_scoped_idtoe. - Een @mention van het account: met Instagram Login neemt Meta vermeldingen op in de comments-melding, in plaats van in een apart veld.
- Een reactie tijdens een Live-uitzending komt op een apart veld,
live_comments, met dezelfde vorm van value, en stopt wanneer de uitzending eindigt.
Hoe ziet een comments-melding eruit?
Een POST waarvan de JSON object op instagram zet en een entry-array bevat. Elke entry is één professioneel account: de ID, het tijdstip waarop Meta de melding verstuurde, en een changes-array met één wijziging per reactie. Een antwoord op een Reel ziet er zo uit:
{
"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"
}
}
}
]
}
]
}Wat betekent elk veld?
De velden die de webhook-referentie van Meta voor een reactie noemt, van buiten naar binnen:
- entry[].id: de ID van het professionele account, de
user_iddie /me voor dat account teruggeeft. Hiermee zie je bij welk account de reactie hoort. - entry[].time: het moment waarop Meta de melding verstuurde, als Unix-tijdstempel. Het is niet het moment waarop de reactie is geschreven.
- changes[].field: comments, of
live_commentsvoor een Live-uitzending. Controleer dit voordat je value leest. - value.id: de ID van de reactie, degene om publiek of privé op te reageren, te verbergen of te verwijderen.
- value.text: de tekst van de reactie, opgenomen wanneer de reactie tekst bevat.
- value.from.id en value.from.username: het Instagram-scoped ID en de gebruikersnaam van de auteur. value.from.
self_ig_scoped_idverschijnt wanneer het account zelf de reactie schreef. - value.media.id en value.media.
media_product_type: de media waarop gereageerd is en het oppervlak; de media-referentie van Meta noemt AD, FEED, STORY en REELS. - value.
parent_id: bij een antwoord de ID van de reactie waarop wordt geantwoord. Een reactie op het hoogste niveau heeft die niet. - value.media.
ad_id,ad_titleenoriginal_media_id: vermeld in de referentie voor reacties op een advertentie.
Wat meldt het comments-veld niet?
Een aantal dingen die een handler misschien verwacht, ontbreekt in de gebeurtenis of wordt nooit verstuurd, volgens de installatiegids en referenties van Meta:
- Reacties op media van een privé-account: Meta stuurt daarvoor geen reactie- of vermeldingsmeldingen.
- Album-ID's: de gebeurtenis bevat ze niet, en Meta zegt het album op te zoeken met de ID van de reactie.
- Advertentie-ID's voor media die in dynamische advertenties worden gebruikt.
- Het aanmaakmoment van de reactie: GET /<
COMMENT_ID>?fields=timestamp geeft dat in ISO 8601 terug. - Live-reacties na afloop van de uitzending, wanneer de meldingen voor live-media stoppen.
- Story-vermeldingen, die Meta's mentions-API niet ondersteunt; ze bereiken het account in plaats daarvan als DM's.
- Gebeurtenissen uit het verleden: Meta bewaart geen meldingsgeschiedenis om te bevragen, dus sla op wat je nodig hebt zodra elke melding binnenkomt.
Wat heeft het comments-veld nodig?
Met Instagram Login de rechten instagram_business_basic en instagram_business_manage_comments, en Advanced Access, dat Meta vereist voor meldingen van comments en live_comments. De app moet Live zijn en geabonneerd op comments in het App Dashboard, en elk account moet geabonneerd worden via POST /<IG_ID>/subscribed_apps met comments tussen de subscribed_fields. Meta raadt deze webhook sterk aan boven polling voor reacties, omdat die de rate limit spaart.
Hoe reageer je op een reactie uit de gebeurtenis?
Met de ID's die erin staan. POST /<COMMENT_ID>/replies met een bericht plaatst een publiek antwoord onder de reactie, met value.id. POST /<IG_ID>/messages met recipient.comment_id gelijk aan value.id stuurt de auteur één privé-reactie, binnen 7 dagen na de reactie, of zolang de uitzending duurt bij een Live. from.id is een Instagram-scoped ID, maar een DM die rechtstreeks daarnaar wordt gestuurd mislukt totdat de persoon het account een bericht heeft gestuurd, dus de privé-reactie is de manier om via DM te bereiken.
Hoe stuurt easyCoexistence een reactie door?
Zodra die binnenkomt, nadat voor het account een eindpunt is ingesteld met set_social_webhook_destination vanuit Claude of ChatGPT, of met PUT /channels/:id/webhook op de Partner API. easyCoexistence abonneert elk verbonden account op de velden die de reacties, vermeldingen en DM's leveren, controleert de handtekening van Meta bij elke levering, antwoordt Meta direct en POST elke entry voor dat account naar je HTTPS-URL in een envelop:
- platform en
external_id: instagram, en de Instagram-ID van het account, gelijk aan entry.id. account_id: de ID van de verbinding in easyCoexistence, dezelfde dielist_social_accountsteruggeeft en de MCP-tools gebruiken.- entry: de entry van Meta voor het account, ongewijzigd, zodat een gebundelde levering één POST per entry wordt. Metas object-veld en X-Hub-Signature-256 worden niet doorgegeven.
- Levering: één poging, tot 8 seconden wachten, zonder redirects te volgen, naar een HTTPS-adres dat naar een publiek IP-adres resolveert. Er wordt geen kopie bewaard en niets opnieuw geprobeerd.
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" }
}
}
]
}
}Wat doen comment-naar-DM-regels met dezelfde gebeurtenis?
Ze lezen de gebeurtenis naast de doorgestuurde versie. Een regel komt overeen wanneer de reactie één van de trefwoorden bevat, ongeacht hoofdletters, op één gekozen post of op alle posts, en stuurt de auteur de DM van de regel als privé-reactie, plus een publiek antwoord als de regel er een heeft. Reacties van het account zelf worden overgeslagen, automatiseringen die bij een reactie starten nemen de reacties waarop geen regel heeft geantwoord, en een reactie waarop een regel heeft geantwoord bereikt nog steeds je eindpunt. Het publieke antwoord van de regel kan terugkomen als een nieuwe comments-gebeurtenis van het account zelf.
Veelgemaakte fouten
- comment_id zoeken. Onder Instagram Login staat de ID van de reactie in value.id; comment_id hoort bij de payloads van Metas andere inlogopstellingen.
- Reageren op de eigen reacties van het account. De antwoorden erop komen terug als comments-gebeurtenissen met from.id gelijk aan entry.id, en een automatisering die daarop antwoordt, praat uiteindelijk met zichzelf.
- entry.time lezen als het tijdstip van de reactie. Het registreert wanneer Meta de melding verstuurde; het eigen tijdstempelveld van de reactie zegt wanneer ze is geschreven.
- Wachten op Live-reacties in het comments-veld. Die komen op live_comments, dat een eigen abonnement nodig heeft en stil valt wanneer de uitzending eindigt.
Comment-naar-DM-regels en automatiseringen antwoorden op dezelfde reacties dag en nacht. US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Bevat de Instagram-webhook voor reacties ook antwoorden op reacties?
Ja. Een antwoord komt als eigen comments-gebeurtenis, met parent_id met de ID van de reactie waarop wordt geantwoord.
Vuurt de comments-webhook ook bij reacties op Reels?
Ja. Een reactie op een Reel komt op het comments-veld, net als een op een post, en media.media_product_type maakt het onderscheid.
Waarom vuurt mijn Instagram comments-webhook niet?
Meestal is de app niet Live of heeft die geen Advanced Access, is het account nooit geabonneerd via /subscribed_apps, behoort de media toe aan een privé-account, of stond de reactie bij een Live, die live_comments gebruikt.
Bevat de comments-webhook de gebruikersnaam van de reageerder?
Ja. value.from bevat de gebruikersnaam van die persoon naast hun Instagram-scoped ID, dus er is geen extra aanroep nodig om te tonen wie reageerde.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op