> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Médias dans les en-têtes de modèles WhatsApp : images et vidéos > Quels formats et tailles de médias WhatsApp accepte dans les en-têtes de modèles, pourquoi les liens YouTube ne s'intègrent pas et comment uploader et référencer des médias via Flowella. Un modèle WhatsApp peut porter un morceau de média dans son en-tête : une image, une vidéo ou un document. Bien utilisé, il double les taux d'ouverture et d'engagement d'un message autrement uniquement textuel. Mal utilisé — mauvais format, URL cassée, type MIME incompatible — il fait échouer l'envoi ou fait paraître le modèle amateur. Cette page est la référence pratique de ce qui fonctionne, ce qui ne fonctionne pas et comment faire passer le média par Flowella. ## Formats et limites pris en charge Ce sont les formats et les limites de taille que Meta applique aux médias dans les en-têtes de modèles (et ailleurs dans les messages de la WhatsApp Business Platform). ### Images | Format | Extension | Type MIME | Taille max | | - | - | - | - | | JPEG | `.jpeg` / `.jpg` | `image/jpeg` | 5 Mo | | PNG | `.png` | `image/png` | 5 Mo | Les images doivent être **8 bits, RGB ou RGBA**. WebP n'est **pas** accepté dans les en-têtes de modèles (il n'est valide que dans les messages sticker, qui sont un type de message séparé). **Dimensions recommandées :** rapport d'aspect 1,91:1, minimum 800×418 px. Les images carrées (1:1) s'affichent également de manière acceptable. Les autres rapports d'aspect sont letterboxés par le client WhatsApp. ### Vidéos | Format | Extension | Type MIME | Taille max | | - | - | - | - | | 3GPP | `.3gp` | `video/3gpp` | 16 Mo | | MP4 | `.mp4` | `video/mp4` | 16 Mo | Les vidéos doivent utiliser le **codec vidéo H.264** et le **codec audio AAC**, avec un **flux audio unique ou aucun audio**. Les vidéos encodées avec le profil H.264 **« High » et B-frames** ne sont pas prises en charge par les clients WhatsApp Android. Encodez (ou ré-encodez) avec le profil H.264 **« Main » sans B-frames**, ou le profil **« Baseline »**, et placez les boîtes `moov` avant les boîtes `mdat` pour une meilleure compatibilité. Si vous utilisez ffmpeg, le flag `-movflags faststart` gère l'ordre `moov`/`mdat`. ### Documents | Format | Extension | Type MIME | Taille max | | - | - | - | - | | PDF | `.pdf` | `application/pdf` | 100 Mo | | Microsoft Word | `.doc` / `.docx` | `application/msword` / `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | 100 Mo | | Microsoft Excel | `.xls` / `.xlsx` | `application/vnd.ms-excel` / `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | 100 Mo | | Microsoft PowerPoint | `.ppt` / `.pptx` | `application/vnd.ms-powerpoint` / `application/vnd.openxmlformats-officedocument.presentationml.presentation` | 100 Mo | | Texte brut | `.txt` | `text/plain` | 100 Mo | Les PDF sont les plus fiablement rendus sur tous les appareils. Les documents Office fonctionnent mais nécessitent que le destinataire ait une application compatible installée ; sur un mobile non professionnel, ils s'ouvrent généralement sous forme d'aperçus. ## Ce qui ne fonctionne pas Vous ne pouvez pas intégrer une vidéo YouTube ou Vimeo dans un en-tête de modèle. L'en-tête doit être un fichier MP4 ou 3GPP que Meta peut récupérer et héberger. Si vous voulez envoyer une vidéo YouTube, deux options : 1. **Mettez le lien YouTube dans le corps ou un bouton URL.** Le taper ouvre l'application YouTube ou le navigateur. L'aperçu de la vidéo affiché dans WhatsApp sera une miniature statique. 2. **Téléchargez la vidéo et re-uploadez-la en MP4.** Sous réserve de vos droits de rediffusion du contenu, ce qui signifie généralement qu'il doit s'agir de votre propre vidéo. La seconde est la façon d'obtenir un vrai aperçu vidéo en conversation. Les GIF animés (`.gif`) ne sont pas dans la liste prise en charge. WhatsApp les convertit côté serveur lors du partage peer-to-peer dans l'application grand public, mais pas la Business Platform. Ré-encodez le GIF en MP4 (que les clients mobiles WhatsApp jouent avec lecture automatique et sans son, de la même façon qu'ils affichent un GIF). Les images WebP ne sont valides que pour les messages sticker, pas les en-têtes de modèles. Convertissez en JPEG ou PNG avant utilisation comme image d'en-tête. Les iPhones enregistrent par défaut les photos au format HEIC, qui n'est pas dans la liste prise en charge. Soit changez le réglage de l'iPhone pour capturer en JPEG, soit convertissez HEIC en JPEG avant l'upload. Une image de 6 Mo, une vidéo de 18 Mo ou un PDF de 110 Mo sera rejeté. Compressez avant l'upload. Pour les images, le client WhatsApp recompresse également à l'affichage, donc une photo de 4 Mo n'aura pas l'air significativement meilleure qu'une de 1 Mo sur un écran de téléphone. ## Deux façons d'attacher un média à un modèle Meta prend en charge deux motifs pour intégrer un média dans un modèle : ### Motif 1 : Media handle (recommandé) Uploadez le fichier via l'API Media de Meta, obtenez un **media handle** en retour et référencez le handle lorsque vous envoyez le modèle. Utilisé par Flowella par défaut. Avantages : * Meta héberge le fichier, donc il n'y a pas d'échecs d'URL cassée au moment de l'envoi. * Livraison plus rapide car Meta n'a pas à récupérer depuis une URL externe. * Fonctionne pour toutes les limites de taille ci-dessus. Le handle est valide 30 jours. Si votre modèle sort à répétition avec le même média, Flowella rafraîchit le handle automatiquement avant son expiration. Pour les en-têtes DOCUMENT, Flowella réutilise également les médias document uploadés récemment lorsque c'est possible, pour que les renvois du même modèle n'aient pas besoin de re-uploader le fichier. Si Meta rejette un id réutilisé, Flowella retombe sur un ré-upload. ### Motif 2 : URL HTTPS publique Fournissez une URL vers un fichier accessible publiquement. Meta le récupère au moment de l'envoi. C'est utile quand : * Le média change par destinataire (un PDF personnalisé, une étiquette d'expédition par commande). * Le média est généré à la volée et vous ne voulez pas uploader-par-envoi. Mises en garde : * L'URL doit être **accessible publiquement** (sans auth) et utiliser **HTTPS avec un certificat valide**. * Si l'URL retourne une erreur ou est lente, l'envoi échoue. * Meta met en cache le fichier récupéré pendant un moment ; mettre à jour le fichier à l'URL ne rafraîchit pas nécessairement ce qui est envoyé. ## Comment Flowella gère l'upload de média Pour la plupart des cas d'usage, Flowella gère le media handle pour vous : Dans **Modèles → Créer**, choisissez **Image**, **Vidéo** ou **Document** comme type d'en-tête, puis **glissez le fichier sur la zone d'upload en pointillés** ou cliquez dessus pour naviguer. Le glisser-déposer fonctionne pour les trois types d'en-tête et utilise le même chemin d'upload que le clic. Pour les en-têtes **Document**, l'éditeur affiche également un champ **Nom de fichier du document** qui par défaut prend celui du fichier uploadé — modifiez-le pour contrôler le nom que les destinataires voient sur la bulle document WhatsApp. Format, taille et type MIME sont vérifiés avant la soumission. Si vous déposez ou choisissez un fichier non pris en charge, un toast vous dit immédiatement ce qui ne va pas (mauvais type ou au-dessus de la limite de taille) plutôt que d'attendre que Meta rejette le modèle. Le fichier est uploadé via l'API Media de Meta. Le handle retourné est enregistré contre le modèle. Lorsque le modèle est soumis pour approbation, Meta voit le média réel (pas une URL), donc le processus de revue peut évaluer les visuels dans le cadre de l'approbation. Tant que le média d'en-tête du modèle ne change pas, chaque envoi utilise le même handle. Les handles sont rafraîchis automatiquement avant expiration. Pour les en-têtes DOCUMENT, le **Nom de fichier du document** que vous définissez dans l'éditeur est persisté avec le brouillon, transporté à travers l'approbation et la publication Meta, et utilisé sur chaque envoi — les envois de workflow HubSpot, les envois de test, les envois en masse et les envois de la boîte de réception affichent tous votre nom de fichier au lieu du nom interne du modèle. Lorsque vous utilisez **Modèles → Dupliquer**, Flowella copie le fichier d'en-tête et le **Nom de fichier du document** dans le nouveau brouillon. Si la copie échoue, l'éditeur affiche un avertissement et bloque la publication jusqu'à ce que vous re-uploadiez le fichier. Pour les médias par destinataire (PDF personnalisés, étiquettes d'expédition), utilisez l'option **URL publique** dans le constructeur de modèle et passez l'URL comme variable lors du déclenchement de l'envoi depuis un workflow ou l'API. Voir [Actions de workflow](/fr/hubspot/workflow-actions). ## Concevoir pour le viewport WhatsApp Quelques notes de conception qui n'apparaissent pas dans la spec Meta mais qui comptent en pratique : * **Texte sur les images.** Gardez-le grand et à fort contraste. WhatsApp affiche l'image à environ la largeur d'un écran mobile, donc tout ce qui est plus petit qu'environ 14 px devient illisible. * **Zone de sécurité.** WhatsApp peut recadrer ou letterboxer ; gardez le contenu critique dans les 80 % centraux de l'image. * **Cohérence de marque.** L'image d'en-tête, le nom d'affichage WhatsApp et la photo de profil sont tous très proches — gardez-les visuellement cohérents. * **Première image d'une vidéo.** WhatsApp utilise la première image comme aperçu fixe avant la lecture de la vidéo. N'ouvrez pas sur une image noire ou un écran de logo d'entreprise ; démarrez sur une image significative. * **Nom de fichier du document.** Lorsque vous envoyez un PDF ou un autre document, le **nom de fichier** est visible pour le destinataire sur la bulle document WhatsApp. L'éditeur de modèle expose un champ **Nom de fichier du document** sous l'upload d'en-tête DOCUMENT ; par défaut il prend le nom du fichier uploadé et c'est ce que les destinataires voient réellement lorsque le modèle est envoyé. Utilisez un nom clair et descriptif comme `Acme-Commande-12345-Recu.pdf`, pas `piece-jointe.pdf` ou le nom d'objet CDN de Meta. ## Erreurs courantes et corrections Le type MIME réel du fichier ne correspond pas à ce qui a été déclaré. Se produit souvent lorsqu'un « JPEG » exporté par iPhone est en réalité du HEIC, ou lorsqu'un outil renomme un `.docx` en `.pdf` sans convertir. Correction : inspectez le fichier (sur macOS/Linux : `file -I yourfile.png`) et soit réexportez au bon format, soit changez l'extension pour correspondre. Le codec audio est autre chose 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ée avec le profil H.264 High et 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 est invalide, le serveur est lent à répondre (timeout) ou l'URL retourne une redirection au lieu du fichier. Correction : testez l'URL avec `curl -I` pour confirmer qu'elle retourne 200 avec le bon type de contenu, et que le certificat valide. Puis réessayez. La source est en basse résolution, ou elle a été agrandie. WhatsApp ne re-traite pas pour la netteté ; ce que vous uploadez est ce qui est affiché. Correction : uploadez au moins 800 px sur le bord long pour une image 1,91:1, et n'agrandissez pas une petite source. ## Guides associés * [Référence des modèles](/fr/app/template-reference) — la structure complète des modèles dans laquelle ce média s'insère * [Modèles](/fr/app/templates) — création de modèle étape par étape dans Flowella * [Actions de workflow](/fr/hubspot/workflow-actions) — passer des URL de médias par destinataire à travers les workflows HubSpot This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.