Instagram messaging_referral-Webhook: ig.me-Links und Anzeigen-Referrals
Das Instagram-Feld messaging_referral benachrichtigt eine App, wenn eine Person, die bereits eine Unterhaltung mit einem Professional-Konto hat, einen ig.me-Link mit einem ref-Parameter öffnet. Das Ereignis enthält ein referral-Objekt auf oberster Ebene: ref, den Wert des Parameters; source, SHORTLINKS; und type, OPEN_THREAD. Ein ref in einer neuen Unterhaltung kommt stattdessen im Ereignis messages oder messaging_postbacks an.
easyCoexistence abonniert jedes verbundene Instagram-Konto für comments, messages und mentions, sodass ein ref in der ersten Nachricht eines neuen Chats und ein Referral aus einer Click-to-Direct-Anzeige Ihren HTTPS-Endpoint innerhalb der weitergeleiteten DM erreichen, signiert mit dem Secret dieses Kontos.
Höchstzahl an Zeichen, die ein ig.me-ref-Parameter enthalten kann, nur Buchstaben, Ziffern, Bindestriche, Unterstriche und Gleichheitszeichen.
Referral-Typ für ig.me-Links; ein Referral aus einer Click-to-Direct-Anzeige nutzt ihn ebenfalls, mit source ADS.
Zeit, die die App nach einem Referral in einer bestehenden Unterhaltung zum Antworten hat; dadurch wird das Standardfenster zurückgesetzt.
Wie lange das Fenster dauern kann, wenn die erste Nachricht nach dem Klick auf eine Click-to-Direct-Anzeige gesendet wird.
Wo ig.me-Links laut Metas ig.me-Leitfaden nicht unterstützt werden.
Wann wird messaging_referral ausgelöst?
Wenn eine Person, die bereits eine Unterhaltung mit dem Professional-Konto hat, einen ig.me-Link mit einem ref-Parameter öffnet. Instagram öffnet den bestehenden Chat, und Meta sendet das Referral von selbst, ohne Nachricht. Wo ein ref ankommt, hängt von dem Chat und davon ab, was die Person tut:
Wie sieht eine Referral-Benachrichtigung aus?
Ein Messaging-Ereignis, dessen referral-Objekt neben sender, recipient und timestamp steht, ohne message oder postback drum herum. Metas ig.me-Leitfaden nennt die Werte des Referrals innerhalb derselben Hülle wie die übrigen Instagram-Messaging-Ereignisse:
{
"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"
}
}
]
}
]
}Was bedeutet jedes Feld?
Die Felder, die Meta für ein ig.me-Referral dokumentiert, von außen nach innen:
- sender.id: die Instagram-scoped ID der Person, die den Link geöffnet hat. recipient.id und entry[].id: das Professional-Konto.
- referral.ref: der Wert des ref-Parameters des Links, so wie der Link ihn trug.
- referral.source: SHORTLINKS in Metas ig.me-Beispielen. Eine Tabelle im Instagram-Messaging-Leitfaden schreibt SHORTLINK, und deren Beispielseite zeigt einen Platzhalter.
- referral.type:
OPEN_THREAD, das Meta für ig.me-Referrals verwendet. - timestamp: Zeitpunkt, zu dem das Ereignis ausgelöst wurde, in Millisekunden in Metas Beispielen.
Wie baut man einen ig.me-Link mit ref?
Als https://ig.me/<USERNAME>?ref=<VALUE>, wobei USERNAME der Handle des Professional-Kontos ist, laut Metas Instagram-Login-Leitfaden; dessen Instagram-Messaging-Leitfaden schreibt https://ig.me/m/<USERNAME>. Das ref darf bis zu 2,083 Zeichen aus Buchstaben, Ziffern, Bindestrichen, Unterstrichen und Gleichheitszeichen lang sein. Meta empfiehlt refs, um Kanäle zu erfassen, eine Person einer Sitzung in einer anderen App zuzuordnen oder auf bestimmte Inhalte zu verweisen, und empfiehlt Ice Breaker, jeweils mit eigenem ref, für neue Unterhaltungen.
Wo kommen Anzeigen-Referrals an?
In messages. Eine Person, die auf eine Anzeige klickt, die Instagram Direct öffnet und eine Nachricht sendet, erzeugt ein messages-Ereignis, dessen message.referral den ref der Anzeige enthält, falls einer gesetzt wurde, ad_id, source ADS, type OPEN_THREAD und ads_context_data mit dem Titel der Anzeige sowie der angeklickten photo_url oder video_url. Metas Instagram-Seiten dokumentieren messaging_referral nur für ig.me-Links.
"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>"
}
}
}Öffnet ein Referral das Messaging-Fenster?
Ja, in einem bestehenden Chat: Metas ig.me-Leitfaden besagt, dass das Referral das 24-Stunden-Standardfenster zurücksetzt, sodass die App innerhalb von 24 Stunden nach dem Ereignis antworten kann. Eine erste Nachricht nach dem Klick auf eine Click-to-Direct-Anzeige kann ein Fenster von bis zu 7 Tagen ab dieser Nachricht öffnen. Antworten Sie mit POST /<IG_ID>/messages und recipient.id gleich der sender.id des Ereignisses.
Leitet easyCoexistence Referrals weiter?
Die, die über messages laufen. Jedes verbundene Konto ist für comments, messages und mentions abonniert, sodass ein ref in der ersten Nachricht eines neuen Chats und ein Referral aus einer Click-to-Direct-Anzeige Ihren Endpoint innerhalb der weitergeleiteten DM erreichen, als message.referral. messaging_referral für bestehende Chats und messaging_postbacks für Ice-Breaker-Antippen sind eigene Felder, die Meta an eine App liefert, die sie abonniert hat.
Häufige Fehler
- Auf messaging_referral in einer neuen Unterhaltung warten. Dort kommt der ref in messages oder messaging_postbacks an, je nachdem, ob die Person geschrieben oder einen Ice Breaker angetippt hat.
- Andere Zeichen in ref verwenden. Meta akzeptiert Buchstaben, Ziffern, Bindestriche, Unterstriche und Gleichheitszeichen, bis zu 2,083 Zeichen.
- source mit einem einzigen exakten Wert vergleichen. Metas Beispiele zeigen SHORTLINKS für ig.me und ADS für Anzeigen, eine Tabelle schreibt jedoch SHORTLINK. Unterscheiden Sie anhand der Position des Referrals und von ref.
- Links in Instagram Web testen. Meta unterstützt ig.me-Links dort nicht; öffnen Sie sie in der Instagram-App.
send_social_dm antwortet innerhalb des 24-Stunden-Fensters. US$ 9 bis US$ 0.75 pro Verbindung und Monat, wobei der Preis mit jeder weiteren Verbindung sinkt, mit 3 Tagen kostenloser Testphase.
Häufig gestellte Fragen
Was enthält referral.source bei einem Instagram-Referral?
SHORTLINKS in Metas ig.me-Beispielen und ADS bei einer Click-to-Direct-Anzeige, auch wenn eine Tabelle im Instagram-Messaging-Leitfaden von Meta SHORTLINK schreibt. Unterscheiden Sie anhand der Position des Referrals und von ref, statt sich auf einen exakten Wert zu verlassen.
Wie lang darf ein ig.me-ref-Parameter sein?
Bis zu 2,083 Zeichen, und zwar nur Buchstaben, Ziffern, Bindestriche, Unterstriche und Gleichheitszeichen.
Wo kommt ein ig.me-ref in einer neuen Instagram-Unterhaltung an?
In messages, wenn die Person eine erste Nachricht schreibt, oder in messaging_postbacks, wenn sie einen Ice Breaker antippt. messaging_referral gilt nur für bestehende Chats.
Funktionieren ig.me-Links in Instagram Web?
Nein. Metas ig.me-Leitfaden besagt, dass sie in Instagram Web nicht unterstützt werden.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am