Media verzenden: afbeeldingen, video, audio en documenten
Media verzend je door het bestand eerst te uploaden en te verwijzen naar het id dat je terugkrijgt, of door Meta een openbare link te geven. Uploaden is betrouwbaarder en de limieten verschillen per type, op manieren die vaak voor verrassingen zorgen.
De maximale afbeeldingsgrootte op de Cloud API.
De maximale grootte voor video en audio.
De maximale grootte voor documenten.
De limieten per type
Ze verschillen per type. Overschrijding levert foutcode 131053 op, zonder duidelijke uitleg.
- Afbeeldingen: 5 MB. JPEG en PNG.
- Video: 16 MB. MP4 en 3GPP, met H.264-video en AAC-audio.
- Audio: 16 MB. AAC, AMR, MP3, MP4-audio en OGG met Opus.
- Documenten: 100 MB. De meest voorkomende documenttypen, waaronder PDF- en Office-indelingen.
- Stickers: 100 KB geanimeerd, 500 KB statisch, alleen WebP.
Uploaden versus linken
Je kunt hetzelfde bestand op twee manieren verzenden, en ze mislukken op verschillende manieren.
Bij uploaden plaats je het bestand eerst bij Meta en krijg je een media-id terug waarnaar je verwijst bij het verzenden. Bij linken geef je Meta een URL die tijdens het verzenden wordt opgehaald. Die route lijkt eenvoudiger, maar voegt een foutmogelijkheid toe die je niet ziet: een URL die in je browser werkt, kan onbereikbaar zijn voor de infrastructuur van Meta door geografische beperkingen, een firewallregel of een sessiecookie die je browser al heeft.
Uploaden dus. Het is één extra verzoek en voorkomt een hele reeks fouten.
Media ontvangen
Binnenkomende media arriveert als media-id, niet als bytes. Je handler haalt het bestand afzonderlijk op met dat id.
- Haal het snel op. Ids blijven niet onbeperkt geldig.
- Een mislukte ophaling levert foutcode 131052 op. Dat betekent meestal dat het uploaden door de afzender niet is voltooid.
- Bewaar het bestand zelf als je het later nodig hebt. Meta is geen archief.
- Leg het bericht vast, ook als het ophalen van de media mislukt, zodat de tekst en context bewaard blijven.
Wat Coexistence verandert
Media op een Coexistence-nummer werkt precies zoals op elk ander Cloud API-nummer, met dezelfde limieten.
Het enige verschil dat je moet kennen is de geschiedenis. Wanneer een nummer voor het eerst verbinding maakt, synchroniseert Meta recente berichten uit de WhatsApp Business-app. Die synchronisatie bevat berichttekst, maar is geen volledig media-archief. Media van vóór de verbinding staat op de telefoon, zoals altijd.
Veelgemaakte fouten
- Een link verzenden omdat die eenvoudiger lijkt. Het netwerk van Meta is niet je browser.
- Binnenkomende media pas uren later ophalen. Media-ids verlopen.
- Video exporteren zonder de codec te controleren. Standaardinstellingen van bewerkingssoftware worden vaak niet ondersteund.
EasyCoexistence levert binnenkomende berichtgebeurtenissen rechtstreeks van Meta aan je endpoint, zodat media-ids direct je systeem bereiken en je ze kunt ophalen zolang ze geldig zijn.
Veelgestelde vragen
Wat is het grootste bestand dat ik kan verzenden?
100 MB, en alleen voor documenten. Voor video en audio geldt 16 MB en voor afbeeldingen 5 MB.
Moet ik uploaden of een URL verzenden?
Uploaden. Zo is bereikbaarheid geen oorzaak van fouten meer.
Hoe lang blijft een media-id geldig?
Niet onbeperkt. Daarom moet je binnenkomende media ophalen zodra de gebeurtenis arriveert.
Synchroniseert oude media wanneer ik verbinding maak?
Nee. Geschiedenissynchronisatie bevat recente berichtinhoud; media van vóór de verbinding blijft op de telefoon.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op