Médias reçus

Quand un client envoie une photo, un document ou un message vocal, WhatsApp ne transmet qu'un identifiant. Ces routes récupèrent le fichier.

Télécharger

POST /whatsapp/media/{mediaId}/download

{ "downloadAndStore": true, "filename": "facture.pdf" }

Avec downloadAndStore, le fichier est rangé dans le stockage de la boutique et l'URL renvoyée est durable. Sans, tu reçois l'URL temporaire de Meta, qui expire vite.

filename porte le nom d'origine du document. C'est le seul endroit où survit la vraie extension : le nom stocké est dérivé du type MIME, et un .xlsx y devient un .zip.

Transcrire un vocal

POST /whatsapp/media/transcribe

Rend le texte d'un message vocal. Sur les marchés où la voix domine l'écrit, c'est ce qui permet de traiter automatiquement des demandes qui n'arrivent jamais sous forme de texte.

Tu n'as pas de compte WhatsApp à préciser

Le compte WhatsApp Business est déduit de ta clé, comme partout ailleurs dans cette API. Il est en base depuis la connexion de ton numéro dans les réglages.

Un champ wabaId dans une requête est refusé : cette fonction autorise sur ce seul champ, l'accepter du client donnerait accès aux médias reçus par n'importe quelle boutique de la plateforme.

Si aucun numéro n'est relié, la réponse est whatsapp_not_connected.