Medien senden: Bilder, Videos, Audio und Dokumente
Medien werden entweder zuerst hochgeladen und über die zurückgegebene Media-ID referenziert oder über einen öffentlichen Link bereitgestellt, den Meta abruft. Uploads sind zuverlässiger, und die Größenlimits unterscheiden sich je nach Typ.
Das Größenlimit für Bilder in der Cloud API.
Das Limit für Videos und Audio.
Das Limit für Dokumente.
Die Limits nach Typ
Für jeden Typ gelten andere Limits. Wird eines überschritten, erscheint Fehler 131053 statt einer aussagekräftigen Beschreibung.
- Bilder: 5 MB. JPEG und PNG.
- Video: 16 MB. MP4 und 3GPP, mit H.264-Video und AAC-Audio.
- Audio: 16 MB. AAC, AMR, MP3, MP4-Audio und OGG mit Opus.
- Dokumente: 100 MB. Die meisten gängigen Dokumenttypen, einschließlich PDF und Office-Formate.
- Sticker: 100 KB animiert, 500 KB statisch, nur WebP.
Upload oder Verlinkung
Es gibt zwei Wege, dieselbe Datei zu senden, und sie schlagen unterschiedlich fehl.
Beim Upload wird die Datei zuerst an Meta gesendet. Sie erhalten eine Media-ID, die Sie beim Senden referenzieren. Bei einem Link geben Sie Meta eine URL, die beim Senden abgerufen wird. Der Link wirkt einfacher, bringt aber eine unsichtbare Fehlerquelle mit: Eine URL, die in Ihrem Browser lädt, kann für Metas Infrastruktur wegen der Region, einer Firewall-Regel oder eines Sitzungscookies unerreichbar sein, den Ihr Browser bereits besitzt.
Laden Sie die Datei hoch. Eine zusätzliche Anfrage entfernt eine ganze Fehlerklasse.
Medien empfangen
Eingehende Medien kommen als Media-ID und nicht als Bytes an. Ihr Handler ruft die Datei separat über diese ID ab.
- Rufen Sie sie umgehend ab. IDs bleiben nicht unbegrenzt gültig.
- Ein fehlgeschlagener Abruf gibt Fehler 131052 zurück. Das bedeutet meist, dass der Upload des Absenders unvollständig war.
- Speichern Sie die Datei selbst, wenn Sie sie später benötigen. Meta ist kein Archiv.
- Zeichnen Sie die Nachricht auch dann auf, wenn der Medienabruf fehlschlägt, damit Text und Kontext erhalten bleiben.
Was Coexistence ändert
Medien über eine Coexistence-Nummer funktionieren genau wie über jede andere Cloud API-Nummer, mit denselben Limits.
Der einzige wichtige Unterschied betrifft den Verlauf. Wenn eine Nummer erstmals verbunden wird, synchronisiert Meta aktuelle Nachrichten aus der WhatsApp Business App. Diese Synchronisierung umfasst Nachrichtentext, aber kein vollständiges Medienarchiv. Medien von vor der Verbindung befinden sich weiterhin auf dem Telefon, wo sie schon immer waren.
Häufige Fehler
- Einen Link senden, weil er einfacher wirkt. Metas Netzwerk ist nicht Ihr Browser.
- Eingehende Medien erst Stunden später abrufen. Media-IDs laufen ab.
- Videos exportieren, ohne den Codec zu prüfen. Standardeinstellungen von Bearbeitungsprogrammen werden oft nicht unterstützt.
EasyCoexistence leitet eingehende Nachrichtenereignisse direkt von Meta an Ihren Endpoint weiter. So erreichen Media-IDs Ihr System sofort und können abgerufen werden, solange sie gültig sind.
Häufig gestellte Fragen
Welche größte Datei kann ich senden?
100 MB, und nur für Dokumente. Videos und Audio sind auf 16 MB begrenzt, Bilder auf 5 MB.
Soll ich hochladen oder eine URL senden?
Laden Sie die Datei hoch. Damit entfällt die Erreichbarkeit als Fehlerursache.
Wie lange ist eine Media-ID gültig?
Nicht unbegrenzt. Deshalb sollten eingehende Medien abgerufen werden, sobald das Ereignis eintrifft.
Werden alte Medien synchronisiert, wenn ich eine Verbindung herstelle?
Nein. Die Verlaufssynchronisierung umfasst aktuelle Nachrichteninhalte. Medien von vor der Verbindung bleiben auf dem Telefon.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am