# Mengirim gambar dan file di Apple Messages

Gunakan template **Image** atau **Document** untuk mengirim gambar produk, instruksi, atau tanda terima dalam percakapan pelanggan yang terbuka. Bird mengambil file sumber dan menyiapkannya untuk Apple selama pemrosesan pesan.

## Siapkan file yang dapat diambil

Hosting file yang dimaksud di URL HTTPS publik yang dapat diambil tanpa cookie browser atau proses masuk. Gunakan file yang sesuai kebutuhan dan aman untuk diekspos di URL tersebut. Halaman pratinjau drive pribadi bukan URL file langsung.

[Referensi send-message](/docs/api/reference/create-amb-message) mendefinisikan batasan media:

| Penggunaan                                 | Persyaratan                                                                                   |
| ------------------------------------------ | --------------------------------------------------------------------------------------------- |
| Lampiran keluar                            | Setiap file lebih kecil dari 100 MB. Berikan nama file dan jenis media yang benar.            |
| Interaksi native atau gambar rich-link     | PNG, maksimal 200 kB per gambar; total gambar interaktif maksimal 5 MB.                       |
| Ikon aplikasi iMessage yang dipublikasikan | PNG lebih kecil dari 15 kB. Lihat [app experiences](/docs/guides/apple-messages/custom-apps). |

Pastikan URL tetap tersedia selama pemrosesan berlangsung. URL bertanda tangan yang kedaluwarsa terlalu cepat dapat menyebabkan kegagalan setelah pesan diterima. Uji URL tanpa browser yang sudah masuk akun dan pastikan URL tersebut mengembalikan file sebenarnya, bukan halaman HTML.

## Konfigurasi template

1. Buka [**Templates**](https://bird.com/dashboard/w/apple-messages/templates) dan pilih **New template > Image** atau **Document**.
2. Di **Content**, beri draf sebuah **Template name** dan masukkan **Message** yang menjelaskan lampiran.
3. Di **Apple delivery**, atur **Attachment URL**, **File name**, dan **Media type**. Misalnya, PDF menggunakan nama file `.pdf` dan `application/pdf`.
4. Pilih bisnis di **Personalization**, lalu simpan draf.
5. [Siapkan dan tinjau pesan](/docs/guides/apple-messages/templates#send-the-reviewed-template), periksa pelanggan dan file yang sebenarnya sebelum mengirim.

Artwork pratinjau bawaan bukan sumber lampiran untuk pengiriman sesungguhnya. Masukkan URL yang Anda maksud secara eksplisit.

## Periksa hasilnya

Periksa pesan yang telah dikirim beserta event-nya, lalu buka lampiran di perangkat uji Apple yang diotorisasi. Periksa keterbacaan, nama file, dan apakah konten tetap dapat dipahami tanpa konteks situs web di sekitarnya.

Jika pesan gagal setelah diterima, periksa error-nya sebelum mengubah template. Penyebab umum meliputi URL yang tidak dapat diakses, tipe media yang tidak sesuai, file yang melebihi batas ukuran, atau data PNG yang tidak valid. Mengubah ekstensi file tidak mengonversi formatnya.

Lampiran masuk dapat muncul berdasarkan nama di transkrip percakapan. Transkrip saat ini tidak menyediakan tindakan unduh yang terautentikasi untuk file tersebut. Operasi pengambilan lampiran dan media bukan bagian dari API publik. Jika layanan Anda memerlukan pengunduhan file masuk, konfirmasikan alur kerja pengambilan yang tersedia dengan Bird sebelum bergantung padanya.