Passer au contenu principal
Un modèle WhatsApp peut contenir un média dans son en-tête : une image, une vidéo ou un document. Bien utilisé, il permet de doubler les taux d’ouverture et d’engagement d’un message qui, autrement, ne contiendrait que du texte. S’il est mal utilisé (mauvais format, URL erronée, type MIME non adapté), l’envoi échoue ou le modèle fait figure d’amateur. Cette page est la référence pratique pour savoir ce qui fonctionne, ce qui ne fonctionne pas, et comment sonder les médias grâce à Flowella.

​
Formats supportés et limites

Ce sont les formats et les limites de taille que Meta impose aux médias dans les en-têtes des modèles (et ailleurs dans les messages de WhatsApp Business Platform).

​
Images

FormatExtensionType MIMETaille max.
JPEG.jpeg / .jpgimage/jpeg5 MB.pngimage/png5 MBJPEG
.jpeg / .jpgimage/jpeg5 MBPNG.pngimage/png5 MB
Les images doivent être 8-bit, RGB ou RGBA. WebP n’est pas accepté dans les en-têtes de modèles (il n’est valable que dans les messages autocollants, qui sont un type de message distinct). Dimensions recommandées: Rapport d’aspect 1,91:1, minimum 800×418 px. Les images carrées (1:1) sont également acceptables. Les autres rapports d’aspect sont traités par le client WhatsApp.

​
Vidéos

| Format de la vidéo - Extension - Type MIME - Taille maximale - Format de la vidéo - Format de la vidéo - Extension - Type MIME - Taille maximale | --- | --- | --- | --- | | 3GPP | .3gp | video/3gpp | 16 MB | | MP4 | .mp4 | video/mp4 | 16 MB | Les vidéos doivent utiliser le codec vidéo H.264 et le codec audio AAC, avec un flux audio unique ou sans audio.
Les vidéos encodées avec le profil H.264 “High” et les B-frames ne sont pas supportées par les clients Android WhatsApp. Encodez (ou réencodez) avec le profil H.264 “Main” sans B-frames, ou le profil “Baseline ”, et placez les cases moov avant les cases mdat pour une plus grande compatibilité.Si vous utilisez ffmpeg, le drapeau -movflags faststart gère l’ordre moov/mdat.

​
Documents

FormatExtensionType MIMETaille max.
PDF.pdfapplication/pdf100 MB
Microsoft Word.doc / .docxapplication/msword / application/vnd.openxmlformats-officedocument.wordprocessingml.document100 MBMicrosoft Excel.doc / .docxapplication/msword / application/vnd.openxmlformats-officedocument.wordprocessingml.document / 100 MB
Microsoft Excel.xls / .xlsxapplication/vnd.ms-excel / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet100 MBMicrosoft Word
Microsoft PowerPoint.ppt / .pptxapplication/vnd.ms-powerpoint / application/vnd.openxmlformats-officedocument.presentationml.presentation / application/vnd.openxmlformats-officedocument.presentationml.presentation100 MB100 MB100 MB100 MB100 MB100 MB100 MB100 MB100 MB100 MB100 MB100 MB
.ppt / .pptx / application/vnd.ms-powerpoint / application/vnd.openxmlformats-officedocument.presentationml.presentation100 MB100 MB100 MB100 MB100 MB100 MB100 MB100 MB
Les PDF sont ceux dont le rendu est le plus fiable sur tous les appareils. Les documents Office fonctionnent, mais le destinataire doit avoir installé une application compatible ; sur un téléphone portable non professionnel, ils s’ouvrent généralement sous forme de prévisualisation.

​
Ce qui ne fonctionne pas

