Media

Upload Media

Upload file media ke WhatsApp (Meta) untuk digunakan di pesan dan template. Mengembalikan media_id yang berlaku selama 30 hari.

POST /api/v1/public/media/upload

info

Content-Type: Endpoint ini menggunakan multipart/form-data, bukan JSON. media_id yang dikembalikan bisa dipakai di payload kirim pesan atau template. Media kedaluwarsa setelah 30 hari di server Meta.

Tipe File yang Didukung

Tipe	Format	Ukuran Maks
Gambar	JPEG, PNG, WebP	5 MB
Video	MP4, 3GP	16 MB
Audio	OGG, MP3, AMR	16 MB
Dokumen	PDF, DOC, DOCX	16 MB

Contoh Request

cURL

curl -X POST "https://chat.api.co.id/api/v1/public/media/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

JavaScript

const formData = new FormData();
formData.append("file", fileBlob, "image.jpg");

const response = await fetch("https://chat.api.co.id/api/v1/public/media/upload", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: formData
});

const { data } = await response.json();
// Use data.media_id in your send message payload

Python

import requests

with open("image.jpg", "rb") as f:
    response = requests.post(
        "https://chat.api.co.id/api/v1/public/media/upload",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        files={"file": ("image.jpg", f, "image/jpeg")}
    )

media_id = response.json()["data"]["media_id"]

Response

{
  "success": true,
  "data": {
    "media_id": "1234567890",
    "type": "image",
    "mime_type": "image/jpeg",
    "file_name": "image.jpg",
    "file_size": 245000,
    "whatsapp_phone_number_id": "clyyy9876543210",
    "expires_in": "30 days"
  }
}

Penggunaan: Kirim Media yang Sudah Di-upload

Setelah upload, gunakan media_id sebagai media_url di request kirim pesan Anda:

{
  "phone_number": "628123456789",
  "channel": "whatsapp",
  "message_type": "image",
  "media_url": "1234567890",
  "caption": "Check this out!"
}

Coba langsung

tip

Tekan Try it lalu tempel API key Anda (kc_live_...) ke kolom API key (Bearer). Dapatkan key dari API Keys. Request dijalankan ke akun live Anda, jadi endpoint yang mengirim, membuat, atau menghapus akan memengaruhi data sungguhan.

• POST/api/v1/public/media/uploadUpload Media