InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram webhook-velden: de volledige lijst

Voor een professioneel account op Instagram Login somt de tabel met webhook-velden van Meta op: comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover en standby, waarbij mentions binnen comments wordt geleverd. De voorbeelden voegen message_edit toe. Elk veld vereist instagram_business_basic plus instagram_business_manage_comments of, voor de meeste berichtenvelden, instagram_business_manage_messages. story_insights wordt bij Instagram Login niet aangeboden.

easyCoexistence abonneert elk verbonden Instagram-account op comments, messages en mentions, en stuurt die gebeurtenissen zodra ze binnenkomen door naar je HTTPS-endpoint, ondertekend met het geheim van dat account.

8

Velden waarop een nieuw Instagram-product in het App Dashboard standaard is geabonneerd, waaronder comments, messages en message_reactions.

Per app

Velden worden per app geselecteerd, niet per account: een account ontvangt de velden die de app heeft geselecteerd.

Advanced Access

Toegangsniveau dat de installatiegids van Meta vermeldt voor webhooks van Instagram Login, en dat vereist is voor meldingen van comments en live_comments.

story_insights

In de velden-tabel van Meta als niet beschikbaar voor Instagram Login gemarkeerd, terwijl het beschikbaar is bij Facebook Login en Unified Login.

10 Sep 2025

Het moment waarop Meta de message_edit-webhook introduceerde voor Business Login for Instagram en Facebook Login for Business.

Welke webhook-velden biedt Instagram Login?

Dit zijn de velden uit de velden-tabel van Meta, met wat elk veld activeert volgens de voorbeelden en de webhook-referentie. Elk veld vereist daarnaast instagram_business_basic naast de getoonde machtiging, en Meta vereist Advanced Access voor meldingen van comments en live_comments.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

Welke velden zijn niet beschikbaar met Instagram Login?

Drie rijen in de velden-tabel van Meta hebben geen machtiging voor Instagram Login, dus een app op Instagram Login ontvangt ze niet, en één extra veld bestaat alleen buiten Instagram Login:

  • story_insights: de statistieken van een Story wanneer die verloopt, met Facebook Login of Unified Login en instagram_manage_insights. De referentie voor media-insights van Meta zegt dat de insights-webhook niet wordt ondersteund met Instagram Login.
  • messaging_policy_enforcement en response_feedback: alleen in de kolom van de Instagram Messaging API van Meta.
  • mentions als eigen veld: Facebook Login en Unified Login vermelden het, met instagram_manage_comments, terwijl Instagram Login mentions onderbrengt in comments.

Hoe abonneer je je op velden?

Op twee plekken. Sla in het App Dashboard, onder de webhook-instellingen van het Instagram-product, de callback-URL en het verificatie-token op, wat het verificatieverzoek van Meta activeert, en selecteer daarna de velden; een nieuw Instagram-product is standaard op acht ervan geabonneerd. Abonneer vervolgens elk account met POST /<IG_ID>/subscribed_apps op graph.instagram.com, met subscribed_fields ingesteld op de in het dashboard geselecteerde velden, gescheiden door komma's.

Subscribing one account to three fields
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
  ?subscribed_fields=comments,messages,message_reactions
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{ "success": true }

Kan elk account andere velden krijgen?

Nee. De installatiegids van Meta zegt dat velden niet per account van de app-gebruiker kunnen worden geselecteerd: een account ontvangt de velden die voor de app zijn geselecteerd. subscribed_fields op het abonnement van het account moet de velden van het dashboard weergeven, dus een verwerkingsroutine moet elk veld verwachten dat de app heeft geselecteerd en beslissen op basis van wat elke gebeurtenis bevat, niet op basis van wat één account ervoor vroeg.

Hoe herken je de velden in een melding?

