Vue d'ensemble
Téléversez des images, vidéos ou documents pour les en-têtes de modèles WhatsApp par destinataire. POST multipart/form-data avec le champ file. Renvoie media_id pour header_media_id à l'envoi. DELETE /api/v2/whatsapp/media/{id} supprime les assets inutilisés.
POST /api/v2/whatsapp/media
Envoyez multipart/form-data avec le champ binaire file. Ne définissez pas Content-Type manuellement avec fetch — FormData gère la boundary.
curl --request POST \
'https://app.buzzbip.com/api/v2/whatsapp/media' \
--header 'Authorization: Bearer YOUR_JWT' \
--form 'file=@/path/to/invoice-april.pdf'Notes d'utilisation
⚠️ Note : les valeurs media_id sont limitées à l'utilisateur. Un fichier téléversé par l'utilisateur A ne peut pas être utilisé par l'utilisateur B. Téléversez toujours avec le compte qui enverra le message. 💡 Astuce : utilisez le flux en deux étapes — téléversez d'abord pour obtenir media_id, puis référencez header_media_id à l'envoi du modèle.
Note : les valeurs media_id sont limitées à l'utilisateur. Un fichier téléversé par l'utilisateur A ne peut pas être utilisé par l'utilisateur B. Téléversez toujours avec le compte qui enverra le message.
Notes d'intégration
Lors de l'intégration de ce endpoint Buzzbip, utilisez https://app.buzzbip.com comme hôte de production. Obtenez un JWT via POST /api/login_check et envoyez Authorization: Bearer sur chaque requête. Vérifiez que User.hasApiAccess est activé dans l'admin Buzzbip. Analysez les réponses JSend (status, message, data). Les routes WhatsApp v2 n'utilisent pas de slash final. Implémentez des nouvelles tentatives avec backoff en cas de limite de débit. Stockez les identifiants côté serveur et réauthentifiez-vous avant l'expiration du JWT (3600 s).
Sécurité
Bonnes pratiques : credentials uniquement côté serveur, TLS obligatoire, surveillance des échecs d'authentification. Séparez comptes staging et production. Documentez modèles et automatisations déclenchés. Masquez numéros et contenus dans les journaux partagés.
Et ensuite ?
Pages liées : api/v2/whatsapp-templates/send-template api/v2/whatsapp-templates guides/whatsapp-v2-use-cases