Skip to main content
Fitur Aksi Khusus (Custom Action) di Agent AI memungkinkan asisten Anda bertindak lebih dari sekadar menjawab teks. Agent AI dapat mengeksekusi panggilan web (API call) ke server atau sistem aplikasi Anda saat obrolan berlangsung—misalnya untuk mengecek status resi pengiriman, memeriksa ketersediaan kamar hotel, atau mengirimkan data prospek baru ke sistem CRM internal. Panduan ini memberikan tutorial langkah demi langkah beserta contoh nyata implementasi API call untuk pengecekan status pesanan.

Prasyarat

Endpoint REST API atau webhook Anda aktif dan dapat diakses publik melalui protokol https://.
Dokumentasi parameter URL, format header, dan format respon JSON dari API Anda sudah siap.
Akun Anda memiliki akses ke instance WhatsApp di portal DripSender.

1. Membuka Menu Alat dan Tombol Tambah Aksi

  1. Buka menu Agent AI di portal DripSender.
  2. Pada bilah navigasi atas, klik tab Tools.
  3. Di kartu bagian atas Aksi khusus, perhatikan tombol biru + Tambah aksi yang ditandai kotak merah:
Kartu Aksi Khusus dan Tombol Tambah Aksi pada Menu Alat
  1. Klik tombol + Tambah aksi untuk membuka jendela modal konfigurasi.

2. Mengisi Informasi Dasar Aksi (Nama, Deskripsi, dan Jenis)

Pada bagian atas formulir modal: Mengisi Informasi Dasar Nama Aksi Deskripsi dan Jenis
  1. Nama Aksi: Masukkan nama fungsi teknis yang singkat menggunakan huruf kecil dan garis bawah (contoh: cek_status_pesanan).
  2. Kapan Agen Memakai Aksi Ini (Prompt Pemicu): Jelaskan dalam kalimat bahasa Indonesia biasa mengenai situasi di mana aksi ini harus dipanggil: Contoh:
    “Pakai saat pelanggan menanyakan status pesanan, paket, atau nomor resi. Butuh nomor pesanan dari pelanggan.”
    Model AI membaca kalimat deskripsi ini saat memproses setiap chat masuk untuk mengevaluasi apakah maksud pelanggan membutuhkan pemanggilan aksi API ini.
  3. Jenis Aksi:
    • Ambil data (API): Agen mengambil informasi dari server Anda, lalu memproses data JSON yang didapat untuk dirangkum ke dalam balasan chat pelanggan.
    • Kirim data (webhook): Agen mengirimkan data dari chat pelanggan ke sistem eksternal (misalnya membuat pesanan baru atau menyimpan tiket komplain).

3. Menentukan Metode HTTP dan Alamat URL Endpoint

Pada bagian konfigurasi koneksi: Menentukan Metode HTTP dan Alamat URL Template
  1. Metode: Pilih metode HTTP yang sesuai: GET, POST, PUT, atau DELETE.
  2. Alamat (URL): Masukkan endpoint URL lengkap diawali https://. Anda dapat menyisipkan variabel dinamis menggunakan kurung kurawal ganda {{nama_isian}}:
Demi keamanan, alamat lokal atau IP jaringan pribadi (seperti localhost atau 192.168.x.x) otomatis diblokir oleh sistem DripSender.

4. Menentukan Isian Parameter yang Dikumpulkan dan Menyimpan Aksi

Pada bagian bawah formulir modal: Menentukan Isian yang Dikumpulkan Agen dan Tombol Simpan
  1. Header (Opsional): Klik + Tambah header jika API Anda membutuhkan autentikasi kunci API (API Key) atau Bearer token (misal Authorization: Bearer rahasia_token_api_anda).
  2. Isian yang Dikumpulkan Agen (Input Parameters): Klik + Tambah isian untuk menentukan data apa saja yang wajib ditanyakan atau diambil oleh Agent AI dari pesan pelanggan sebelum memanggil API:
    • Nama Isian: Harus sama persis dengan placeholder URL (contoh: order_id).
    • Tipe Data: Pilih tipe data (string, number, dll).
    • Deskripsi untuk Agen: “Nomor pesanan yang diberikan oleh pembeli (misal ORD-12345)”.
    • Jika pelanggan belum menyebutkan nomor pesanan dalam obrolan, Agent AI akan secara otomatis menanyakannya terlebih dahulu kepada pelanggan sebelum memicu pemanggilan API.
  3. Aktifkan Aksi: Pastikan kotak centang Aktifkan aksi ini telah tercentang.
  4. Klik tombol biru Simpan di sudut kanan bawah modal.

5. Pengujian Eksekusi Aksi di Playground

  1. Buka tab Uji Coba (Playground).
  2. Tulis pesan simulasi sebagai pembeli: “Halo, tolong cek status pesanan saya dengan nomor order ORD-9921”.
  3. Agent AI akan otomatis mendeteksi kebutuhan aksi, mengekstrak nomor ORD-9921, memanggil API Anda, dan merangkum hasil respon JSON ke dalam pesan balasan yang rapi dan mudah dibaca.