Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Webhook messaging_referral d'Instagram : liens ig.me et références publicitaires

Le champ messaging_referral du webhook Instagram avertit une application lorsqu'une personne ayant déjà une conversation avec un compte professionnel ouvre un lien ig.me contenant un paramètre ref. L'événement contient un objet referral de premier niveau : ref, la valeur du paramètre ; source, SHORTLINKS ; et type, OPEN_THREAD. Une référence sur une nouvelle conversation arrive plutôt dans l'événement messages ou messaging_postbacks.

easyCoexistence abonne chaque compte Instagram connecté aux commentaires, aux messages et aux mentions, si bien qu'une référence sur le premier message d'un nouveau fil et une référence d'annonce Click-to-Direct arrivent à votre endpoint HTTPS dans le DM transmis, signé avec le secret de ce compte.

2,083

Nombre maximal de caractères que peut contenir un paramètre ref d'ig.me, avec uniquement des lettres, des chiffres, des tirets, des tirets bas et des signes égal.

OPEN_THREAD

Type de référence pour les liens ig.me ; une référence d'annonce Click-to-Direct l'utilise aussi, avec source ADS.

24 hours

Délai dont dispose l'application pour répondre après une référence dans une conversation existante, qui réinitialise la fenêtre standard.

7 days

Durée maximale de la fenêtre ouverte par un premier message envoyé après un clic sur une annonce Click-to-Direct.

Instagram Web

Cas où les liens ig.me ne sont pas pris en charge, selon le guide ig.me de Meta.

Quand messaging_referral se déclenche-t-il ?

Lorsqu'une personne ayant déjà une conversation avec le compte professionnel ouvre un lien ig.me contenant un paramètre ref. Instagram ouvre le fil existant et Meta envoie la référence de lui-même, sans message. L'endroit où arrive la référence dépend du fil et de l'action de la personne :

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.

À quoi ressemble une notification de référence ?

Un événement de messagerie dont l'objet referral se trouve à côté de sender, recipient et timestamp, sans message ni postback autour. Le guide ig.me de Meta donne les valeurs de la référence, dans la même enveloppe que les autres événements de messagerie Instagram :

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"
          }
        }
      ]
    }
  ]
}

Que signifie chaque champ ?

Les champs que Meta documente pour une référence ig.me, de l'extérieur vers l'intérieur :

  • sender.id : l'identifiant Instagram de la personne qui a ouvert le lien. recipient.id et entry[].id : le compte professionnel.
  • referral.ref : la valeur du paramètre ref du lien, telle que le lien la transporte.
  • referral.source : SHORTLINKS dans les exemples ig.me de Meta. Un tableau de son guide de messagerie Instagram écrit SHORTLINK, et sa page d'exemples affiche un espace réservé.
  • referral.type : OPEN_THREAD, valeur que Meta utilise pour les références ig.me.
  • timestamp : moment où l'événement a été déclenché, en millisecondes dans les exemples de Meta.

Comment construire un lien ig.me avec un ref ?

Sous la forme https://ig.me/<USERNAME>?ref=<VALUE>, où USERNAME est l'identifiant du compte professionnel, selon le guide Instagram Login de Meta ; son guide de messagerie Instagram écrit https://ig.me/m/<USERNAME>. Le ref peut atteindre 2 083 caractères, composés de lettres, de chiffres, de tirets, de tirets bas et de signes égal. Meta conseille d'utiliser des ref pour suivre des canaux, rattacher une personne à une session d'une autre application ou la diriger vers un contenu précis, et recommande des ice breakers, chacun avec son propre ref, pour les nouvelles conversations.

Où arrivent les références publicitaires ?

Dans les messages. Une personne qui clique sur une annonce ouvrant Instagram Direct et envoie un message produit un événement messages dont message.referral contient le ref de l'annonce s'il a été défini, ad_id, source ADS, type OPEN_THREAD et ads_context_data avec le titre de l'annonce ainsi que la photo_url ou la video_url cliquée. Les pages Instagram de Meta ne documentent messaging_referral que pour les liens ig.me.

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>"
    }
  }
}

Une référence ouvre-t-elle la fenêtre de messagerie ?

Oui, dans un fil existant : le guide ig.me de Meta indique que la référence réinitialise la fenêtre de messagerie standard de 24 heures, de sorte que l'application peut répondre dans les 24 heures suivant l'événement. Un premier message envoyé après un clic sur une annonce Click-to-Direct peut ouvrir une fenêtre allant jusqu'à 7 jours à partir de ce message. Répondez avec POST /<IG_ID>/messages en définissant recipient.id sur le sender.id de l'événement.

easyCoexistence transmet-il les références ?

Celles qui passent par les messages. Chaque compte Instagram connecté est abonné aux commentaires, aux messages et aux mentions ; une référence sur le premier message d'un nouveau fil et une référence d'annonce Click-to-Direct arrivent donc à votre endpoint dans le DM transmis, sous la forme message.referral. messaging_referral, pour les fils existants, et messaging_postbacks, pour les appuis sur les ice breakers, sont des champs distincts que Meta livre aux applications qui y sont abonnées.

Erreurs courantes

  • Attendre messaging_referral sur une nouvelle conversation. Le ref y arrive dans messages ou messaging_postbacks, selon que la personne a écrit un message ou appuyé sur un ice breaker.
  • Mettre d'autres caractères dans ref. Meta accepte les lettres, les chiffres, les tirets, les tirets bas et les signes égal, jusqu'à 2 083 caractères.
  • Comparer source à une seule chaîne exacte. Les exemples de Meta affichent SHORTLINKS pour ig.me et ADS pour les annonces, mais l'un de ses tableaux écrit SHORTLINK ; identifiez donc la référence selon son emplacement et selon ref.
  • Tester les liens sur Instagram Web. Meta ne prend pas en charge les liens ig.me là-bas ; ouvrez-les donc dans l'application Instagram.
Faire cela avec EasyCoexistence

send_social_dm répond dans la fenêtre de 24 heures. De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec les 3 premiers jours offerts.

Questions fréquemment posées

Que contient referral.source dans une référence Instagram ?

SHORTLINKS dans les exemples ig.me de Meta et ADS pour une annonce Click-to-Direct, bien qu'un tableau du guide de messagerie Instagram de Meta écrive SHORTLINK. Identifiez la référence selon son emplacement et selon ref plutôt que sur une chaîne exacte.

Quelle est la longueur maximale du paramètre ref d'un lien ig.me ?

Jusqu'à 2 083 caractères, uniquement des lettres, des chiffres, des tirets, des tirets bas et des signes égal.

Où arrive un ref ig.me sur une nouvelle conversation Instagram ?

Dans messages lorsque la personne envoie un premier message, ou dans messaging_postbacks lorsqu'elle appuie sur un ice breaker. messaging_referral ne concerne que les fils existants.

Les liens ig.me fonctionnent-ils sur Instagram Web ?

Non. Le guide ig.me de Meta indique qu'ils ne sont pas pris en charge sur Instagram Web.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le