Agent AI untuk Toko Online Indonesia: Kurir, Stok, dan Retur

Agent AI untuk toko online Indonesia bukan chatbot yang cuma balas “siap kak”. Dia lapisan yang mengubah pesan pembeli jadi aksi nyata: pilih kurir, hitung ongkir, buat resi, potong stok, dan buka tiket retur. Urgensinya masuk akal secara angka. Badan Pusat Statistik memperkirakan ada sekitar 3,81 juta usaha e-commerce di Indonesia pada 2024, dan 95,33 persen di antaranya berjualan lewat aplikasi pesan instan, bukan marketplace (BPS, Statistik E-Commerce 2024). Artinya, tempat kerja agent ya WhatsApp, bukan dashboard.

• Inti kerja: tiga alur yang layak diotomasi adalah kurir, stok, dan retur. Sisanya, terutama nawar harga dan komplain emosional, tetap manusia.
• Batas API nyata: RajaOngkir Starter gratis 100 hit per hari. Biteship Grow dapat 10.000 rate request per bulan, lebihnya Rp5 per request.
• Retur itu state machine, bukan percakapan bebas: order harus berstatus delivered, satu order hanya boleh punya satu retur aktif, dan approve retur butuh paket Grow ke atas.
• Biaya terbesar biasanya bukan token, tapi salah pilih kurir dan stok yang tidak direservasi.
• Mulai dari satu alur, ukur hasilnya, baru tambah alur kedua.

Kenapa agent AI untuk toko online Indonesia beda dari agent biasa?

Karena input-nya bukan form, tapi chat setengah berantakan, dan output-nya menyentuh uang serta barang fisik. Pembeli menulis alamat seperti “Jl. Melati no 7, deket masjid, patokannya warung biru”. Tidak ada dropdown kecamatan di sana. Agent harus menormalkan alamat, mencocokkannya ke area ID kurir, lalu mengembalikan ongkir yang benar. Salah satu langkah meleset, paket bisa dikirim ke kecamatan sebelah.

Konteks pasar juga beda. BPS mencatat hanya 17,80 persen pelaku e-commerce lokal memakai marketplace pada 2023, sementara 95,33 persen memakai aplikasi pesan instan. Jadi jangan bangun agent yang cuma hidup di halaman checkout. Bangun yang bisa baca pesan, tanya balik satu pertanyaan klarifikasi, lalu eksekusi.

Tiga alur yang layak di-agent-kan

1. Kurir: dari cek ongkir sampai resi

Ini alur paling terukur karena input dan output-nya jelas. Di RajaOngkir, akun Starter gratis sudah dapat 100 hit per hari untuk cek ongkir, dengan 17 ekspedisi domestik dan 6 ekspedisi internasional. Paket Pro Rp149.000 per bulan (dari Rp200.000) menaikkan kuota ke 25.000 hit per hari, sedangkan Enterprise Rp249.000 per bulan dapat 50.000 hit per hari plus pembuatan AWB, pickup, tracking, dan print label (harga resmi RajaOngkir).

Biteship mengambil pendekatan berbeda: satu API untuk banyak kurir, dengan endpoint POST /v1/rates/couriers, POST /v1/orders, GET /v1/trackings/..., dan GET /v1/maps/areas. Paket Grow memberi 10.000 rate request, 2.000 tracking, 50.000 maps, 2.000 order, dan 200 retur per bulan. Kelebihan rate request ditagih Rp5 per request, tracking Rp10, maps Rp2. Order dan retur tidak punya overage: begitu kuota habis, request ditolak dengan kode 422 sampai periode berikutnya (Biteship Plans and limits).

Hitungan kasar untuk toko dengan 500 order per hari:

Asumsi: 1 rate request + 1 tracking check per order, 30 hari
Rate request   : 500 x 30 = 15.000
Kuota Grow     : 10.000
Overage rate   : 5.000 x Rp5   = Rp25.000
Tracking       : 15.000
Kuota Grow     : 2.000
Overage track  : 13.000 x Rp10 = Rp130.000
Total overage  : Rp155.000 per bulan

Angka itu belum termasuk langganan Grow, yang harganya tidak dipublikasikan di dokumentasi dan harus dicek di dashboard. Yang penting dari hitungan ini: polling resi tiap 30 menit untuk 500 order aktif akan membakar kuota tracking dalam hitungan hari. Pakai webhook untuk perubahan status, dan simpan polling hanya sebagai jaring pengaman.

