Envoyer des médias : images, vidéos, audios et documents
Les médias s’envoient soit en téléversant d’abord le fichier, puis en référençant l’identifiant renvoyé, soit en fournissant à Meta un lien public à récupérer. Le téléversement est plus fiable, et les limites de taille varient selon le type de façon parfois surprenante.
La taille maximale des images sur la Cloud API.
La taille maximale des vidéos et des audios.
La taille maximale des documents.
Les limites selon le type
Elles diffèrent pour chaque type, et dépasser l’une d’elles renvoie l’erreur 131053, sans explication utile.
- Images : 5 MB. JPEG et PNG.
- Vidéo : 16 MB. MP4 et 3GPP, avec vidéo H.264 et audio AAC.
- Audio : 16 MB. AAC, AMR, MP3, audio MP4 et OGG avec Opus.
- Documents : 100 MB. La plupart des formats courants, notamment PDF et les formats Office.
- Stickers : 100 KB animés, 500 KB statiques, WebP uniquement.
Téléverser ou utiliser un lien
Deux façons d’envoyer le même fichier, avec des échecs différents.
Le téléversement envoie d’abord le fichier à Meta et renvoie un identifiant de média à référencer lors de l’envoi. Avec un lien, Meta reçoit une URL à récupérer au moment de l’envoi. Cette méthode semble plus simple, mais ajoute une cause d’échec invisible : une URL qui se charge dans votre navigateur peut être inaccessible depuis l’infrastructure de Meta à cause de la géographie, d’une règle de pare-feu ou d’un cookie de session déjà détenu par votre navigateur.
Téléversez le fichier. Cela ajoute une requête, mais supprime toute une catégorie d’échecs.
Recevoir des médias
Les médias entrants arrivent sous forme d’identifiant de média, et non d’octets. Votre gestionnaire récupère ensuite le fichier séparément avec cet identifiant.
- Récupérez-les rapidement. Les identifiants ne restent pas valides indéfiniment.
- Une récupération échouée renvoie l’erreur 131052, ce qui signifie généralement que le téléversement de l’expéditeur était incomplet.
- Conservez vous-même le fichier si vous en avez besoin plus tard. Meta n’est pas une archive.
- Enregistrez le message même si la récupération du média échoue, afin de préserver le texte et le contexte.
Ce que Coexistence change
Les médias sur un numéro Coexistence fonctionnent exactement comme sur tout autre numéro de la Cloud API, avec les mêmes limites.
La seule différence importante concerne l’historique. Lorsqu’un numéro se connecte pour la première fois, Meta synchronise les messages récents de l’application WhatsApp Business, mais cette synchronisation porte sur le texte des messages et ne constitue pas une archive complète des médias. Les médias antérieurs à la connexion restent sur le téléphone, comme auparavant.
Erreurs courantes
- Envoyer un lien parce qu’il semble plus simple. Le réseau de Meta n’est pas votre navigateur.
- Récupérer les médias entrants plusieurs heures plus tard. Les identifiants de média expirent.
- Exporter une vidéo sans vérifier le codec. Les réglages par défaut des logiciels de montage sont souvent incompatibles.
EasyCoexistence transmet directement à votre endpoint les événements de messages entrants depuis Meta. Les identifiants de média arrivent donc immédiatement dans votre système et peuvent être récupérés tant qu’ils restent valides.
Questions fréquemment posées
Quel est le plus gros fichier que je peux envoyer ?
100 MB, uniquement pour les documents. Les vidéos et les audios sont limités à 16 MB, les images à 5 MB.
Dois-je téléverser le fichier ou envoyer une URL ?
Téléversez-le. Cela élimine l’accessibilité comme cause d’échec.
Combien de temps un identifiant de média reste-t-il valide ?
Pas indéfiniment. Les médias entrants doivent donc être récupérés dès l’arrivée de l’événement.
Les anciens médias sont-ils synchronisés lors de la connexion ?
Non. La synchronisation de l’historique porte sur le contenu récent des messages ; les médias antérieurs à la connexion restent sur le téléphone.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le