Aller au contenu
OmniChannels.ai
Menu

API WhatsApp Business

Quelles sont les limites de taille des fichiers multimédias de l'API WhatsApp ?

Mis à jour le

Réponse courte

La documentation de Meta indique ces tailles maximales pour les médias de l'API WhatsApp Cloud au moment de la rédaction : images 5 Mo (JPEG, PNG, WebP statique), vidéo 16 Mo (MP4 ou 3GPP avec H.264 et AAC), audio 16 Mo, documents 100 Mo, stickers animés 500 Ko et stickers statiques 100 Ko. Téléversez le fichier et envoyez son ID média plutôt qu'un lien, et vérifiez que le type MIME correspond au fichier.

Limites de taille par type de média

Le plafond de l'API Cloud pour tout média est de 100 Mo. Un fichier peut respecter la limite de taille et être refusé à cause de son format, par exemple une vidéo qui n'est pas en H.264 avec audio AAC, ou une image qui n'est pas en RVB ou RVBA 8 bits.

Type de médiaTaille maximaleRemarques
Image5 MoRVB ou RVBA 8 bits uniquement
Vidéo16 MoVidéo H.264, audio AAC
Audio16 MoAAC, AMR, MP3, M4A, OGG codé en Opus
Document100 MoFichiers Office, PDF et texte
Sticker (animé)500 KoWebP uniquement
Sticker (statique)100 KoWebP uniquement

Téléverser ou lier, et durée de vie des ID

Meta recommande de téléverser le fichier et d'envoyer son ID média pour de meilleures performances. Les ID renvoyés par un téléversement sont valables 30 jours, et ceux reçus dans les webhooks entrants 7 jours : téléchargez donc rapidement les fichiers des clients. Une URL de téléchargement expire au bout de 5 minutes.

Les légendes des images, vidéos et documents peuvent compter jusqu'à 1 024 caractères. Les messages audio et les stickers n'ont pas de légende.

Erreurs fréquentes

  • Juger uniquement d'après la taille en ignorant le codec ou le format de couleur.
  • Servir un fichier dont le type MIME ne correspond pas, une cause habituelle de l'erreur 131053.
  • S'appuyer sur un ID média de plus de 30 jours.
  • Envoyer un WebP animé comme image, ce qui est refusé.

Sources officielles