Copy page

Agent

Mengirim Media

Mengirim Media

Selain teks, agent dapat mengirim lampiran media kepada pelanggan: gambar, dokumen PDF, video pendek, dan file audio. Lampiran dikirim melalui fitur Upload yang terhubung ke object storage internal (MinIO / S3-compatible).

Rute frontend: /inbox (ikon paperclip di kotak input)

Ringkasan

Alur media di OmniStream selalu dua langkah:

1. Upload ke storage — file diunggah ke bucket media melalui POST /api/media/upload. Server mengembalikan URL publik atau pre-signed URL.
2. Send pesan — agent mengirim pesan dengan type sesuai media dan URL yang didapat dari langkah 1, via POST /api/conversations/{id}/messages.

Frontend menggabungkan kedua langkah itu dalam satu klik: saat Anda memilih file, sistem otomatis meng-upload lalu menyertakan URL pada body pesan.

Langkah-langkah

1. Buka percakapan dari inbox.
2. Klik ikon Paperclip di kiri textarea input.
3. Pilih salah satu jenis lampiran:
   • Image — JPG, PNG, WebP
   • Document — PDF, DOCX, XLSX
   • Video — MP4 (khusus WhatsApp)
   • Audio — MP3, OGG (khusus WhatsApp)
4. Pilih file dari komputer Anda.
5. Tunggu indikator upload selesai (muncul progress bar).
6. (Opsional) Ketik caption di textarea yang muncul di bawah preview.
7. Klik Send.

Batas ukuran dan format per channel

Channel	Image	Document	Video	Audio
WhatsApp	5 MB (JPG, PNG)	100 MB (PDF, DOC, XLS)	16 MB (MP4)	16 MB (MP3, OGG, AMR)
Instagram	8 MB (JPG, PNG)	Tidak didukung	25 MB (MP4)	Tidak didukung
Email	10 MB per file, total maks 25 MB	Sama	Sama	Sama

Catatan: Batas ini berasal dari limit Meta Graph API untuk WhatsApp dan Instagram. Email mengikuti batas provider SMTP Anda.

Preview dan retry

Sebelum menekan Send, Anda melihat preview:

• Thumbnail untuk gambar dan video.
• Nama file + ukuran untuk dokumen.
• Tombol X untuk membatalkan lampiran.

Jika upload gagal (misalnya karena koneksi), Anda akan melihat pesan error merah di bawah preview dan tombol Retry upload.

Menerima media dari pelanggan

Saat pelanggan mengirim gambar atau file, OmniStream otomatis:

1. Mengunduh media dari Meta (WhatsApp/Instagram) atau attachment email.
2. Menyimpannya ke object storage internal.
3. Menampilkan preview di bubble pesan dengan tombol Download.

Semua media diproses oleh webhook-ingestor dan disimpan ke MongoDB dengan URL storage internal, sehingga tidak ada ketergantungan pada URL Meta jangka panjang (yang biasanya kedaluwarsa dalam hitungan jam).

Praktik terbaik

• Kompres gambar sebelum mengunggah agar pesan lebih cepat terkirim dan pelanggan tidak boros kuota.
• Beri nama file yang deskriptif (invoice-INV-2026-04-11.pdf) — Meta akan menampilkan nama file di bubble WhatsApp pelanggan.
• Caption pada gambar WhatsApp lebih efektif daripada mengirim gambar dan teks dalam dua pesan terpisah.
• Jangan kirim file berisi data sensitif (KTP, dokumen rahasia) melalui channel publik tanpa persetujuan supervisor.

Catatan: Fitur upload hanya aktif jika messaging window pelanggan masih terbuka. Setelah window tertutup, media hanya dapat dikirim melalui template WhatsApp yang mendukung media header.

Langkah kerja khas

1. Buka percakapan.
2. Klik paperclip → pilih Image.
3. Pilih file. Tunggu upload selesai.
4. Tulis caption singkat.
5. Klik Send.
6. Pantau status sent → delivered → read di bubble.

Baca selanjutnya: Quick replies.