Modèle de produit pour la messagerie Instagram

Envoyez des messages Instagram contenant les informations sur les produits que vous avez importées dans votre catalogue produits à l’aide du modèle de produit. Les détails du produit (image, titre, prix) sont extraits du catalogue automatiquement.

Vous pouvez créer des messages avec un seul produit ou un carrousel horizontal de produits à faire défiler à l'aide du modèle de produit.

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 :

L’ID ou les ID du produit de votre catalogue Facebook. Vous pouvez les obtenir via l’API Catalog ou le Gestionnaire des ventes
Un token d'accès à la Page qui possède les produits du catalogue
Les webhooks Meta pour les inscriptions à la messagerie Instagram
L'ID de votre compte professionnel Instagram
L’ID de la Page associée à votre compte professionnel Instagram
L'ID spécifique d’Instagram pour la personne destinataire de votre message

Envoi d’un message de produit

Pour envoyer un message de produit à une personne, envoyez une requête POST au point de terminaison /PAGE-ID/messages avec la propriété recipient.id définie sur l’ID spécifique d’Instagram de la personne destinataire du message. Incluez les propriétés type et payload dans l’objet message.attachment. Définissez type sur template et définissez la propriété payload.template_type sur product et payload.elements sur une liste de paires clé/valeur d’ID de produit.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"INSTAGRAM-SCOPED-ID"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Envoi d’un carrousel

Pour envoyer un carrousel de produits, ajoutez davantage de paires clé/valeur de produits dans la propriété payload.elements. Vous pouvez inclure jusqu’à 10 produits dans votre requête.

...
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID-1"
          },
          {
            "id": "PRODUCT-ID-2"
          },
          {
            "id": "PRODUCT-ID-3"
          }
        ]
      }
...

En cas de réussite, votre application recevra l’objet JSON suivant avec l’ID du ou de la destinataire et l’ID du message.

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

Envoi d’une demande d’inscription

Pour envoyer une demande d’inscription à une personne afin qu’elle reçoive des messages marketing récurrents, envoyez une requête POST au point de terminaison /PAGE-ID/messages avec la propriété recipient.id définie sur l’ID spécifique d’Instagram de la personne destinataire du message. Dans la propriété messageattachment.payload, définissez template_type sur notification_messages. Dans la propriété payload.elements, incluez image_url, title, payload, notification_message_frequency et notification_messages_cta_text.

curl -X POST -H "Content-Type:application/json" -d '{
  "recipient": {
    "id": "INSTAGRAM-SCOPED-ID"
  },
  "message": {
    "attachment": {
      "type": "template",
      "payload": {
        "template_type": "notification_messages",
        "elements": [
          {
            "image_url": "IMAGE-URL",
            "title": "TEXT-TO-DISPLAY",
            "payload": "INFORMATION-ABOUT-THIS-MESSAGE",
            "notification_messages_frequency": "DAILY",
            "notification_messages_cta_text": "GET_UPDATES"
          }
        ]
      }
    }
  }
}' "https://graph.intern.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Référence des éléments de messages de notification

Propriété	Valeur
`image_url` chaîne	URL de l’image à afficher dans le modèle
`notification_messages_cta_text` énumération { `ALLOW`, `FREQUENCY`, `GET`, `GET_UPDATES`, `OPT_IN`, `SIGN_UP` }	Le texte qui apparaît sur le bouton call-to-action est défini à l’aide de l'une des valeurs suivantes : `ALLOW` : définit le texte du bouton de message d’inscription sur Autoriser les messages `FREQUENCY` : définit le texte du bouton de message d’inscription sur Recevoir des messages quotidiens `GET` : définit le texte du bouton de message d’inscription sur Recevoir des messages `GET_UPDATES` : définit le texte du bouton de message d’inscription sur Recevoir les actualités, il s’agit de la valeur par défaut si notification_messages_cta_text n’est pas défini `OPT_IN` : définit le texte du bouton de message d’inscription sur Activer les messages `SIGN_UP` : définit le texte du bouton de message d’inscription sur S’inscrire pour les messages
`notification_messages_frequency` énumération { `DAILY`, `WEEKLY`, `MONTHLY` }	Fréquence des messages pour cette demande d’inscription aux notifications récurrentes. `DAILY` : permet de recevoir une notification toutes les 24 heures pendant 6 mois `WEEKLY` : permet de recevoir une notification tous les 7 jours pendant 9 mois `MONTHLY` : permet de recevoir une notification tous les mois pendant 12 mois
`payload` chaîne	Type de notification récurrente (par exemple, un message promotionnel ou un message de sortie de produit) pour cette demande d’inscription aux notifications récurrentes.
`title` chaîne	Le titre à afficher dans le modèle ne peut pas dépasser 65 caractères. Si aucune valeur n’est spécifiée, la valeur par défaut est « Updates and promotions » (Mises à jour et promotions)

Étapes suivantes

Maintenant que vous avez choisi de recevoir des messages marketing récurrents, découvrez comment envoyer vos messages marketing.