Enregistrement des éléments

Pour optimiser l’envoi d’éléments, la plateforme Messenger peut enregistrer un élément lorsqu’il est envoyé. Ceci est utile si vous prévoyez d’envoyer plusieurs fois les mêmes pièces jointes, puisque vous n’avez plus besoin de les importer à chaque fois.

La plateforme Messenger propose deux API qui vous permettent d’enregistrer les éléments pour une utilisation ultérieure : l’API Send et l’API Attachment Upload. Les deux API permettent d’enregistrer des éléments à partir d’une URL et de votre système de fichiers local.

Table des matières

• Types d’éléments pris en charge
• Enregistrement avec l’API Send

  • Enregistrement à partir d’une URL
  • Enregistrement à partir d’un fichier
  • Réponse de l’API
• Enregistrement avec l’API Attachment Upload

  • Enregistrement à partir d’une URL
  • Enregistrement à partir d’un fichier
  • Réponse de l’API
• Envoi d’éléments enregistrés

Types d’éléments pris en charge

La plateforme Messenger permet d’enregistrer les types d’éléments suivants, d’une taille maximale de 25 Mo :

• image
• audio : l’en-tête Content-Type doit utiliser le type audio. Par exemple, audio/mp3.
• vidéo
• fichier

Enregistrement avec l’API Send

L’API Send vous permet d’enregistrer un élément envoyé avec un message, comme alternative à l’API Attachment Upload qui sert à importer des éléments à l’avance. Pour ce faire, envoyez une requête POST avec payload.is_reusable défini sur true au point de terminaison /messages.

Enregistrement à partir d’une URL

Pour enregistrer un élément à partir d’une URL, spécifiez l’URL source dans la propriété payload.url de l’objet attachment de votre message :

{
  "recipient":{
    "id":"

Enregistrement à partir d’un fichier

Pour enregistrer un élément à partir de votre système de fichiers local, envoyez votre requête de message à l’API Send comme données de formulaire et spécifiez l’emplacement du fichier dans le champ filedata de la requête :

curl  \
  -F 'recipient={"id":"<PSID>"}' \
  -F 'message={"attachment":{"type":"<ASSET_TYPE>", "payload":{"is_reusable":true}}}' \
  -F 'filedata=@/tmp/shirt.png;type=image/png' \
  "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"  
  

Réponse de l’API

La réponse contient un attachment_id qui peut être utilisé pour joindre l’élément à des messages ultérieurs. Notez que cet ID est privé et que seule la page qui a initialement envoyé la pièce jointe peut le réutiliser.

{
  "recipient_id": "1254444444682919",
  "message_id": "mid.$cAAJsujCd2ORkHh27-ld7NhzuqrUK",
  "attachment_id": "687799999980546"
}

Enregistrement avec l’API Attachment Upload

L’API Attachment Upload vous permet d’importer des éléments à l’avance, par exemple, si vous savez déjà que vous devrez envoyer des éléments particuliers plusieurs fois. Pour ce faire, envoyez une requête POST au point de terminaison /message_attachments.

Enregistrement à partir d’une URL

Pour enregistrer un élément à partir d’une URL, spécifiez l’URL source dans la propriété payload.url de l’objet attachment de votre message :

curl -X POST -H "Content-Type: application/json" -d '{
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "is_reusable": true,
        "url":"http://www.messenger-rocks.com/image.jpg"
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/message_attachments?access_token=<PAGE_ACCESS_TOKEN>"

Enregistrement à partir d’un fichier

Pour enregistrer un élément à partir de votre système de fichiers local, envoyez votre requête de message à l’API Attachment Upload comme données de formulaire, et spécifiez l’emplacement du fichier dans le champ filedata de la requête :

curl  \
  -F 'recipient={"id":"<PSID>"}' \
  -F 'message={"attachment":{"type":"<ASSET_TYPE>", "payload":{"is_reusable":true}}}' \
  -F 'filedata=@/tmp/shirt.png;type=image/png' \
  "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"  
  

Réponse de l’API

La réponse contient un attachment_id qui peut être utilisé pour joindre l’élément à des messages ultérieurs. Notez que cet ID est privé et que seule la page qui a initialement envoyé la pièce jointe peut le réutiliser.

{
  "attachment_id":"1857777774821032"
}

Envoi d’éléments enregistrés

Vous pouvez joindre un élément à un message à l’aide de son attachment_id. Pour en savoir plus, consultez la page Envoi de messages - Joindre des éléments enregistrés.