Vous ne pouvez pas intégrer une vidéo YouTube ou Vimeo dans l’en-tête d’un modèle. L’en-tête doit être un fichier MP4 ou 3GPP que Meta peut récupérer et héberger.Si vous souhaitez envoyer une vidéo YouTube, deux options s’offrent à vous :
  1. Si vous souhaitez envoyer une vidéo YouTube, deux options s’offrent à vous : 1. placer le lien YouTube dans le corps du message ou dans un bouton URL. Le fait d’appuyer sur ce bouton ouvre l’application ou le navigateur YouTube. L’aperçu de la vidéo affiché dans WhatsApp sera une vignette statique.
  2. Téléchargez la vidéo et retéléchargez-la au format MP4. Sous réserve de vos droits de redistribution du contenu, ce qui signifie généralement qu’il doit s’agir de votre propre vidéo.
Cette dernière solution permet d’obtenir un véritable aperçu de la vidéo pendant la conversation.
Les GIF animés (.gif) ne figurent pas dans la liste des formats pris en charge. WhatsApp les convertit côté serveur lorsqu’ils sont partagés en peer-to-peer dans l’application grand public, mais la plateforme professionnelle ne le fait pas. Réencoder le GIF en MP4 (que les clients mobiles de WhatsApp lisent en lecture automatique et sans son, de la même manière qu’ils affichent un GIF).
Les images WebP ne sont valables que pour les messages autocollants, pas pour les en-têtes de modèles. Convertissez-les en JPEG ou PNG avant de les utiliser comme image d’en-tête.
Les iPhones enregistrent par défaut les photos au format HEIC, qui ne figure pas dans la liste des formats pris en charge. Modifiez les paramètres de l’iPhone pour capturer en JPEG, ou convertissez HEIC en JPEG avant le téléchargement.
Une image de 6 Mo, une vidéo de 18 Mo ou un PDF de 110 Mo seront rejetés. Compresser avant le téléchargement. Pour les images, le client WhatsApp procède également à une recompression à l’affichage, de sorte qu’une photo de 4 Mo n’aura pas un meilleur rendu qu’une photo de 1 Mo sur l’écran d’un téléphone.

​
Deux façons d’attacher un média à un modèle

Meta propose deux méthodes pour intégrer un média dans un modèle :

​
Modèle 1 : Poignée de média (recommandé)

Téléchargez le fichier via l’API Media de Meta, obtenez en retour un media handle, et faites référence à ce handle lorsque vous envoyez le modèle. Utilisé par défaut par Flowella. Avantages :
  • Meta héberge le fichier, il n’y a donc pas de rupture d’URL au moment de l’envoi.
  • Livraison plus rapide car Meta n’a pas besoin d’aller chercher le fichier dans une URL externe.
  • Fonctionne pour les limites de taille ci-dessus.
L’identifiant est valable pendant 30 jours. Si votre modèle est envoyé à plusieurs reprises avec le même média, Flowella rafraîchit la poignée automatiquement avant qu’elle n’expire.

​
Modèle 2 : URL HTTPS publique

Fournissez une URL vers un fichier accessible au public. Meta le récupère au moment de l’envoi. Ceci est utile lorsque :
  • Le support change en fonction du destinataire (un PDF personnalisé, une étiquette d’expédition par commande).
  • Le support est généré à la volée et vous ne voulez pas le télécharger à chaque envoi.
Attention :
  • L’URL doit être publiquement accessible (pas d’authentification) et utiliser HTTPS avec un certificat valide.
  • Si l’URL renvoie une erreur ou est lente, l’envoi échoue.
  • Meta met en cache le fichier recherché pendant un certain temps ; la mise à jour du fichier à l’URL ne rafraîchit pas nécessairement ce qui est envoyé.

​
Comment Flowella gère le téléchargement de médias

Pour la plupart des cas d’utilisation, Flowella gère les médias pour vous :
1

Ajouter un fichier média d'en-tête lors de la création du modèle

Dans Modèles → Créer, choisissez Image, Vidéo, ou Document comme type d’en-tête, puis faites glisser le fichier dans la zone de téléchargement.
2

