Référence sur l’API Attachment Upload

L’API Attachment Upload permet d’importer des éléments qui peuvent être envoyés ultérieurement dans des messages. Ainsi, vous évitez d’importer plusieurs fois des fichiers couramment utilisés. L’API permet d’enregistrer des éléments à partir d’une URL ou d’un système de fichier local.

Vous pouvez également utiliser l’API Send pour réaliser simultanément l’envoi d’un message avec pièce jointe et l’enregistrement de la pièce jointe pour la réutiliser ultérieurement. Pour en savoir plus, consultez la Référence sur l’API Send.

Importer une pièce jointe

Pour importer une pièce jointe, envoyez une requête POST au point de terminaison /Your-page-id/message_attachment avec message.attachment associée à type et payload. Pour pouvoir utiliser l’élément dans plusieurs messages, définissez payload.is_reusable sur true.

Exemple de requête d’importation à partir d’une URL

Le code a été mis en forme pour plus de lisibilité. Remplacez les valeurs en gras et en italique, telles que page_access_token, par vos propres valeurs.

curl -X POST "https://graph.facebook.com/v19.0/Your-page-id/message_attachment" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image", 
               "payload":{
                 "url":"https.your-url.com/image.jp",
                 "is_reusable": true
               }
             }
           }
         }'

Exemple de requête d’importation à partir d’un fichier

Le code a été mis en forme pour plus de lisibilité. Remplacez les valeurs en gras et en italique, telles que page_access_token, par vos propres valeurs.

curl -X POST "https://graph.facebook.com/v19.0/Your-page-id/message_attachment" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image"
             }
           },
           "filedata":"@/path-to-your-file/image.png";"type":"image/png"
         }'

En cas de réussite votre application reçoit un objet JSON avec attachment_id défini sur l’ID de votre pièce jointe à utiliser dans vos messages.

{"attachment_id": "Your-attachment-ID"}

Envoyer un message avec un élément importé

Pour envoyer un message avec un élément que vous avez précédemment importé, avec message.attachment.payload.is_reusable défini sur true, envoyez une requête POST au point de terminaison /Your-page-id/messages avec recipient.id, et l’objet message.attachment associé à type et payload.attachment_id.

Exemple de requête d’importation à partir d’un fichier

Le code a été mis en forme pour plus de lisibilité. Remplacez les valeurs en gras et en italique, telles que page_access_token, par vos propres valeurs.

curl -X POST "https://graph.facebook.com/v19.0/Your-page-id/messages" \
     -H "Content-Type: application/json" \
     -d '{
           "access_token":"Your_page_access_token",
           "message":{
             "attachment":{
               "type":"image",
               "payload":{
                 "attachment_id":"Your-attachment-ID"
               }
             }
           }
         }'

En cas de réussite, votre application reçoit un objet JSON avec success défini sur true.

{"success": "true"}

Propriétés

Pour joindre des éléments à partir d’une URL, vous devez préciser les propriétés suivantes dans le corps de la demande en tant qu’objet JSON. Quand la source de l’élément est un fichier, envoyez les propriétés sous forme de données de formulaire.

message

message.attachment

message.attachment.payload

Codes d’erreur