Yang berubah
Perubahan ini menyangkut cara Agent API membaca parameter tanggal. Sebelumnya tanggal yang formatnya tidak dikenali diabaikan tanpa pesan error, sehingga jawaban bisa berisi periode lain dari yang diminta. Sekarang permintaan seperti itu ditolak dengan 400 VALIDATION_ERROR, dan error.details.invalid menyebut parameter yang salah.
| Endpoint dan parameter | Sebelumnya | Sekarang |
|---|---|---|
/api/agent/analytics/* dan /api/agent/conversions/*: from, to | Nilai selain YYYY-MM-DD diabaikan dan periode 30 hari terakhir dipakai. | Hanya YYYY-MM-DD, dibaca sebagai hari kalender WIB (UTC+7). Waktu ISO dan tanggal yang tidak ada seperti 2026-09-31 ditolak dengan 400. |
/api/agent/leads: createdFrom, createdTo (atau from, to) | Tanggal tanpa jam dibaca sebagai pukul 00.00 UTC, yaitu 07.00 WIB. Nilai yang tidak terbaca dibuang dan daftar kembali tanpa batas itu. | YYYY-MM-DD berarti satu hari penuh WIB, dari 00.00 sampai 23.59. Waktu ISO 8601 tetap diterima, dan waktu tanpa offset dibaca sebagai WIB. Nilai yang tidak terbaca ditolak dengan 400. |
/api/agent/leads/:id/messages: after, before | Dibaca seperti filter lead yang lama. | Dibaca seperti filter lead yang baru. |
- Jika integrasi Anda mengirim waktu ISO ke
fromatautopada endpoint analytics atau conversions, ganti denganYYYY-MM-DD. - Di dalam URL, tanda
+pada offset waktu ditulis%2B. Tanpa itu nilainya tidak terbaca dan ditolak. - Permintaan analytics atau conversions tanpa
fromdantomemakai periode bawaan: hari ini menurut WIB dan 29 hari sebelumnya. - Periode yang dipakai tertulis di response dalam UTC, pada
data.rangeataumeta.range. - Tool MCP yang menerima periode memakai aturan yang sama dan mengembalikan pesan error yang sama.
Integrasi lama bisa menerima 400Pemanggil yang selama ini mengandalkan tanggal yang diabaikan sekarang menerima error 400 dan perlu memperbaiki format tanggalnya. Hari dihitung dalam WIB untuk semua workspace, apa pun zona waktu workspace itu.
Tersedia untuk siapa
Berlaku untuk semua API key Agent API dan untuk koneksi MCP, pada paket yang mencakup API & Webhook. Agent API tetap hanya membaca data. Halaman laporan di aplikasi Dalekta tidak berubah, karena aplikasi selalu mengirim tanggalnya sendiri. Hari tidak mengikuti zona waktu workspace.