InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram messaging_referral-webhook: ig.me-links en advertentieverwijzingen

Het messaging_referral-veld van de Instagram-webhook meldt een app wanneer iemand die al een gesprek heeft met een professioneel account een ig.me-link met een ref-parameter opent. Het event bevat een referral-object op het hoogste niveau: ref, de waarde van de parameter; source, SHORTLINKS; en type, OPEN_THREAD. Een ref bij een nieuw gesprek komt in plaats daarvan binnen in het messages- of messaging_postbacks-event.

easyCoexistence abonneert elk gekoppeld Instagram-account op opmerkingen, berichten en vermeldingen, zodat een ref op het eerste bericht van een nieuw gesprek en de referral van een Click-to-Direct-advertentie je HTTPS-endpoint bereiken binnen de doorgestuurde DM, ondertekend met het geheim van dat account.

2,083

Het maximale aantal tekens dat de ref-parameter van een ig.me-link kan bevatten, met alleen letters, cijfers, koppeltekens, underscores en gelijktekens.

OPEN_THREAD

Het referral-type voor ig.me-links; de referral van een Click-to-Direct-advertentie gebruikt dit type ook, met source ADS.

24 hours

De tijd waarin de app kan antwoorden na een referral in een bestaand gesprek, die het standaard 24-uursvenster opnieuw start.

7 days

Hoe lang het venster kan duren na een eerste bericht dat na de klik op een Click-to-Direct-advertentie is verstuurd.

Instagram Web

Waar ig.me-links niet worden ondersteund, volgens de ig.me-gids van Meta.

Wanneer wordt messaging_referral verstuurd?

Wanneer iemand die al een gesprek heeft met het professionele account een ig.me-link met een ref-parameter opent. Instagram opent het bestaande gesprek en Meta stuurt de referral zelfstandig, zonder bericht. Waar een ref terechtkomt, hangt af van het gesprek en van wat de persoon doet:

Existing threadmessaging_referral: a referral object beside sender, with no message.
New thread, ice breaker tappedmessaging_postbacks: postback.referral beside title and payload.
New thread, message typedmessages: message.referral beside mid.
Click-to-Direct admessages: message.referral with source ADS, ad_id and ads_context_data.

Hoe ziet een referral-melding eruit?

Een messaging-event waarvan het referral-object naast sender, recipient en timestamp staat, zonder bericht of postback eromheen. De ig.me-gids van Meta geeft de waarden van de referral, binnen dezelfde envelop als de andere Instagram-messaging-events:

A messaging_referral notification
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "referral": {
            "ref": "<REF_PARAMETER_VALUE>",
            "source": "SHORTLINKS",
            "type": "OPEN_THREAD"
          }
        }
      ]
    }
  ]
}

Wat betekent elk veld?

De velden die Meta voor een ig.me-referral documenteert, van buiten naar binnen:

  • sender.id: de Instagram-scoped ID van de persoon die de link opende. recipient.id en entry[].id: het professionele account.
  • referral.ref: de waarde van de ref-parameter van de link, zoals de link die bevatte.
  • referral.source: SHORTLINKS in de ig.me-voorbeelden van Meta. Eén tabel in de Instagram Messaging-gids schrijft SHORTLINK, en de voorbeeldpagina toont een plaatsaanduiding.
  • referral.type: OPEN_THREAD, dat Meta gebruikt voor ig.me-referrals.
  • timestamp: het moment waarop het event werd geactiveerd, in milliseconden in de voorbeelden van Meta.

Hoe bouw je een ig.me-link met een ref?

Als https://ig.me/<USERNAME>?ref=<VALUE>, waarbij USERNAME de handle van het professionele account is, volgens de Instagram Login-gids van Meta; de Instagram Messaging-gids schrijft https://ig.me/m/<USERNAME>. De ref kan tot 2.083 tekens lang zijn, met letters, cijfers, koppeltekens, underscores en gelijktekens. Meta raadt refs aan om kanalen te volgen, een persoon aan een sessie in een andere app te koppelen of mensen naar specifieke content te sturen, en adviseert ice breakers, elk met een eigen ref, voor nieuwe gesprekken.

