# Menerima video WhatsApp

Klip yang direkam atau dilampirkan kontak masuk sebagai pesan inbound yang membawa `video`: referensi media yang sama dengan yang digunakan setiap cabang media inbound, ditambah caption yang mereka ketik di bawahnya.

## Isi video inbound

```json
{
  "id": "wam_01kyc5r9pewu7s3j6m0xyd5qgb",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "video": {
    "id": "waf_01kyc4n5yr8xit1e9o4qsw7ufa",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyc5r9pewu7s3j6m0xyd5qgb/media/waf_01kyc4n5yr8xit1e9o4qsw7ufa",
    "mime_type": "video/mp4",
    "caption": "The rattle starts around 0:12"
  },
  "created_at": "2026-08-25T09:11:48Z"
}
```

| Field       | Isinya                                                                           |
| ----------- | -------------------------------------------------------------------------------- |
| `id`        | File tersimpan, diteruskan sebagai `media_id` saat mengambil byte                |
| `url`       | URL Bird, diambil dengan kunci API Anda                                          |
| `mime_type` | Tipe media yang dilaporkan WhatsApp untuk klip tersebut, misalnya `video/mp4`    |
| `caption`   | Teks yang diketik kontak di bawah video; tidak ada jika mereka tidak mengirimnya |

Cabang ini tidak membawa durasi, dimensi, maupun thumbnail. Baca informasi tersebut dari file itu sendiri setelah Anda mendapatkan byte-nya, atau dari pipeline media Anda sendiri.

`id` dan `mime_type` hanya muncul pada video inbound, karena Bird mengetahui keduanya dengan mengambil file tersebut. Video outbound terbaca kembali dengan `url` yang Anda berikan dan tanpa `id`.

## Mengambil byte

Teruskan ID pesan dan `id` media ke metode media channel. Halaman [mengambil media inbound](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) di hub memuat panggilan tersebut dalam setiap bahasa, beserta aturan redirect dan header yang diikutinya.

Video adalah hal terbesar yang kemungkinan dikirim kontak kepada Anda, dan pengambilan menyajikan byte langsung dari penyimpanan, bukan melalui API, jadi streaming respons ke disk atau bucket Anda sendiri alih-alih menyimpannya di buffer. Pesan dan medianya kedaluwarsa bersamaan, 30 hari setelah pesan tiba; halaman [mengambil media inbound](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) di hub mengatur jendela waktu tersebut dan apa yang dikembalikan setelah jendela itu berlalu.

## Payload webhook

`whatsapp.received` membawa cabang `video` pada envelope event:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:11:48.204Z",
  "data": {
    "whatsapp_id": "wam_01kyc5r9pewu7s3j6m0xyd5qgb",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "video": {
      "id": "waf_01kyc4n5yr8xit1e9o4qsw7ufa",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyc5r9pewu7s3j6m0xyd5qgb/media/waf_01kyc4n5yr8xit1e9o4qsw7ufa",
      "mime_type": "video/mp4",
      "caption": "The rattle starts around 0:12"
    },
    "tags": null,
    "metadata": null
  }
}
```

Ambil klip dari worker antrean, bukan di dalam handler webhook: endpoint harus merespons dengan cepat, dan media tetap tersedia selama seluruh jendela retensi.

## Hal yang perlu diperhatikan

- **Video note terbaca sebagai video.** Video note bulat dari WhatsApp masuk pada cabang ini tanpa flag pembeda, tidak seperti audio, di mana voice note menyetel `voice`.
- **Satu klip per pesan.** Beberapa video masuk sebagai beberapa pesan inbound, masing-masing dengan referensi medianya sendiri.

## Langkah selanjutnya

- [Cara kerja penerimaan](/docs/guides/whatsapp/receiving-whatsapp): envelope inbound, pengambilan media, dan webhook `whatsapp.received`
- [Pesan video WhatsApp](/docs/guides/whatsapp/message-types/video): sisi pengiriman dari cabang yang sama
- [Menerima audio](/docs/guides/whatsapp/receiving-whatsapp/audio): voice note dan file audio terlampir
- [Event WhatsApp](/docs/guides/whatsapp/events): daftar event lengkap, melalui API atau webhook

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)