Instagram-vermeldingen via de API: vinden en beantwoorden
Instagram's API meldt @vermeldingen van een professioneel account in reacties en bijschriften op openbare media, en laat het account er direct op reageren. Met Instagram Login komen vermeldingen binnen via de reacties-webhook, en het antwoord gaat via POST /<IG_ID>/mentions met de media-ID, plus de reactie-ID voor een reactie, en wordt dan als reactie daar geplaatst.
easyCoexistence stuurt de reacties, vermeldingen en dm's van het Instagram-account naar jouw endpoint zodra ze binnenkomen, ondertekend met een geheim voor dat account, nadat je dat instelt met set_social_webhook_destination.
Webhook-melding die vermeldingen bevat voor apps die Instagram Login gebruiken.
Endpoint dat antwoordt op een reactie of bijschrift waarin een andere Instagram-gebruiker het account heeft @vermeld.
Media van een privéaccount activeert geen webhook voor een reactie of @vermelding erop.
Permissies die vermeldingen nodig hebben met Instagram Login: instagram_business_basic en instagram_business_manage_comments.
Hoe komen vermeldingen binnen?
Via webhook, zodra ze gebeuren. Met Instagram Login neemt Meta vermeldingen op in de reactiemelding in plaats van een apart mentions-veld te sturen, dus je code leest ze uit dezelfde gebeurtenissen als nieuwe reacties. Meta bewaart geen geschiedenis van eerdere meldingen, dus sla op wat je nodig hebt zodra een melding binnenkomt.
Welke vermeldingen dekt de API?
De mentions-API van Meta herkent bijschriften, reacties en media waarin een professioneel of creator-account is @vermeld of getagd:
- @vermeldingen in reacties.
- @vermeldingen in het bijschrift van een post.
- Media waarin het account getagd is, weergegeven via GET /<
IG_ID>/tags; reageren op foto's waarin het account alleen getagd is, wordt niet ondersteund. - Geen Stories: de mentions-API ondersteunt die niet, en een Story-vermelding komt bij het account aan als dm met als bijlagetype
story_mention. - Geen privéaccounts: media die zij bezitten, sturen geen vermeldings-webhooks.
Hoe antwoord je op een vermelding?
Met POST /<IG_ID>/mentions. Voor een vermelding in een reactie stuur je media_id en comment_id mee bij het bericht, en het antwoord verschijnt in de draad van die reactie; voor een vermelding in een bijschrift stuur je media_id en het bericht mee, en het wordt als reactie op de media geplaatst. Beide ID's komen uit de webhook-melding.
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>Wat hebben vermeldingen nodig?
Met Instagram Login de permissies instagram_business_basic en instagram_business_manage_comments, hetzelfde paar dat reactiemoderatie gebruikt, met aanroepen naar graph.instagram.com. Om professionele accounts te bedienen die de ontwikkelaar niet bezit of beheert, heeft de app ook Advanced Access nodig.
Veelgemaakte fouten
- Wachten op een apart mentions-event onder Instagram Login. Meta levert vermeldingen binnen de reactiemelding.
- Reageren op een vermelding in de post van een ander account alsof het een reactie op je eigen post is. De route van Meta daarvoor is POST /<IG_ID>/mentions, met de media-ID en, bij een reactie, de reactie-ID.
- Story-vermeldingen verwachten via de mentions-API. Meta ondersteunt ze daar niet; ze komen bij het account binnen als dm's.
- Rekenen op de webhook om oude vermeldingen opnieuw af te spelen. Meta bewaart geen meldingsgeschiedenis, dus sla elke vermelding op zodra ze binnenkomt.
De tools antwoorden op reacties onder je eigen posts met reply_to_comment; antwoorden op een vermelding in de post van iemand anders, waarvoor het mentions-endpoint van Meta nodig is, hoort daar niet bij. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan ik reageren op een foto waarin mijn account getagd is?
Nee. GET /<IG_ID>/tags toont de media waarin het account getagd is, maar Meta ondersteunt niet dat je reageert op foto's waarin het account alleen getagd is.
Kan ik op een vermelding in de post van iemand anders antwoorden?
Ja. POST /<IG_ID>/mentions met de media-ID, en de reactie-ID wanneer de vermelding in een reactie staat, plaatst het antwoord daar als het account.
Zijn Story-vermeldingen beschikbaar via de mentions-API?
Nee. Een Story-vermelding komt bij het account binnen als dm met als bijlagetype story_mention, en kan in dat gesprek een antwoord krijgen.
Waarom is een vermelding nooit binnengekomen?
De media kan van een privéaccount zijn, dat geen vermeldingsmeldingen stuurt, of de vermelding staat in een Story, die de mentions-API niet dekt.
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