2. Stok: reservasi, bukan angka di spreadsheet

Kesalahan klasik agent stok adalah membaca angka lalu menulis angka baru. Dua pembeli klik bersamaan, agent membaca stok 1 untuk dua-duanya, dan toko menjual barang yang tidak ada. Yang benar, agent memanggil operasi reservasi atomik di sistem gudang: reserve(sku, qty, order_id), yang mengembalikan sukses atau gagal dalam satu transaksi. Kunci idempotensinya order_id, supaya retry tidak memotong stok dua kali.

Agent juga butuh aturan pelepas: reservasi kedaluwarsa setelah 30 menit kalau pembayaran belum masuk. Tanpa itu, stok terkunci oleh keranjang yang ditinggal, dan toko kelihatan kosong padahal barangnya ada di rak.

3. Retur: state machine yang harus ditutup

Retur adalah bagian yang paling sering dijanjikan agent tapi paling jarang benar. Biteship mendokumentasikan alurnya cukup ketat: retur hanya bisa dibuat untuk order yang sudah delivered, satu order hanya boleh punya satu retur aktif, dan setiap unit yang diretur butuh satu alasan. Kode alasan yang tersedia: wrong_item, wrong_size, defect, missing_part, expired, dan other (Biteship Return API).

Statusnya berjalan dari requested, in_review, approved, confirmed, lalu delivered. Perhatikan satu detail yang sering kelewat: membuat retur tersedia di semua paket, tapi melihat daftar retur dan melakukan review butuh entitlement halaman retur yang baru ada di Grow ke atas. Kuota retur pun kecil: Starter 10, Grow 200, Scale 1.000 per bulan, tanpa overage.

Artinya, agent retur tidak boleh langsung menyetujui. Pola yang aman: agent mengumpulkan bukti (foto, nomor order, alasan), mengisi form, lalu menaruh tiket di status requested untuk disetujui manusia. Keputusan uang tetap di tangan lo.

Arsitektur minimal yang cukup

Tidak perlu framework berat. Yang perlu ada cuma lima bagian, dan urutannya penting:

Chat masuk (WhatsApp/IG)
  -> webhook receiver, simpan mentah + id pesan
  -> agent: klasifikasi intent + ekstrak entitas
  -> tools deterministik: cek stok, cek ongkir, buat order
  -> gerbang approval untuk aksi berisiko (retur, diskon, kirim ulang)
  -> tulis hasil balik ke chat + log audit

Model bahasa duduk di langkah klasifikasi dan ekstraksi, bukan di langkah menulis database. Semua aksi yang mengubah state harus lewat fungsi dengan validasi sendiri. Kalau model salah membaca alamat, fungsi create_order yang menolak, bukan model yang “berusaha lebih keras”.

Untuk model dan gateway, pilihan lokal maupun berlangganan sama-sama valid. Kalau lo butuh akses banyak model dari satu kunci, NgodeAI bisa jadi jalur cepat untuk eksperimen sebelum produksi. Yang wajib ada di lapisan ini: timeout, retry dengan backoff, dan batas biaya per percakapan. Agent toko online yang tidak punya batas biaya akan dihabiskan oleh satu pembeli iseng.

Kalau lo mau menjalankan agent-nya sendiri, OpenCrabs adalah opsi self-hosted yang menggabungkan channel chat, cron, dan tool execution dalam satu binary Rust (repo OpenCrabs). Cocok kalau lo tidak mau data order keluar dari VPS sendiri. Tapi jangan salah paham: agent tetap butuh API kurir berbayar di belakangnya, dan itu biaya terpisah.

Kapan pakai agent, kapan cukup template?

• Pakai agent kalau pesanan masuk lewat chat, alamat bervariasi, dan ada lebih dari dua kurir yang harus dibandingkan.
• Cukup template kalau semua order masuk lewat checkout terstruktur dan cuma butuh notifikasi resi. Di kasus ini, webhook plus pesan otomatis jauh lebih murah dan tidak bisa salah tafsir.
• Jangan pakai agent untuk keputusan diskon, refund penuh, atau blokir pembeli. Itu keputusan bisnis, bukan tugas parsing.
• Pakai agent dengan approval untuk retur, kirim ulang, dan perubahan alamat setelah resi terbit.

Perbandingan tiga pendekatan

