Envoyer un message

Ce document énumère les conditions requises pour envoyer des messages non structurés à votre clientèle ou à toute personne intéressée depuis votre compte professionnel Instagram, en utilisant la plateforme Messenger from Meta.

Vous pouvez envoyer un message non structuré qui contient :

• une image, une vidéo, un GIF ou un son ;
• une réaction ou un sticker ;
• du texte, y compris un lien.

Avant de commencer

Ce guide suppose que vous avez lu la présentation de la plateforme Messenger mais aussi que vous avez implémenté les composants nécessaires, tels qu’une Page Facebook liée à votre compte professionnel Instagram (ou Page test), procédé à votre enregistrement en tant que développeur·se Meta et créé un ID d’application Business lié au produit Messenger > Messagerie Instagram dans l’Espace App.

Vous pouvez également vérifier le statut de la plateforme Meta for Developers pour vous assurer qu’aucun problème n’est signalé.

Conditions requises

• L’ID de la Page Facebook associée à votre compte professionnel Instagram
• L’ID spécifique d’Instagram pour le client ou la cliente qui a envoyé un message à votre entreprise
• Un token d’accès à la Page demandé par une personne qui peut effectuer la tâche MESSAGE sur la Page Facebook associée à votre compte professionnel Instagram
• L’autorisation instagram_manage_messages

Limites

• Les applications avec accès standard peuvent uniquement envoyer des messages aux personnes disposant d’un rôle dans l’application
• Les pièces jointes aux contenus multimédias peuvent être :

Pour plus d’informations sur les pièces jointes de contenus multimédias, voir Importer du contenu multimédia dans la messagerie Instagram.

Envoyer un message simple

Pour envoyer un message contenant du texte ou un lien, envoyez une requête POST au point de terminaison /PAGE-ID/messages. Utilisez le paramètre recipient qui contient l’ID spécifique d’Instagram (IGSID) et le paramètre message qui contient le texte ou le lien.

Le texte du message doit être au format UTF-8 et ne pas dépasser 1 000 octets. Les liens doivent être des URL valides mises en forme.

Exemple de requête

Le code a été mis en forme pour plus de lisibilité.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={"text":"TEXT-OR-LINK"}'

Exemple de réponse d’API

En cas de réussite, votre application recevra la réponse JSON suivante :

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Envoyer une publication publiée

Pour envoyer un message contenant une publication que vous avez publiée sur Instagram, envoyez une requête POST au point de terminaison /PAGE-ID/messages. Utilisez le paramètre recipient qui contient l’ID spécifique d’Instagram (IGSID) et le paramètre message qui contient un objet attachment. Vous devez également définir type sur MEDIA_SHARE et payload contenant l’ID Meta de la publication.

Votre entreprise doit être propriétaire du contenu multimédia qu’elle compte utiliser dans le message.

Exemple de requête

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"MEDIA_SHARE", 
          "payload":{"id":"POST-ID"}
        }
}’

Exemple de réponse d’API

En cas de réussite, votre application recevra la réponse JSON suivante :

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Envoyer un sticker

Pour envoyer un sticker en forme de cœur, envoyez une requête POST au point de terminaison /PAGE-ID/messages. Utilisez le paramètre recipient qui contient l’ID spécifique d’Instagram (IGSID) et le paramètre message qui contient un objet attachment. Vous devez également définir type sur like_heart.

Exemple de requête

Le code a été mis en forme pour plus de lisibilité.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&message={
      "attachment": 
        {
          "type":"like_heart"
        }
}’

Exemple de réponse d’API

En cas de réussite, votre application recevra la réponse JSON suivante :

{
  "recipient_id": "IGSID",
  "message_id": "MESSAGE-ID"
}

Réagir à un message

Pour envoyer une réaction, envoyez une requête POST au point de terminaison /PAGE-ID/messages. Utilisez le paramètre recipient qui contient l’ID spécifique d’Instagram (IGSID) et le paramètre sender_action défini sur react. Vous devez également définir payload contenant la valeur message_id qui renvoie à l’ID du message auquel vous souhaitez appliquer la réaction et reaction qui renvoie love.

Exemple de requête

Le code a été mis en forme pour plus de lisibilité.

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id":"IGSID"}&sender_action=react&payload={
      "message_id":"MESSAGE-ID",
      "reaction":"love",
}'

Pour supprimer une réaction, envoyez une requête POST au point de terminaison /PAGE-ID/messages. Utilisez le paramètre recipient qui contient l’ID spécifique d’Instagram (IGSID) et le paramètre sender_action défini sur unreact. Vous devez également définir payload contenant message_id qui renvoie à l’ID du message duquel vous souhaitez retirer la réaction.

Exemple de requête

curl -i -X POST \
  "https://graph.facebook.com/LATEST-API-VERSION/me/messages?access_token=PAGE-ACCESS-TOKEN" \
  --data 'recipient={"id”:”IGSID”}&sender_action="unreact"&payload={
      “message_id":"MESSAGE-ID",
}'

Exemple de réponse

En cas de réussite, votre application recevra la réponse JSON suivante pour chacune des requêtes de réaction et de suppression de la réaction :

{
  "recipient_id": "IGSID"
}

Étapes suivantes

• Importez un contenu multimédia (audio ou image) sur les serveurs de Meta afin de l’utiliser dans plusieurs messages.

• Envoyez un message structuré, par exemple un modèle générique, un modèle de produit ou un menu fixe.

Voir aussi

• Codes d’erreur
• Limites de débit pour la messagerie Instagram
• Obtenir l’ID de contenu multimédia pour vos éléments multimédias