# Messages audio WhatsApp Un message audio contient une URL publique que WhatsApp récupère au moment de l'envoi. Il n'a pas de légende et peut optionnellement s'afficher comme une note vocale. ## Envoyer un message audio Définissez `audio.url` : **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", from: "+13124495648", audio: { url: "https://cdn.example.com/vm/9f2.ogg" }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/fr-fr/documentation/guides/whatsapp/message-types/audio.ts.md) · [Python](/fr-fr/documentation/guides/whatsapp/message-types/audio.py.md) · [Go](/fr-fr/documentation/guides/whatsapp/message-types/audio.go.md) · [PHP](/fr-fr/documentation/guides/whatsapp/message-types/audio.php.md) · [CLI](/fr-fr/documentation/guides/whatsapp/message-types/audio.cli.md) · [MCP](/fr-fr/documentation/guides/whatsapp/message-types/audio.mcp.md) · [cURL](/fr-fr/documentation/guides/whatsapp/message-types/audio.curl.md) La forme complète ajoute le flag optionnel `voice`, le seul autre champ dont dispose `audio` : ```json { "to": "+16505551234", "from": "+13124495648", "audio": { "url": "https://cdn.example.com/voice/9f2e4a.ogg", "voice": true } } ``` `audio` n'a aucun champ `caption`. `from` est obligatoire sur chaque message de service : un numéro que votre espace de travail possède, pas un numéro géré par Bird. ## Limites | Champ | Limite | Appliqué par | | ----------------- | ------------------------------------------------------------------------------ | ---------------------------------------------- | | Taille du fichier | 16 Mo | WhatsApp uniquement, à la récupération (async) | | Format | AAC, AMR, MP3, M4A ou OGG avec le codec OPUS, mono | WhatsApp uniquement, à la récupération (async) | | `voice: true` | nécessite `.ogg`/OPUS, mono ; les autres formats font échouer la transcription | WhatsApp uniquement, à la récupération (async) | | `caption` | champ non valide | Bird, à l'acceptation (`422`, rejet de schéma) | | `url` | absolue, `https`, possède un hôte, pas d'espace brut | Bird, à l'acceptation (`422`) | Bird vérifie la forme de l'URL avant toute mise en file d'attente ; il ne vérifie ni la taille réelle du fichier, ni le format, ni le codec, et il ne vérifie pas qu'un envoi `voice: true` est réellement en `.ogg`/OPUS. Seule la récupération par WhatsApp au moment de l'envoi le peut. Envoyer un `caption` sur un message audio n'est pas une erreur de longueur ; le champ n'existe pas dans le schéma de cette branche, donc il échoue en tant que propriété non reconnue. Voir dans le hub [envoyer un média par URL](/docs/guides/whatsapp/message-types#sending-media-by-url) et [quand un média échoue](/docs/guides/whatsapp/message-types#when-media-fails). ## Lire un message audio entrant Un message audio entrant contient le même objet `audio`, plus un `id` et un `mime_type` que Bird a appris en récupérant le fichier, et aucun `caption` dans les deux sens. Voir [Recevoir un audio WhatsApp](/docs/guides/whatsapp/receiving-whatsapp/audio) pour la lecture entrante complète, le payload `whatsapp.received`, et les points à surveiller. ## Limites et modes d'échec - **La fenêtre de service client doit être ouverte.** Un audio est un message de service, livrable uniquement dans une fenêtre ouverte ; voir dans le hub la [fenêtre de service client](/docs/guides/whatsapp/message-types#the-customer-service-window). - **Bird rejette `http` ; WhatsApp lui-même la récupérerait.** Voir dans le hub [envoyer un média par URL](/docs/guides/whatsapp/message-types#sending-media-by-url) pour la vérification complète de la forme. - **Une récupération rejetée est quand même facturée.** Voir dans le hub [quand un média échoue](/docs/guides/whatsapp/message-types#when-media-fails). Le texte de rejet propre à l'audio provenant de WhatsApp n'a pas été mesuré indépendamment ; considérez la correspondance comme déduite par symétrie plutôt que confirmée par cause. - **Le flag `voice` change la façon dont le client du destinataire affiche le message, pas ce que Bird valide.** `voice: true` l'affiche comme une note vocale : téléchargement automatique, icône de microphone en ligne et transcription possible. Pour que cela fonctionne correctement, il faut un fichier `.ogg` encodé en OPUS, mono ; tout autre format est quand même envoyé, mais la transcription échoue côté destinataire. `voice` vaut par défaut `false`. - **Le seuil d'icône de lecture et le signal "played" propres à WhatsApp ne sont pas exposés par Bird.** WhatsApp documente un comportement client autour des petites notes vocales et d'un état « lu », mais Bird ne modélise ni l'un ni l'autre ; ne construisez pas une intégration qui s'attend à lire l'un ou l'autre depuis le API. - **WhatsApp met en cache une URL récupérée pendant environ 10 minutes.** Renvoyer la même URL dans cette fenêtre resert la première récupération ; modifiez l'URL pour en forcer une nouvelle. ## Étapes suivantes - [Messages de service WhatsApp](/docs/guides/whatsapp/message-types) : la fenêtre de service client et le modèle partagé par tous les messages de service - [Vidéo](/docs/guides/whatsapp/message-types/video) : pour un clip vidéo au lieu d'un audio - [Stickers](/docs/guides/whatsapp/message-types/stickers) : une autre branche média sans champ de légende - [Envoyer des messages WhatsApp](/docs/guides/whatsapp/sending-whatsapp) : l'enveloppe de requête, le modèle `202`, et les réessais sûrs ## Related resources - [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video) - [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer) - [WhatsApp message builder](/tools/whatsapp-message-builder) (tool) - [WhatsApp](/products/whatsapp) (product) [Get an implementation brief](/learn/workspace?topic=whatsapp)