Langsung ke konten
Wbiztool

API Pengingat

API Daftar pengingat

Dapatkan pengingat di workspace Anda, 50 sekaligus, dari yang terbaru. Gunakan untuk menemukan ID pengingat, mengaudit otomatisasi Anda, atau membuat cadangannya.

POSThttps://wbiztool.com/api/v1/reminder/list/

Body: JSON atau field formulir

Endpoint ini hanya menerima POST. Request GET, bahkan dengan query string, mengembalikan HTTP 400 dengan Invalid JSON format: Expecting value….

Daftar mencakup pengingat aktif dan yang dijeda dari seluruh workspace, baik yang dibuat melalui API maupun di halaman Reminders (Pengingat). Pengingat yang dibatalkan tidak disertakan.

Contoh singkat#

curl -X POST https://wbiztool.com/api/v1/reminder/list/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "page": 1
  }'

Ganti 12345 dan YOUR_API_KEY dengan nilai Anda sendiri. Lihat Autentikasi untuk mengetahui di mana menemukannya.

Parameter request#

client_idintegerwajib

API Client ID Anda dari Settings → API keys (Pengaturan → Kunci API).

api_keystringwajib

API key Anda dari halaman yang sama.

pageintegeropsional

Nomor halaman, dimulai dari 1 (default). Setiap halaman berisi 50 pengingat, dan ukuran halaman tidak dapat diubah. Nilai yang bukan bilangan bulat 1 atau lebih diperlakukan sebagai 1.

Respons#

Request yang berhasil mengembalikan HTTP 200:

{
  "reminders": [
    {
      "id": 3187,
      "name": "Monthly rent reminder",
      "to_number": "919876543210",
      "message_template": "Hi Aman, a reminder that your rent is due on {current_date_formatted}.",
      "msg_type": 0,
      "msg_type_display": "Text",
      "img_url": "",
      "file_name": "",
      "cron_expression": "0 10 1 * *",
      "next_run": "2026-10-01 10:00:00 UTC",
      "is_active": true,
      "whatsapp_client_id": 678,
      "created_at": "2026-09-16 04:45:12"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 50,
  "message": "Success",
  "status": 1
}
FieldTipeDeskripsi
statusinteger1 jika berhasil, 0 jika request gagal.
messagestringSuccess, selain itu berisi error.
remindersarrayPengingat di halaman ini, dari yang terbaru. Kosong jika halaman melewati akhir daftar.
totalintegerJumlah pengingat di workspace, di semua halaman.
pageintegerHalaman yang dikembalikan.
page_sizeintegerSelalu 50.

Field pengingat#

FieldTipeDeskripsi
idintegerID pengingat. Gunakan dengan Batalkan pengingat.
namestringNama pengingat, atau Unnamed Reminder jika tidak memiliki nama.
to_numberstringNomor telepon atau nama grup tujuan pengingat.
message_templatestringPesannya, dengan variabel template yang belum diisi.
msg_typeinteger0 teks, 1 gambar, 2 file.
msg_type_displaystringText, Image, atau File.
img_urlstring atau nullURL gambar untuk pengingat gambar, atau URL file untuk pengingat file yang dibuat melalui API. Selain itu bisa kosong atau null.
file_namestring atau nullUntuk pengingat file: URL file (pengingat yang dibuat di dashboard) atau nama file (pengingat yang dibuat melalui API, yang URL-nya ada di img_url). Selain itu bisa kosong atau null.
cron_expressionstringJadwalnya. Lihat Ekspresi cron.
next_runstringWaktu berikutnya jadwal cocok, dalam format YYYY-MM-DD HH:MM:SS UTC, atau Invalid cron jika ekspresi tidak dapat dibaca. Lihat peringatan di bawah.
is_activebooleantrue jika pengingat berjalan, false jika dijeda.
whatsapp_client_idinteger atau nullNomor WhatsApp pengirimnya, atau null jika menggunakan nomor terhubung pertama.
created_atstringWaktu pengingat dibuat, dalam UTC, dengan format YYYY-MM-DD HH:MM:SS.

Error#

Error mengembalikan HTTP 400 dengan status bernilai 0, kecuali disebutkan lain:

{ "status": 0, "message": "Upgrade your plan to use reminders feature" }
PesanCara memperbaikinya
Invalid JSON format: …Body JSON tidak valid. Anda juga mendapatkan error ini untuk request GET atau request formulir tanpa client_id.
Auth Error - Please send correct API key and Client idKirim client_id dan api_key.
Invalid client idKirim client_id sebagai angka.
Auth Error: invalid api keyKey tersebut milik client_id lain.
Auth Error: please check client idKey tidak terhubung ke workspace. Buat key baru di workspace yang ingin Anda gunakan.
Demo Account cannot access APIsGunakan akun biasa.
Upgrade your plan to use reminders featurePaket Anda tidak mencakup pengingat. Upgrade paket Anda. Pengingat yang sudah ada tetap berjalan dan memakai kredit setelah downgrade, dan tidak dapat ditampilkan, dibatalkan, atau dijeda sampai Anda melakukan upgrade.
Error fetching reminders: … (HTTP 500)Terjadi masalah di sisi kami. Coba lagi.

Jika api_key tidak ada atau sudah dihapus, responsnya berupa halaman error HTML dengan HTTP 500, bukan JSON. Uji key Anda dengan Cek kredensial.

Membaca semua halaman#

Terus minta halaman berikutnya sampai sebuah halaman berisi kurang dari 50 pengingat.

Ambil semua pengingat
import requests

reminders, page = [], 1

while True:
    response = requests.post(
        "https://wbiztool.com/api/v1/reminder/list/",
        json={"client_id": 12345, "api_key": "YOUR_API_KEY", "page": page},
        timeout=60,
    )
    try:
        result = response.json()
    except ValueError:
        raise SystemExit(f"HTTP {response.status_code}: not JSON. Check that your api_key exists.")
    if result["status"] != 1:
        raise RuntimeError(result["message"])

    reminders += result["reminders"]
    if len(result["reminders"]) < result["page_size"]:
        break
    page += 1

print(len(reminders), "reminders")

Tips#

  • Simpan salinan Anda sendiri dari timezone setiap pengingat saat Anda membuatnya, karena endpoint ini tidak mengembalikannya.
  • Temukan pengingat yang dijeda dengan memfilter is_active yang bernilai false. Lanjutkan kembali di halaman Reminders.
  • Bersihkan otomatisasi lama: kumpulkan dulu semua ID yang ingin Anda batalkan dari setiap halaman, lalu panggil Batalkan pengingat untuk masing-masing. Membatalkan sambil membaca halaman menggeser pengingat berikutnya ke halaman sebelumnya, sehingga sebagian terlewat.