AI Tools Integration

Cek Ongkir

Copy page

Tool Cek Ongkir memberikan kemampuan kepada AI Agent Anda untuk menghitung biaya pengiriman secara langsung selama percakapan. Saat pelanggan bertanya "Berapa ongkir ke Surabaya?" atau "Opsi pengiriman apa saja ke Bandung?", Agent mengambil tarif terkini dari kurir Indonesia dan menampilkannya langsung — tanpa perlu mengarahkan pelanggan ke kalkulator ongkir terpisah.

Tool ini cocok untuk bisnis yang sering menerima pertanyaan tentang biaya kirim tetapi tidak membutuhkan alur ecommerce lengkap. Jika Anda membutuhkan pemrosesan pesanan end-to-end (katalog produk, checkout, pembayaran), gunakan tool Ecommerce & Order.

Mengaktifkan Tool

1. Buka menu AI Agent dari sidebar.

2. Pilih Agent yang ingin dikonfigurasi.

3. Klik tab Tools & Integrations di sidebar kiri.

4. Temukan Check Ongkir di daftar tools dan klik.

5. Halaman konfigurasi tool terbuka. Konfigurasikan setiap bagian seperti yang dijelaskan di bawah, lalu klik Save Changes.

Konfigurasi

Form Cek Ongkir memiliki tiga bagian utama: Konfigurasi API, Pengaturan Pengiriman (lokasi asal, berat default, dan kurir), serta AI Prompts.

Konfigurasi API

Pilih penyedia API pengiriman mana yang akan digunakan untuk kalkulasi tarif.

Penyedia	Deskripsi	API Key Diperlukan
Default ChatMo	API pengiriman bawaan. Direkomendasikan untuk sebagian besar pengguna.	Tidak
RajaOngkir	API ongkos kirim Indonesia yang populer.	Ya
Biteship	Platform pengiriman multi-kurir dengan fitur lanjutan.	Ya

Default ChatMo sudah dikonfigurasi dan tidak membutuhkan setup tambahan — pengecekan tarif langsung berfungsi. Jika Anda sudah memiliki akun RajaOngkir atau Biteship dan ingin menggunakannya, pilih penyedia tersebut dan masukkan API key Anda.

Jika Anda memilih RajaOngkir atau Biteship, field API Key akan muncul. Masukkan key dari akun penyedia Anda. Konfigurasi tidak bisa disimpan jika field API key kosong saat penyedia pihak ketiga dipilih.

Pengaturan Pengiriman

Lokasi Asal Default

Atur lokasi asal (pengirim) default untuk kalkulasi ongkos kirim. Ini adalah kota atau area dari mana paket Anda dikirim.

Untuk mengatur lokasi asal:

1. Ketik nama kota atau area di field pencarian Default Origin Location (contoh: "Jakarta Selatan", "Bandung", "Surabaya").
2. Pilih lokasi yang benar dari saran dropdown.
3. Peta akan diperbarui menampilkan lokasi yang dipilih dengan pin marker.
4. Anda juga bisa mengklik langsung di peta untuk mengatur titik asal, atau gunakan tombol lokasi untuk menggunakan lokasi GPS Anda saat ini.

Lokasi asal menentukan titik "kirim dari" untuk semua kalkulasi tarif. Jika Anda memiliki beberapa gudang, masukkan yang utama di sini.

Berat Default

Masukkan berat paket default dalam gram. Nilai ini digunakan saat pelanggan tidak menyebutkan berat. Default-nya adalah 1000 gram (1 kg). Nilai minimum yang diterima adalah 100 gram.

Kurir yang Didukung

Pilih kurir mana yang akan disertakan saat mengecek tarif pengiriman. Kurir Indonesia berikut tersedia:

Kurir	Kode
JNE	jne
TIKI	tiki
POS Indonesia	pos
J&T Express	jnt
SiCepat	sicepat
AnterAja	anteraja
Ninja Express	ninja
Lion Parcel	lion
Wahana	wahana
SAP Express	sap
ID Express	ide

Centang atau hapus centang setiap kurir untuk mengontrol mana yang disertakan dalam pengecekan tarif. Minimal satu kurir harus dipilih. Secara default, JNE, J&T Express, dan SiCepat sudah aktif.

AI Prompts

Activation Prompt memberitahu AI kapan dan bagaimana menggunakan tool Cek Ongkir.

Tulis instruksi yang jelas yang mencakup:

