Wysyłanie multimediów: obrazów, wideo, audio i dokumentów
Media wysyła się, najpierw przesyłając plik i podając zwrócony identyfikator albo przekazując Meta publiczny link do pobrania. Przesyłanie jest bardziej niezawodne, a limity rozmiaru różnią się zależnie od typu, co często zaskakuje.
Limity według typu
Każdy typ ma inny limit, a jego przekroczenie zwraca kod błędu 131053 zamiast pomocnego opisu.
- Obrazy: 5 MB. JPEG i PNG.
- Wideo: 16 MB. MP4 i 3GPP, z wideo H.264 i dźwiękiem AAC.
- Audio: 16 MB. AAC, AMR, MP3, audio MP4 oraz OGG z Opus.
- Dokumenty: 100 MB. Najpopularniejsze typy dokumentów, w tym PDF i formaty Office.
- Naklejki: 100 KB animowane, 500 KB statyczne, wyłącznie WebP.
Przesyłanie a linkowanie
Ten sam plik można wysłać na dwa sposoby, ale każdy z nich zawodzi inaczej.
Przesyłanie najpierw umieszcza plik w Meta i zwraca identyfikator multimediów, którego używasz podczas wysyłania. Linkowanie przekazuje Meta adres URL do pobrania w chwili wysyłki. Link wydaje się prostszy, ale dodaje niewidoczne źródło błędów: adres URL, który działa w Twojej przeglądarce, może być niedostępny dla infrastruktury Meta z powodu lokalizacji, reguły zapory lub ciasteczka sesji przechowywanego już przez przeglądarkę.
Przesyłaj plik. To jedno dodatkowe żądanie, które usuwa całą klasę problemów.
Odbieranie multimediów
Media przychodzą jako identyfikator multimediów, a nie bajty. Twoja obsługa pobiera plik osobno, używając tego identyfikatora.
- Pobierz plik szybko. Identyfikatory nie pozostają ważne bezterminowo.
- Nieudane pobranie zwraca kod błędu 131052, co zwykle oznacza, że przesyłanie od nadawcy było niepełne.
- Jeśli potrzebujesz pliku później, przechowuj go u siebie. Meta nie jest archiwum.
- Zapisuj wiadomość nawet wtedy, gdy pobranie multimediów się nie powiedzie, aby zachować tekst i kontekst.
Co zmienia Coexistence
Media na numerze Coexistence działają dokładnie tak jak na każdym innym numerze Cloud API, z tymi samymi limitami.
Warto znać jedną różnicę: historię. Gdy numer łączy się po raz pierwszy, Meta synchronizuje ostatnie wiadomości z aplikacji WhatsApp Business, ale synchronizacja obejmuje tekst wiadomości, a nie pełne archiwum multimediów. Media sprzed połączenia są na telefonie, tak jak wcześniej.
Typowe błędy
- Wysyłanie linku, bo wydaje się prostszy. Sieć Meta to nie Twoja przeglądarka.
- Pobieranie multimediów przychodzących kilka godzin później. Identyfikatory multimediów wygasają.
- Eksportowanie wideo bez sprawdzenia kodeka. Domyślne ustawienia programów do edycji często nie są obsługiwane.
EasyCoexistence przekazuje zdarzenia przychodzących wiadomości prosto z Meta do Twojego endpointu, więc identyfikatory multimediów trafiają do Twojego systemu od razu i można ich użyć, póki są ważne.
Najczęściej zadawane pytania
Jaki jest największy plik, który mogę wysłać?
100 MB, ale tylko w przypadku dokumentów. Wideo i audio mają limit 16 MB, a obrazy 5 MB.
Czy mam przesłać plik czy wysłać URL?
Prześlij plik. Eliminuje to dostępność adresu jako przyczynę błędu.
Jak długo identyfikator multimediów pozostaje ważny?
Nie bezterminowo, dlatego multimedia przychodzące należy pobrać zaraz po nadejściu zdarzenia.
Czy stare multimedia synchronizują się po połączeniu?
Nie. Synchronizacja historii obejmuje treść ostatnich wiadomości, a media sprzed połączenia pozostają na telefonie.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w