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 memuatlast_reminded_at. - Hapus setiap
payment_iddistop_tracking. Tagihan itu sudah lunas, kedaluwarsa, dibatalkan, atau tidak ditemukan. - Untuk tagihan di
expired, buat tagihan baru denganorder_idbaru 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_messagesebelumsend_before. Bawaannya 5 menit setelah pengecekan. Jangan menyimpan teks pengingat untuk dikirim nanti. - Bila mengirim satu per satu, atau
send_beforesudah lewat, panggil get_reminder untuk tagihan itu tepat sebelum mengirim, dan kirim hanya bila hasilnyasend: 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
trackingdi sistem Anda sendiri.
Terakhir diperbarui 17 November 2026