ig.me
ist ein Dienst von Meta für verkürzte URLs, der Nutzer*innen zu einer Instagram-Unterhaltung weiterleitet. Du kannst die URLs auf deiner Webseite, in E-Mail-Newslettern und anderen Elementen verwenden.
Wenn Nutzer*innen einen ig.me-Link verwenden, um eine Unterhaltung mit deinem Instagram-Konto zu beginnen oder fortzusetzen, werden sie zu einem neuen oder vorhandenen Thread weitergeleitet – je nachdem, ob sie deinem Instagram-Konto bereits eine Nachricht gesendet haben.
Das Linkformat sieht wie folgt aus:
https://ig.me/m/
USERNAME
ist der Handle des Instagram-Kontos.
Mit diesen Links kannst du einen Weiterleitungsparameter übergeben.
Weiterleitungsparameter erfüllen folgende Zwecke:
Das ist ein ig.me-Link mit einem zusätzlichen Parameter:
https://ig.me/m/
REF_PARAM
wird mithilfe eines Webhooks an den Server übergeben.
Du kannst ig.me-Links nur richtig verwenden, wenn du folgende Voraussetzungen erfüllst:
Der Weiterleitungsabschnitt entspricht stets diesem Format:
"referral": {
"ref": "ref_data_in_ig_dot_me_param"
"source": "SHORTLINKS"
"type": "OPEN_THREAD"
}
Feldwert | Beschreibung |
---|---|
| Die beliebigen Daten, die ursprünglich im an den ig.me-Link angehängten |
| Die Quelle dieser Weiterleitung. Bei ig.me-Links ist der Wert von „source“ |
| Die ID für die Weiterleitung. Bei einer Weiterleitung von ig.me-Links lautet diese immer |
Wenn ein ig.me-Link mit einem ref
-Parameter die Instagram-App öffnet, gibt es drei mögliche Szenarien:
Wenn du für dein Instagram-Konto Eisbrecher eingerichtet hast und Nutzer*innen einen Eisbrecher antippen, empfängt deine App das Webhook-Event messaging_postback
, das den übergebenen Weiterleitungsparameter enthält.
Das messaging_postback
-Webhook-Event hat folgendes Format:
{
"object": "instagram",
"entry": [
{
"id": "
Im obigen Beispiel verweist USER_DEFINED_PAYLOAD
auf die Payload, die du zuvor für das Senden im Postback konfiguriert hast.
Wenn du für dein Instagram-Konto Eisbrecher eingerichtet hast und Nutzer*innen keinen Eisbrecher antippen, sondern stattdessen über das Eingabefeld eine Nachricht senden, empfängt deine App das Webhook-Event messages
, das den übergebenen Weiterleitungsparameter enthält.
Das messages
-Webhook-Event hat folgendes Format:
{
"object": "instagram",
"entry": [
{
"id": "
Wenn es bereits ein Thread zwischen einem*einer Nutzer*in und deinem Unternehmen auf Instagram gibt, wird dieser Thread geöffnet, wenn der*die Nutzer*in deinem ig.me-Link folgt. Um über die Weiterleitung informiert zu werden, muss dein Webhook das Event messaging_referral
abonniert haben.
Durch diese Handlung wird das 24-stündige Zeitfenster für Standardnachrichten zurückgesetzt. Dadurch kann die App antworten, nachdem sie das Webhook-Event mit dem ref
-Parameter empfangen hat.
Das messaging_referral
-Webhook-Event verfügt über folgendes Format:
{
"object": "instagram",
"entry": [
{
"id": "
So kannst du ig.me-Links beispielsweise verwenden:
Neue Threads | Vorhandene Threads |
---|---|
Der*die Nutzer*in erhält folgenden Text von uns: Du hast diese Unterhaltung über einen Link geöffnet. | Der*die Nutzer*in erhält folgenden Text von uns: Du hast diese Unterhaltung über einen Link geöffnet. |
ig.me-Links werden von Instagrams Webversion aktuell nicht unterstützt.