Panoramica
Carica immagini, video o documenti per header di template WhatsApp per destinatario. POST multipart/form-data con campo file. Restituisce media_id per header_media_id nell'invio. DELETE /api/v2/whatsapp/media/{id} rimuove asset inutilizzati.
POST /api/v2/whatsapp/media
Invia multipart/form-data con campo binario file. Non impostare Content-Type manualmente in fetch — FormData imposta il boundary.
curl --request POST \
'https://app.buzzbip.com/api/v2/whatsapp/media' \
--header 'Authorization: Bearer YOUR_JWT' \
--form 'file=@/path/to/invoice-april.pdf'Note d'uso
⚠️ Nota: i valori media_id sono legati all'utente. Un file caricato dall'utente A non può essere usato dall'utente B. Carica sempre con l'account che invierà il messaggio. 💡 Suggerimento: usa il flusso in due passaggi — carica prima per ottenere media_id, poi usa header_media_id nell'invio del template.
Nota: i valori media_id sono legati all'utente. Un file caricato dall'utente A non può essere usato dall'utente B. Carica sempre con l'account che invierà il messaggio.
Note di integrazione
Integrando questo endpoint Buzzbip, usa https://app.buzzbip.com come host di produzione. Ottieni un JWT da POST /api/login_check e invia Authorization: Bearer su ogni richiesta. Verifica che User.hasApiAccess sia abilitato nell'admin Buzzbip. Le route WhatsApp v2 non usano slash finali. Implementa retry con backoff in caso di rate limit. Conserva le credenziali lato server e riautenticati prima della scadenza JWT (3600 s).
Sicurezza
Best practice: credenziali solo lato server, TLS obbligatorio, monitoraggio autenticazioni fallite. Separa account staging e produzione. Documenta template e automazioni. Redigi numeri e contenuti nei log condivisi.
Prossimi passi
Pagine correlate: api/v2/whatsapp-templates/send-template api/v2/whatsapp-templates guides/whatsapp-v2-use-cases
