Pag-send ng media: images, video, audio at documents
Ang media ay ipinapadala sa dalawang paraan: i-upload muna ang file at gamitin ang id na ibinabalik nito, o bigyan ang Meta ng public link na kukuhanan nito. Mas maaasahan ang pag-upload, at magkakaiba ang size limits ayon sa uri, na madalas ikinagugulat ng mga user.
Ang image size ceiling sa Cloud API.
Ang ceiling para sa video at audio.
Ang ceiling para sa documents.
Ang limits ayon sa uri
Magkakaiba ang mga ito, at ang paglampas sa isa ay nagbabalik ng error 131053 sa halip na malinaw na paliwanag.
- Images: 5 MB. JPEG at PNG.
- Video: 16 MB. MP4 at 3GPP, na may H.264 video at AAC audio.
- Audio: 16 MB. AAC, AMR, MP3, MP4 audio at OGG na may Opus.
- Documents: 100 MB. Karamihan sa karaniwang document types, kabilang ang PDF at Office formats.
- Stickers: 100 KB animated, 500 KB static, WebP lamang.
Pag-upload kumpara sa pag-link
Dalawang paraan ito para ipadala ang parehong file, at magkaiba ang paraan ng pag-fail ng mga ito.
Sa pag-upload, ipinapadala muna ang file sa Meta at ibinabalik ang media id na gagamitin ninyo kapag nagpapadala. Sa pag-link, binibigyan ang Meta ng URL na kukuhanan nito sa oras ng pagpapadala. Mas simple itong tingnan, pero may failure mode na hindi ninyo nakikita: maaaring hindi maabot mula sa infrastructure ng Meta ang URL na naglo-load sa inyong browser dahil sa lokasyon, firewall rule o session cookie na hawak na ng inyong browser.
Mag-upload po ninyo. Isang dagdag na request lang ito at inaalis nito ang isang buong klase ng failure.
Pagtanggap ng media
Dumarating ang inbound media bilang media id, hindi bilang bytes. Kukunin ng inyong handler ang file nang hiwalay gamit ang id na iyon.
- Kunin agad. Hindi mananatiling valid ang mga id nang walang hanggan.
- Ang bigong pagkuha ay nagbabalik ng error 131052, na karaniwang nangangahulugang hindi kumpleto ang upload ng nagpadala.
- I-store ninyo mismo ang file kung kakailanganin ninyo ito sa susunod. Hindi archive ang Meta.
- I-record ang mensahe kahit mabigo ang pagkuha ng media, para manatili ang text at context.
Ano ang binabago ng Coexistence
Gumagana ang media sa isang Coexistence number tulad ng sa iba pang Cloud API number, kasama ang parehong limits.
Ang isang mahalagang pagkakaiba ay ang history. Kapag unang nag-connect ang isang numero, sini-synchronize ng Meta ang mga kamakailang mensahe mula sa WhatsApp Business app, at sakop ng synchronization na iyon ang message text, hindi ang buong media archive. Nasa phone ang media bago ang koneksyon, kung saan ito palagi naroon.
Mga karaniwang pagkakamali
- Nagpapadala ng link dahil mas simple itong tingnan. Hindi kapareho ng browser ninyo ang network ng Meta.
- Kinukuha ang inbound media makalipas ang ilang oras. Nage-expire ang media ids.
- Nag-e-export ng video nang hindi sinusuri ang codec. Madalas unsupported ang default settings ng editing software.
Direktang ipinapadala ng EasyCoexistence ang inbound message events mula Meta papunta sa inyong endpoint, kaya agad na nakararating sa system ninyo ang media ids at makukuha ang mga ito habang valid pa.
Mga madalas itanong
Ano ang pinakamalaking file na maaari kong ipadala?
100 MB, at para lamang ito sa documents. Ang video at audio ay hanggang 16 MB, at ang images ay hanggang 5 MB.
Dapat ba akong mag-upload o magpadala ng URL?
Mag-upload po ninyo. Inaalis nito ang reachability bilang sanhi ng failure.
Gaano katagal valid ang media id?
Hindi ito valid nang walang hanggan, kaya dapat kunin ang inbound media sa lalong madaling dumating ang event.
Nasi-sync ba ang lumang media kapag nag-connect ako?
Hindi. Sakop ng history synchronization ang kamakailang message content; nananatili sa phone ang media bago ang koneksyon.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong