Menu dokumentasi

Pengingat Tagihan

Menagih ulang pelanggan yang belum membayar tanpa salah kirim ke yang sudah lunas.

MCP Server bisa menyiapkan pesan pengingat untuk tagihan yang belum dibayar. Halaman ini menjelaskan siapa menyimpan apa, seberapa sering pelanggan diingatkan, dan cara mencegah pengingat terkirim ke pelanggan yang baru saja membayar.

Server tidak menyimpan apa pun

Aulaa MCP Server tidak punya database. Ia tidak mencatat tagihan apa saja yang pernah dibuat, dan tidak mengirim pesan atau berjalan terjadwal sendiri.

Yang dikerjakan Oleh
Menyimpan daftar tagihan (tracking) Chatbot (memori percakapan) atau sistem Anda (database, CRM, spreadsheet)
Menentukan seberapa sering pelanggan diingatkan Anda, lewat remind_every_minutes
Menentukan kapan pengecekan dijalankan Anda, mis. job tiap 15 menit atau saat admin bertanya
Mengecek status terkini ke Aulaa dan menyusun teks pengingat MCP Server
Mengirim pesan ke pelanggan Chatbot Anda, mis. lewat WhatsApp

Alurnya

1. Simpan tracking setiap membuat tagihan

create_payment_link mengembalikan tracking. Simpan apa adanya:

{
  "payment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "order_id": "INV-20261117-ANDI",
  "customer_name": "Andi",
  "description": "DP katering 50 porsi"
}

Simpan juga kontak pelanggan (nomor WhatsApp, ID chat) di sistem Anda. MCP Server tidak membutuhkannya dan tidak pernah menerimanya.

2. Cek tagihan yang belum dibayar

Panggil list_unpaid_bills dengan catatan yang Anda simpan (maks. 50 per panggilan) dan preferensi Anda:

{
  "bills": [
    {
      "payment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "customer_name": "Andi",
      "description": "DP katering 50 porsi",
      "last_reminded_at": "2026-11-18T02:00:00Z"
    }
  ],
  "remind_every_minutes": 180,
  "send_within_minutes": 5
}

3. Kirim pengingat segera

Setiap item di to_remind membawa reminder_message. Kirim ke pelanggannya sebelum send_before. Contoh pesan:

Halo Andi,

Kami ingin mengingatkan, tagihan untuk DP katering 50 porsi sebesar Rp150.000 (No. pesanan: INV-20261117-ANDI) belum kami terima.

Silakan bayar lewat link berikut (bisa QRIS, Virtual Account, e-wallet, atau minimarket):
https://payment.aulaa.co/pay/f47ac10b-58cc-4372-a567-0e02b2c3d479

Link berlaku sampai 18 November 2026 pukul 15.00 WIB (sekitar 5 jam lagi).

Terima kasih 🙏

4. Perbarui catatan

  • Setelah pengingat terkirim, ganti catatan tagihan itu dengan tracking_after_send. Isinya sudah memuat last_reminded_at.
  • Hapus setiap payment_id di stop_tracking. Tagihan itu sudah lunas, kedaluwarsa, dibatalkan, atau tidak ditemukan.
  • Untuk tagihan di expired, buat tagihan baru dengan order_id baru bila pelanggan masih berutang.

Seberapa sering mengingatkan

Itu pilihan Anda, bukan pengaturan server. Isi remind_every_minutes di setiap panggilan:

remind_every_minutes Artinya
kosong Semua tagihan yang belum dibayar dianggap perlu diingatkan sekarang.
60 Paling sering sejam sekali per tagihan.
180 Paling sering 3 jam sekali per tagihan.
1440 Paling sering sehari sekali per tagihan.

Jarak dihitung dari last_reminded_at. Tagihan yang belum pernah diingatkan dihitung dari waktu tagihan dibuat, jadi dengan 180 pengingat pertama baru muncul 3 jam setelah tagihan dibuat.

Tagihan yang baru saja diingatkan masuk not_due_yet lengkap dengan next_reminder_at. next_check_at memberi tahu kapan pengecekan berikutnya berguna.

Mencegah pengingat ke pelanggan yang baru membayar

Status hanya benar pada saat dicek. Kalau pelanggan membayar di antara pengecekan dan pengiriman, pengingat yang terlambat akan salah kirim. Karena itu:

  • Kirim reminder_message sebelum send_before. Bawaannya 5 menit setelah pengecekan. Jangan menyimpan teks pengingat untuk dikirim nanti.
  • Bila mengirim satu per satu, atau send_before sudah lewat, panggil get_reminder untuk tagihan itu tepat sebelum mengirim, dan kirim hanya bila hasilnya send: true.
{ "send": false, "reason": "sudah dibayar (18 November 2026 pukul 10.12 WIB)", "stop_tracking": true }

Pesan pengingat sengaja tidak memuat kalimat "abaikan bila sudah membayar", karena teksnya hanya dibuat setelah status dicek langsung ke Aulaa.

Contoh: job pengingat otomatis

Contoh sederhana untuk bot yang mengirim lewat WhatsApp. db dan kirimWhatsApp adalah fungsi milik sistem Anda.

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

async function jalankanPengingat() {
  const client = new Client({ name: "pengingat-toko", version: "1.0.0" });
  await client.connect(
    new StreamableHTTPClientTransport(new URL("https://mcp.aulaa.co/mcp"), {
      requestInit: { headers: { Authorization: `Bearer ${process.env.AULAA_API_KEY}` } },
    }),
  );

  const tagihan = await db.ambilTagihanDilacak(50); // catatan tracking yang disimpan
  if (tagihan.length === 0) return client.close();

  const hasil = await client.callTool({
    name: "list_unpaid_bills",
    arguments: { bills: tagihan, remind_every_minutes: 180 },
  });
  const r = hasil.structuredContent as any;

  for (const item of r.to_remind) {
    await kirimWhatsApp(await db.nomorPelanggan(item.id), item.reminder_message);
    await db.simpanTracking(item.tracking_after_send); // ganti catatan lama
  }
  for (const id of r.stop_tracking) await db.hapusTracking(id);

  await client.close();
}

// Jalankan tiap 15 menit. Pengingat tetap paling sering 3 jam sekali per tagihan.
setInterval(jalankanPengingat, 15 * 60 * 1000);

Bila pesan dikirim lewat antrean dan bisa tertunda lebih dari beberapa menit, panggil get_reminder tepat sebelum setiap pesan keluar dari antrean.

Dengan chatbot biasa (tanpa kode)

Di Claude, Cursor, atau klien lain, cukup minta dengan kalimat biasa, misalnya "Cek tagihan yang belum dibayar dari daftar tadi, ingatkan paling sering 3 jam sekali." Chatbot memakai catatan tracking di percakapan itu.

Memori chatbot hilang saat percakapan baru dimulai. Untuk penagihan rutin, simpan tracking di sistem Anda sendiri.

Terakhir diperbarui 17 November 2026