Liens m.me

Ce document présente comment créer des liens m.me pour votre expérience Messenger.

m.me est un service d’URL fourni par Meta qui redirige les utilisateur·ices vers une personne, une page ou une conversation dans Messenger. Vous pouvez utiliser ces liens sur votre site web et dans vos newsletters par e-mail, entre autres.

Fonctionnement

Le format d’un lien m.me ressemble à ce qui suit, où PAGE-NAME est la Page Facebook associée à votre application de messagerie.

http://m.me/PAGE-NAME

Lorsqu’une personne clique sur un lien m.me, elle est redirigée vers une nouvelle conversation avec votre entreprise ou vers une conversation déjà engagée avec celle-ci. Un message par défaut s’affiche dans la conversation indiquant : « Vous avez rejoint cette conversation en suivant un lien. Nous avons informé PAGE-NAME de votre présence. »

Vous pouvez inclure le paramètre text pour ajouter un message personnalisé.

http://m.me/PAGE-NAME?text=Hello%20and%20Welcome

Les entreprises peuvent partager des liens qui redirigent l’utilisateur·ice vers des sites web ou d’autres fils de discussion. Certains d’entre eux peuvent contenir du texte prédéfini.

Lorsqu’une personne clique sur le bouton Démarrer pour engager une conversation avec votre entreprise, une notification webhook messaging_postbacks est envoyée à votre serveur webhook. Dans le cadre de cette notification webhook, l’objet postback contient un objet referral avec le paramètre ref.

Quand une personne clique sur un lien m.me et qu’une conversation existe déjà entre elle et votre entreprise, le lien lui permet d’accéder à la conversation existante. Cette action réinitialise la fenêtre de message standard de 24 heures permettant à votre application de messagerie de répondre à la personne. De plus, une notification webhook messaging_referrals est envoyée à votre serveur webhook. Dans le cadre de cette notification webhook, un paramètre ref provenant du lien m.me est inclus.

Paramètres de référence

Un lien m.me peut contenir un paramètre ref qui, lorsqu’une personne clique sur le lien, fournit à votre entreprise davantage de contexte sur la conversation, par exemple un lien vers votre site web ou un lien dans un magasin. Ces types de liens peuvent également rediriger l’utilisateur·ice vers un contenu ou une fonctionnalité spécifique dans votre expérience Messenger.


http://m.me/PAGE-NAME?ref=REF-PARAMETER-INFORMATION

Codes QR

Les liens m.me contenant des paramètres ref peuvent être intégrés dans des codes QR. Les codes compatibles QR peuvent être lus avec la caméra native d’un téléphone. Dans ce cas, ils ouvrent l’application Messenger et la conversation par messages avec votre entreprise.

Exemple de code QR

Le code QR fourni ici possède un code http://m.me/OriginalCoastClothing?ref=summer_coupon qui déclenche un processus concernant un bon de réduction sur Messenger.

Notification webhook

Quand vous recevez une notification webhook, elle contient des informations émanant d’une personne qui a engagé une conversation avec votre entreprise ou d’une personne qui entretient déjà une conversation avec votre entreprise.

Lancer une conversation

Lorsqu’une personne clique sur le bouton Démarrer pour engager une conversation avec votre entreprise, nous envoyons le paramètre ref dans le cadre de la notification webhook messaging_postbacks.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

Poursuivre une conversation existante

Si une conversation existe déjà entre votre entreprise et la personne qui a cliqué sur le lien m.me, le lien vers la notification webhook messaging_referrals est envoyé.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

Avant de commencer

Dans ce guide, nous partons du principe que vous avez lu la présentation de la plateforme Messenger et implémenté les composants nécessaires pour envoyer et recevoir des messages et des notifications.

Vous aurez besoin des éléments suivants :

Une offre Advanced Access pour l’application associée à la page Facebook de votre entreprise
Un bouton Démarrer pour votre expérience Messenger concernant les nouvelles conversations
L’application associée à la Page Facebook de votre entreprise doit être abonnée aux champs de webhooks messaging_postbacks et messaging_referrals

Limites

Les applications avec accès standard peuvent uniquement obtenir des informations de personnes qui disposent d’un rôle de développeur·euse, testeur·euse ou admin dans votre application de messagerie.

Demandes d’inscription aux messages marketing