Waar komen advertentie-referrals binnen?

In messages. Iemand die op een advertentie klikt die Instagram Direct opent en een bericht stuurt, veroorzaakt een messages-event waarvan message.referral de ref van de advertentie bevat, als die is ingesteld, ad_id, source ADS, type OPEN_THREAD en ads_context_data met de titel van de advertentie en de photo_url of video_url waarop is geklikt. De Instagram-pagina's van Meta documenteren messaging_referral alleen voor ig.me-links.

A Click-to-Direct ad referral, inside messages
"message": {
  "mid": "<MESSAGE_ID>",
  "referral": {
    "ref": "<AD_REF_IF_SET>",
    "ad_id": "<AD_ID>",
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ads_context_data": {
      "ad_title": "<AD_TITLE>",
      "photo_url": "<IMAGE_URL_CLICKED>",
      "video_url": "<THUMBNAIL_URL_FOR_THE_AD_VIDEO>"
    }
  }
}

Opent een referral het berichtenvenster?

Ja, in een bestaand gesprek: de ig.me-gids van Meta zegt dat de referral het standaard 24-uursvenster opnieuw start, zodat de app binnen 24 uur na het event kan antwoorden. Een eerste bericht na de klik op een Click-to-Direct-advertentie kan een venster openen van maximaal 7 dagen vanaf dat bericht. Antwoord met POST /<IG_ID>/messages en recipient.id gelijk aan de sender.id van het event.

Stuurt easyCoexistence referrals door?

De referrals die via messages binnenkomen. Elk gekoppeld account is ingeschreven voor opmerkingen, berichten en vermeldingen, dus een ref op het eerste bericht van een nieuw gesprek en de referral van een Click-to-Direct-advertentie komen bij je endpoint aan in de doorgestuurde DM, als message.referral. messaging_referral, voor bestaande gesprekken, en messaging_postbacks, voor taps op ice breakers, zijn afzonderlijke velden die Meta levert aan een app die erop is ingeschreven.

Veelgemaakte fouten

  • Wachten op messaging_referral bij een nieuw gesprek. Daar komt de ref binnen via messages of messaging_postbacks, afhankelijk van of de persoon typte of op een ice breaker tikte.
  • Andere tekens in ref gebruiken. Meta accepteert letters, cijfers, koppeltekens, underscores en gelijktekens, tot 2.083 tekens.
  • source tegen één exacte tekst vergelijken. De voorbeelden van Meta tonen SHORTLINKS voor ig.me en ADS voor advertenties, maar één tabel schrijft SHORTLINK, dus vertak op waar de referral staat en op ref.
  • Links testen op Instagram Web. Meta ondersteunt ig.me-links daar niet, dus open ze in de Instagram-app.
Dit doen met EasyCoexistence

send_social_dm antwoordt binnen het 24-uursvenster. Van US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Wat bevat referral.source in een Instagram-referral?

SHORTLINKS in de ig.me-voorbeelden van Meta en ADS voor een Click-to-Direct-advertentie, al schrijft één tabel in de Instagram Messaging-gids van Meta SHORTLINK. Vertak op waar de referral staat en op ref, niet op één exacte tekst.

Hoe lang kan een ig.me ref-parameter zijn?

Tot 2.083 tekens, met alleen letters, cijfers, koppeltekens, underscores en gelijktekens.

Waar komt een ig.me ref binnen bij een nieuw Instagram-gesprek?

In messages wanneer de persoon een eerste bericht typt, of in messaging_postbacks wanneer die op een ice breaker tikt. messaging_referral geldt alleen voor bestaande gesprekken.

Werken ig.me-links op Instagram Web?

Nee. De ig.me-gids van Meta zegt dat ze op Instagram Web niet worden ondersteund.

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