Flowella valide le fichier

Le format, la taille et le type MIME sont vérifiés avant l’envoi. Si le fichier n’est pas pris en charge, un message d’erreur s’affiche immédiatement, sans attendre que Meta rejette le modèle.
3

Flowella télécharge vers Meta et stocke la poignée

Le fichier est téléchargé via l’API médias de Meta. L’identifiant retourné est sauvegardé avec le modèle.
4

Le modèle de soumission comprend la poignée

Lorsque le modèle est soumis pour approbation, Meta voit le média réel (pas une URL), de sorte que le processus de révision peut évaluer les visuels dans le cadre de l’approbation.
5

Envoi de la réutilisation de la même poignée

Jusqu’à ce que le média d’en-tête du modèle change, chaque envoi utilise la même poignée. Les poignées sont automatiquement actualisées avant leur expiration.
Pour les médias par destinataire (PDF personnalisés, étiquettes d’expédition), utilisez l’option Url publique dans le constructeur du modèle et transmettez l’URL comme variable lorsque vous déclenchez l’envoi à partir d’un flux de travail ou de l’API. Voir Actions de flux de travail.

​
Concevoir pour le viewport WhatsApp

Quelques notes de conception qui n’apparaissent pas dans les spécifications de Meta mais qui sont importantes dans la pratique :
  • Texte sur les images. Gardez-le grand et bien contrasté. WhatsApp affiche l’image à peu près à la largeur de l’écran du mobile, donc tout ce qui est plus petit que 14 px est illisible.
  • WhatsApp peut recadrer l’image ou en faire une boîte aux lettres ; gardez le contenu essentiel au centre de l’image (80 %).
  • L’image d’en-tête, le nom d’affichage et la photo de profil de WhatsApp sont tous proches l’un de l’autre - veillez à ce qu’ils soient visuellement cohérents.
  • WhatsApp utilise la première image comme prévisualisation avant la lecture de la vidéo. Ne commencez pas par un cadre noir ou un logo d’entreprise ; commencez par une image significative.
  • Lorsque vous envoyez un document PDF ou autre, le nom du fichier est visible par le destinataire. Utilisez un nom clair et descriptif comme Acme-Order-12345-Receipt.pdf, et non attachment.pdf.

​
Erreurs et corrections courantes

Le type MIME réel du fichier ne correspond pas à ce qui a été déclaré. Cela se produit souvent lorsqu’un “JPEG” exporté par l’iPhone est en fait un HEIC, ou lorsqu’un outil renomme un .docx en .pdf sans le convertir.Correction : inspectez le fichier (sur macOS/Linux : file -I yourfile.png) et réexportez-le dans le bon format ou modifiez l’extension pour qu’elle corresponde.
Le codec audio est autre que AAC, ou il y a plusieurs flux audio.Correction : réencodez avec ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4.
Encodé avec le profil H.264 High et les B-frames. Réencodez avec le profil Main ou Baseline.
Meta ne peut pas atteindre l’URL. Causes courantes : l’URL nécessite une authentification, le certificat n’est pas valide, le serveur est lent à répondre (timeout), ou l’URL renvoie une redirection au lieu du fichier.Correction : testez l’URL avec curl -I pour confirmer qu’elle renvoie 200 avec le bon type de contenu et que le certificat est valide. Puis réessayez.
La source est en basse résolution ou a été mise à l’échelle. WhatsApp n’effectue pas de retraitement pour améliorer la netteté ; ce que vous téléchargez est ce qui s’affiche.Correction : téléchargez au moins 800 px sur le bord long pour une image 1.91:1, et n’augmentez pas l’échelle d’une petite source.

​
Guides connexes

  • Référence du modèle - la structure complète du modèle dans lequel ce média s’insère.
  • Templates - création de modèles étape par étape dans Flowella
  • Workflow Actions - passage des URLs des médias par destinataire dans les workflows HubSpot