L’URL m.me/rn vous permet de créer une demande d’abonnement aux notifications récurrentes à l’aide d’un lien m.me. Le format d’un lien m.me/rn doit inclure le sujet de la notification récurrente. Vous pouvez définir la cadence de la notification récurrente, sinon elle sera quotidienne par défaut.

http://m.me/rn/PAGE-NAME?topic=TOPIC&cadence=MESSAGE-FREQUENCY

Limites

La version 383 d’iOS est requise pour que les liens m.me/rn fonctionnent correctement. La personne qui a cliqué sur votre lien sera redirigée vers votre URL m.me de base, l’URL http://m.me/PAGE-NAME.

Exemple de lien de messages marketing

https://m.me/rn/OriginalCoastClothing?topic=weekly%20deals&cadence=weekly

Enregistrer votre sujet

Avant de pouvoir utiliser votre URL m.me/rn avec un nouveau sujet, vous devez d’abord enregistrer le sujet en question.

Si vous utilisez un sujet que vous avez déjà employé dans une URL m.me/rn précédente et si des utilisateur·ices ont choisi de recevoir des notifications récurrentes, vous n’avez pas besoin d’enregistrer à nouveau le sujet.

Vous pouvez enregistrer un nouveau sujet en suivant ces étapes :

Étape 1. Envoyez une demande d’abonnement aux notifications récurrentes contenant ce sujet à une personne qui a un rôle dans votre application. Nous recommandons d’ajouter la charge utile pour indiquer que l’objectif est d’enregistrer votre sujet.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

En cas de réussite, votre application reçoit la réponse JSON suivante :

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

Étape 2. Assurez-vous de cliquer sur le bouton d’inscription dans la conversation. Nous vous enverrons une notification webhook d’inscription. À présent, votre sujet est enregistré et prêt à l’emploi.

Une personne qui clique sur un lien m.me/rn contenant un sujet non enregistré sera redirigée vers votre URL de notification récurrente de base, c’est-à-dire l’URL http://m.me/rn/PAGE-NAME.

Lorsque vous enregistrez un sujet, celui-ci n’est pas enregistré si vous vous envoyez à vous-même une demande d’abonnement sans pour autant cliquer sur le bouton correspondant.

Exemple de requête

Formaté pour plus de lisibilité.

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

En cas de réussite, votre application reçoit la réponse JSON suivante :

{ "success": true }

Notification webhook `messaging_optins`

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

Référence `m.me`

Nom du paramètre	Description
`cadence` énumération { `daily`, `monthly`, `weekly` }	Fréquence de message pour la demande d’abonnement à l’aide du lien `m.me/rn`. Valeur par défaut : `daily`.
`ref` chaîne	Contexte de la conversation, tel qu’un lien sur votre site web ou un lien dans un magasin, qui est livré dans une notification webhook `messaging_referrals`. Ce paramètre doit être encodé sous forme d’URL lorsqu’il est utilisé sur des liens m.me. La longueur de cette valeur ne peut pas dépasser 2 083 caractères.
`text` chaîne	Message personnalisé que vous envoyez lorsqu’une personne clique sur votre lien `m.me` pour entamer une conversation.
`topic` chaîne	Obligatoire. Sujet pour la demande d’abonnement à l’aide du lien `m.me/rn` (par exemple, promotions hebdomadaires ou sorties à venir). Ce paramètre doit être encodé sous forme d’URL lorsqu’il est utilisé sur des liens m.me. Il s’agit d’une chaîne de caractères alphanumériques, sans caractères spéciaux, encodée au format URL.

Étapes suivantes

Voir aussi

Consultez la page Paramètres de référence dans le guide Exemple d’expérience Messenger avec Original Coast Clothing.
Consultez la référence messaging_optins.
Pour plus d’informations sur les champs de ce webhook, consultez la référence messaging_postbacks.
Pour plus d’informations sur les champs de ce webhook, consultez la référence messaging_referrals.

Liens m.me

Fonctionnement

Paramètres de référence

Codes QR

Exemple de code QR

Notification webhook

Lancer une conversation

Poursuivre une conversation existante

Avant de commencer

Limites

Demandes d’inscription aux messages marketing

Limites

Exemple de lien de messages marketing

Enregistrer votre sujet

Exemple de requête

Notification webhook messaging_optins

Référence m.me

Étapes suivantes

Voir aussi

Notification webhook `messaging_optins`

Référence `m.me`