Contenu multimédia

/v1/media

Utilisez le nœud media pour importer, récupérer ou supprimer des médias.

Arêtes

Les arêtes ci-dessous sont connectées à ce nœud :

Avant de commencer

Lorsqu’un message multimédia est envoyé, le contenu multimédia est stocké sur les serveurs WhatsApp pendant 14 jours. Si un utilisateur ou une utilisatrice demande à télécharger le contenu multimédia après 14 jours, les serveurs WhatsApp demanderont le même fichier multimédia au client WhatsApp Business sur site. Si le contenu multimédia a été supprimé, l’utilisateur·trice sera averti·e que le contenu multimédia n’est pas disponible.

Il n’est pas prudent de supposer que le média a été téléchargé simplement sur la base des accusés de réception et de lecture. Les médias sortants peuvent généralement être supprimés en toute sécurité après 30 jours, mais vous devriez employer la stratégie qui convient le mieux à votre entreprise.

Contraintes

• Si vous importez le contenu multimédia au lieu d’utiliser son URL, le fichier doit être importé vers le volume du contenu multimédia. Une fois l’importation terminée, vous pouvez envoyer un message à l’aide de l’ID du média.
• L’application traite le contenu multimédia importé avant qu’il ne soit envoyé au serveur. Bien que la taille maximale du contenu multimédia pouvant être importé vers le nœud media soit de 100 Mo, il existe des limites de post-traitement pour les différents types de contenus multimédias décrits dans le tableau Taille des contenus multimédias post-traitement ci-dessous.
• Le stockage des contenus multimédias doit être géré par l’entreprise. Si le volume du contenu multimédia est plein, l’envoi de messages commencera à échouer.
• Les opérations ci-après ne sont pas prises en charge :

  • L’envoi de contenu multimédia par flux d’octets.
  • L’envoi de messages contenant des stickers animés.

L’importation

Envoyez une requête POST à /v1/media pour importer votre contenu multimédia. Le corps de la requête sur site doit contenir les données binaires du contenu multimédia, et l’en-tête Content-Type doit être défini sur le type de contenu multimédia importé. Pour connaître les options prises en charge, consultez la section Types de contenu pris en charge.

L’envoi de données binaires dans une requête POST HTTP est la méthode habituelle pour importer des données binaires. Si vous souhaitez importer une image, par exemple, vous effectuez une requête POST avec les octets de l’image réelle dans la charge utile. Vous pouvez également utiliser --data-binary si vous souhaitez que cURL lise et utilise le fichier binaire exactement tel qu’il est fourni.

Exemple

Importation de contenus multimédias :

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

Importation de contenus multimédias avec cURL :

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

Dans les deux cas, une réponse positive renvoie le champ id, qui correspond aux informations dont vous avez besoin pour récupérer le contenu multimédia ou pour envoyer un message multimédia à votre clientèle.

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

Si vous recevez un message d’erreur, consultez l’article Messages d’erreur et d’état pour plus d’informations.

Types de contenu pris en charge

Taille des contenus multimédias post-traitement

Il s’agit de la taille maximale autorisée pour un fichier multimédia après compression et chiffrement.

Questions/réponses

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

En savoir plus

• Recommandations
• Messages
• Références