Pendekatan        Cocok untuk              Kelemahan utama
Manual chat       < 20 order/hari          Tidak skalabel, sering salah
Template + webhook  checkout terstruktur   Tidak paham pesan bebas
Agent + tools     chat, alamat campur      Butuh guardrail + biaya API

Bedanya bukan soal pintar atau tidak. Bedanya ada di siapa yang menanggung kesalahan. Template gagal dengan cara yang bisa diprediksi. Agent gagal dengan cara yang kreatif, jadi guardrail-nya harus lebih tebal.

Biaya yang sering lupa dihitung

Biaya token biasanya yang paling kelihatan, padahal porsinya kecil. Yang lebih sering membengkak: kuota API kurir, retry yang tidak dibatasi, dan ongkos kirim ulang akibat alamat salah. Satu paket salah kecamatan bisa menghapus margin tiga order.

Untuk beban inference, Alibaba Cloud AI menyediakan jalur token dan model yang bisa dipakai untuk agent produksi. Sebelum commit, hitung dulu biaya per percakapan: rata-rata token input, token output, jumlah tool call, dan persentase chat yang butuh dua putaran. Tanpa empat angka itu, proyeksi biaya lo cuma tebakan.

Satu lagi yang jarang ditulis di studi kasus: angka retur per kategori tidak dipublikasikan seragam. Jangan pakai benchmark asing sebagai patokan. Ambil data retur toko lo sendiri selama 90 hari, lalu pakai itu untuk memutuskan apakah agent retur layak dibangun sekarang atau tahun depan.## Rekomendasi Tools & Layanan

• Kurir: mulai dari RajaOngkir Starter (gratis, 100 hit per hari) kalau volume masih kecil. Pindah ke Biteship kalau butuh satu API untuk banyak kurir plus manajemen retur.
• Model: pisahkan model murah untuk klasifikasi intent dan model lebih kuat untuk kasus ambigu. Jangan pakai model termahal untuk membaca nomor resi.
• Infrastruktur: agent yang jalan 24 jam butuh VPS kecil yang stabil. Alibaba Cloud punya paket pemula yang cukup untuk webhook receiver plus worker antrean, dan biayanya lebih mudah diprediksi daripada menumpuk semuanya di satu server produksi.
• Observability: log setiap tool call beserta argumen dan hasilnya. Tanpa itu, saat agent salah kirim barang, lo tidak punya bukti untuk menelusuri di langkah mana melesetnya.
• Guardrail: batas biaya per percakapan, batas retry, dan daftar aksi yang wajib approval. Tiga hal ini lebih menentukan umur agent daripada pilihan model.

FAQ

Berapa biaya API kurir untuk 500 order per hari?

Dengan asumsi satu rate request dan satu cek tracking per order selama 30 hari, paket Grow Biteship kena overage sekitar Rp155.000 per bulan (5.000 rate request x Rp5, ditambah 13.000 tracking x Rp10). Harga langganan Grow sendiri tidak dipublikasikan di dokumentasi dan harus dicek di dashboard.

Apakah agent AI bisa membuat resi sendiri?

Bisa. Biteship menyediakan POST /v1/orders untuk membuat order pengiriman, dan RajaOngkir menyediakan pembuatan AWB di paket Enterprise. Yang tidak boleh otomatis: mengubah alamat setelah resi terbit atau mengganti kurir tanpa persetujuan, karena biayanya tidak bisa dibatalkan.

Apakah retur bisa disetujui otomatis?

Secara teknis bisa, tapi tidak disarankan. Retur menyentuh uang dan barang, kuotanya kecil (Starter 10 per bulan), dan review retur butuh entitlement Grow ke atas. Pola aman: agent menyiapkan tiket, manusia yang menekan approve.

Apakah toko online harus masuk marketplace dulu?

Tidak. Data BPS 2024 menunjukkan 95,33 persen pelaku e-commerce lokal justru berjualan lewat aplikasi pesan instan, dan hanya 17,80 persen memakai marketplace. Kalau penjualan lo sudah di WhatsApp, bangun agent di sana, jangan pindah kanal demi terlihat modern.

Berapa lama membangun agent toko online yang layak?

Belum ada benchmark publik yang bisa dipakai, jadi ini estimasi kerja, bukan angka riset. Mulai dari satu alur (notifikasi resi berbasis webhook) yang biasanya bisa live dalam hitungan hari, lalu tambah alur stok dan retur setelah log-nya bersih. Jangan bangun tiga alur sekaligus.