• Frasa pemicu (contoh: "ongkir", "biaya kirim", "ongkos kirim", "berapa kirim ke")
• Bagaimana meminta informasi yang belum disebutkan (kota tujuan, berat paket)
• Bagaimana memformat hasil tarif pengiriman

Contoh prompt: "Saat pelanggan bertanya tentang ongkos kirim, biaya pengiriman, atau ongkir, gunakan tool ini untuk mengecek tarif. Tanyakan kota tujuan jika belum disebutkan. Tampilkan hasil dalam bentuk daftar yang menunjukkan nama kurir, jenis layanan, biaya, dan estimasi waktu pengiriman."

Cara Kerjanya

Berikut alur percakapan tipikal saat pelanggan bertanya tentang ongkos kirim:

Pelanggan: "Berapa ongkir ke Surabaya?"

Agent: Memanggil tool Cek Ongkir dengan asal dari konfigurasi, tujuan: Surabaya, berat: 1000g

Agent: "Berikut opsi pengiriman ke Surabaya:

• JNE REG: Rp 18.000 (2-3 hari)
• J&T Express: Rp 16.000 (2-3 hari)
• SiCepat Regular: Rp 15.500 (2-3 hari)

Apakah Anda ingin tahu tentang opsi pengiriman ekspres juga?"

Agent secara otomatis menggunakan lokasi asal yang dikonfigurasi dan berat default, serta hanya mengquery kurir yang Anda aktifkan.

Menguji Integrasi

Setelah menyimpan konfigurasi, uji pengecekan ongkir menggunakan widget simulasi chat.

1. Di halaman konfigurasi tool, temukan widget simulasi chat di sisi kanan (desktop).

2. Aktifkan Mode Debug dengan menggeser toggle Debug ke On.

3. Kirim pesan pengujian tentang ongkos kirim:

   • "Berapa ongkir ke Bandung?"
   • "Cek ongkir ke Yogyakarta"
   • "Cek ongkir ke Makassar 2 kg"

4. Dengan Mode Debug aktif, periksa:

   • Tool dipanggil pada saat yang diharapkan
   • Parameter asal, tujuan, dan berat yang dikirim sudah benar
   • Tarif kurir berhasil dikembalikan
   • Agent memformat hasilnya dengan jelas

5. Uji kasus khusus:

   • Tanyakan ongkir tanpa menyebutkan berat (seharusnya menggunakan berat default)
   • Tanyakan kota yang jarang atau nama kota yang salah eja
   • Tanyakan ongkir tanpa menyebutkan tujuan (Agent seharusnya menanyakannya)

Untuk panduan pengujian lengkap, lihat Pengujian AI Agent.

Pemecahan Masalah

"API Key is required for [nama penyedia]"

Error ini muncul saat Anda memilih RajaOngkir atau Biteship tetapi field API key kosong. Masukkan API key yang valid dari akun penyedia Anda, atau ganti ke penyedia Default ChatMo.

"Please select at least one courier"

Minimal satu kurir harus dipilih di bagian Kurir yang Didukung. Centang kotak di samping minimal satu kurir.

Tarif pengiriman kosong atau menampilkan error

• Pastikan lokasi asal diatur dengan benar dan sesuai dengan kota di Indonesia yang valid.
• Cek apakah kurir yang dipilih didukung oleh penyedia API yang Anda pilih.
• Jika menggunakan API pihak ketiga, pastikan API key Anda valid dan belum kedaluwarsa.
• Pastikan nama kota tujuan yang disebutkan dalam percakapan bisa dikenali.

Agent tidak memicu pengecekan ongkir

Tinjau Activation Prompt untuk memastikan sudah mencakup kata pemicu yang relevan. Pastikan juga konfigurasi tool sudah disimpan dan tool sudah diaktifkan di daftar Tools & Integrations Agent.

Tarif berbeda dari yang terlihat di website kurir

Tarif pengiriman dari API mungkin sedikit berbeda dari website kurir karena caching, interval update API, atau pembulatan berat. API menyediakan tarif programatik paling akurat yang tersedia pada saat permintaan dilakukan.

Selanjutnya

• Ecommerce & Order — Aktifkan alur ecommerce lengkap dengan katalog produk, pesanan, dan pembayaran.
• Web Search — Berikan kemampuan pencarian web kepada Agent Anda untuk informasi real-time.
• Pengujian AI Agent — Panduan lengkap penggunaan playground pengujian dan mode debug.
• Konfigurasi Tools — Ringkasan semua tools dan opsi integrasi.