Aan de vorm van de entry. Comments-velden komen aan in een changes-array, waarbij elke wijziging zijn veld benoemt. Berichtenvelden komen aan in een messaging-array zonder veldnaam, en de sleutel naast sender, recipient en timestamp onderscheidt ze:

  • changes[].field: comments of live_comments, met de reactie in value.
  • message: messages, inclusief echo's van de eigen berichten van het account, die is_echo ingesteld hebben op true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral naast sender: messaging_referral. Een referral binnen message hoort bij messages, uit een nieuw gesprek of een Click-to-Direct-advertentie.
  • pass_thread_control, take_thread_control of request_thread_control: messaging_handover, zoals de webhook-referentie van Meta ze vermeldt.

Welke velden abonneert easyCoexistence?

comments, messages en mentions, de lijst waarop elk Instagram-account bij het verbinden wordt geabonneerd. Met Instagram Login komen de mentions binnen comments, dus het abonnement dekt reacties en DM's, met echo's, Story-antwoorden, Story-vermeldingen en bijlagen onder de DM's. De overige velden in de tabel levert Meta aan een app die erop geabonneerd is, en die horen niet bij het abonnement van een verbinding. Zodra een endpoint is ingesteld met set_social_webhook_destination of de Partner API, controleert easyCoexistence de handtekening van Meta, antwoordt Meta direct en stuurt elke entry voor het account als POST naar het endpoint:

  • platform en external_id: instagram, en het Instagram-ID van het account, gelijk aan entry.id.
  • account_id: het ID van de verbinding in easyCoexistence, dat de MCP-tools gebruiken.
  • entry: Meta's entry voor het account, ongewijzigd. Meta's object-veld en de X-Hub-Signature-256-header worden niet doorgegeven.
  • X-EC-Signature: t=<unix>,v1=<hex>, een HMAC-SHA256 van het tijdstempel, een punt en de ruwe body, ondertekend met het eigen geheim van het account.
  • Aflevering: één poging van maximaal 8 seconden, zonder omleidingen te volgen, zonder kopie te bewaren en zonder nieuwe pogingen.

Veelgemaakte fouten

  • Wachten op een mentions-veld met Instagram Login. Meta voegt mentions toe aan de comments-melding, dus een verwerker die op het veld mentions let, draait nooit.
  • Aannemen dat een account alleen de velden krijgt die het eigen abonnement noemde. Meta levert de velden die voor de app zijn geselecteerd, dus vertak op wat elke gebeurtenis bevat.
  • message.referral en een referral op het hoogste niveau als één gebeurtenis zien. De eerste hoort bij messages; de tweede is messaging_referral, voor een ig.me-link die in een bestaand gesprek is geopend.
  • Wachten op story_insights met Instagram Login. Meta markeert het daar als niet beschikbaar, dus lees de statistieken van een Story uit het insights-endpoint zolang die nog actief is.
Dit doen met EasyCoexistence

Gebeurtenissen worden standaard niet opgeslagen; een account met een ingeschakelde automatisering bewaart de DM's en reacties 7 dagen. Stel het endpoint in met set_social_webhook_destination vanuit Claude of ChatGPT, of met de Partner API. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met 3 dagen gratis proefperiode.

Veelgestelde vragen

Heeft Instagram Login een webhook-veld voor mentions?

Niet een apart veld. Meta voegt mentions toe aan de comments-melding voor Instagram Login; mentions is een eigen veld bij Facebook Login en Unified Login.

Is story_insights beschikbaar met Instagram Login?

Nee. De velden-tabel van Meta markeert het als niet beschikbaar voor Instagram Login, en de referentie voor media-insights zegt dat de insights-webhook daar niet wordt ondersteund.

Welke machtigingen heeft de webhook voor Instagram-berichten nodig?

instagram_business_basic en instagram_business_manage_messages, met Advanced Access, dat de installatiegids van Meta vermeldt voor webhooks van Instagram Login.

Wanneer heeft Meta de message_edit-webhook voor Instagram toegevoegd?

Op 10 september 2025, voor Business Login for Instagram en Facebook Login for Business. Een bewerking komt aan in de messaging-array onder een message_edit-sleutel.

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