Zum Inhalt springen
OmniChannels.ai
Menü

WhatsApp Business API

Welche Größenlimits gelten für Mediendateien der WhatsApp-API?

Aktualisiert

Kurze Antwort

Metas Dokumentation nennt zum Zeitpunkt der Erstellung diese Höchstgrößen für Medien der WhatsApp Cloud API: Bilder 5 MB (JPEG, PNG, statisches WebP), Video 16 MB (MP4 oder 3GPP mit H.264 und AAC), Audio 16 MB, Dokumente 100 MB, animierte Sticker 500 KB und statische Sticker 100 KB. Laden Sie die Datei hoch und senden Sie ihre Medien-ID statt eines Links, und prüfen Sie, ob der MIME-Typ zur Datei passt.

Größenlimits nach Medientyp

Die Obergrenze der Cloud API liegt für jedes Medium bei 100 MB. Eine Datei kann das Größenlimit einhalten und trotzdem wegen ihres Formats abgelehnt werden, etwa ein Video ohne H.264 mit AAC-Audio oder ein Bild, das nicht 8-Bit-RGB oder -RGBA ist.

MedientypHöchstgrößeHinweise
Bild5 MBNur 8-Bit-RGB oder -RGBA
Video16 MBH.264-Video, AAC-Audio
Audio16 MBAAC, AMR, MP3, M4A, Opus-codiertes OGG
Dokument100 MBOffice-, PDF- und Textdateien
Sticker (animiert)500 KBNur WebP
Sticker (statisch)100 KBNur WebP

Hochladen oder verlinken, und wie lange IDs gelten

Meta empfiehlt für bessere Leistung, die Datei hochzuladen und ihre Medien-ID zu senden. Von einem Upload zurückgegebene IDs sind 30 Tage gültig, in eingehenden Webhooks empfangene IDs 7 Tage. Laden Sie Kundendateien daher zügig herunter. Eine Download-URL läuft nach 5 Minuten ab.

Bild-, Video- und Dokument-Beschriftungen dürfen bis zu 1.024 Zeichen lang sein. Audio- und Sticker-Nachrichten haben keine Beschriftung.

Häufige Fehler

  • Nur nach der Größe urteilen und Codec oder Farbformat ignorieren.
  • Eine Datei mit nicht passendem MIME-Typ ausliefern, eine übliche Ursache für Fehler 131053.
  • Sich auf eine Medien-ID verlassen, die älter als 30 Tage ist.
  • Animiertes WebP als Bild senden, was abgelehnt wird.

Offizielle Quellen