Langsung ke konten
WbizTool

Kirim pengingat WhatsApp berulang dengan API

Kirim pesan WhatsApp yang sama sesuai jadwal – sewa bulanan, jadwal pelajaran mingguan, check-in harian – dari nomor Anda sendiri. Buat pengingat sekali dengan ekspresi cron dan timezone, dan WbizTool memasukkan pesan ke antrean setiap kali jadwalnya cocok. Pengingat termasuk di setiap paket berbayar, mulai $25 per bulan di AS (harga Anda ada di halaman Harga).

Pengingat memerlukan paket berbayar: mulai $25 per bulan di AS.

Cara kerjanya

  1. Dapatkan kunci API dan tautkan nomor Anda

    Tautkan nomor WhatsApp Anda di halaman Nomor WhatsApp dengan kode QR atau kode penautan, dan buat kunci di Pengaturan → Kunci API. Pengingat memerlukan paket berbayar (Lite, Standard, Advanced, atau Enterprise).

  2. Pilih jadwalnya

    Tulis sebagai ekspresi cron lima field: 0 10 1 * * adalah pukul 10.00 setiap tanggal 1, 0 9 * * 1-5 adalah pukul 9.00 di hari kerja. Tambahkan timezone IANA seperti Asia/Kolkata.

  3. Buat pengingatnya

    POST ke /api/v1/reminder/create/ dengan reminder_name, phone, message, cron_expression, dan timezone. Simpan reminder_id dari balasannya.

  4. Tampilkan atau batalkan nanti

    /api/v1/reminder/list/ mengembalikan pengingat Anda, 50 per halaman. /api/v1/reminder/cancel/ dengan reminder_id menghentikan pengingat untuk selamanya – misalnya saat pelanggan membayar.

Contoh kode API Pengingat

Buat pengingat bulanan
curl -X POST https://wbiztool.com/api/v1/reminder/create/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "reminder_name": "Monthly rent reminder",
    "phone": "919876543210",
    "message": "Hi Aman, a reminder that your rent is due on {current_date_formatted}.",
    "cron_expression": "0 10 1 * *",
    "timezone": "Asia/Kolkata"
  }'
Buat pengingat di Python
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/reminder/create/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "reminder_name": "Monthly rent reminder",
        "phone": "919876543210",
        "message": "Hi Aman, a reminder that your rent is due on {current_date_formatted}.",
        "cron_expression": "0 10 1 * *",
        "timezone": "Asia/Kolkata",
    },
    timeout=60,
)

try:
    result = response.json()  # read the body even when the HTTP code is 400
except ValueError:
    raise SystemExit(f"HTTP {response.status_code}: not JSON. Send every text value as a string.")

if result["status"] == 1:
    print("Reminder created with reminder_id", result["reminder_id"])
else:
    print("Failed:", result["message"])
Pengingat gambar mingguan
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/reminder/create/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "reminder_name": "Weekly class timetable",
        "phone": "919876543210",
        "msg_type": 1,
        "img_url": "https://example.com/timetable.png",
        "message": "Here is this week's timetable.",
        "cron_expression": "0 8 * * 1",
        "timezone": "Asia/Kolkata",
    },
    timeout=60,
)
print(response.status_code, response.text)
Tampilkan daftar pengingat Anda
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
  }'
Batalkan pengingat
curl -X POST https://wbiztool.com/api/v1/reminder/cancel/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "reminder_id": "3187"
  }'

Yang bisa Anda lakukan

  • Jadwal apa pun yang bisa ditulis dengan cron

    Setiap hari pukul 9.00 (0 9 * * *), setiap Senin (0 9 * * 1), dua kali sehari (0 9,18 * * *), tanggal 15 setiap bulan (0 10 15 * *), atau setiap 6 jam (0 */6 * * *).

  • Tanggal terisi otomatis

    Variabel template seperti {current_date_formatted}, {current_time_12h}, dan {reminder_name} diganti setiap kali pengingat berjalan, di timezone-nya sendiri.

  • Gambar dan file

    msg_type 1 mengirim gambar dari img_url. Untuk file, gunakan msg_type 2 dengan URL publik file di img_url dan namanya di file_name.

  • Terlihat di dashboard Anda

    Pengingat yang dibuat lewat API juga muncul di halaman Pengingat, tempat Anda bisa menjeda atau mengeditnya. Halaman itu juga bisa mengimpor banyak pengingat dari sheet CSV atau Excel.

  • Dikirim dari nomor pilihan Anda

    Atur whatsapp_client untuk memilih nomornya. Jika dikosongkan, setiap jadwal memakai nomor yang sedang terhubung saat itu.

Perlu diketahui

  • Pengingat memerlukan paket berbayar. Di uji coba gratis, API menjawab Upgrade your plan to use reminders feature.
  • Gunakan nama timezone IANA seperti Asia/Kolkata atau America/Chicago. Singkatan seperti IST atau CST ditolak dengan Invalid timezone; tanpa timezone, jadwal berjalan dalam UTC.
  • phone menerima nomor dengan kode negaranya, seperti 6281234567890 – tidak ada field country_code di endpoint ini.
  • Tidak ada panggilan update atau jeda di API. Untuk mengubah jadwal, batalkan pengingat dan buat yang baru; untuk menjeda, gunakan halaman Pengingat.
  • Pengingat diperiksa secara berkala, tidak tepat per detik, jadi sebuah jadwal bisa terkirim hingga 10 menit setelah waktunya; jika pengecekan lebih lambat dari itu, jadwal tersebut dilewati. Setiap pengiriman dihitung dalam 1.000 pesan per hari milik nomor itu.
  • Di List reminders, next_run dihitung seolah-olah timezone pengingat adalah UTC. Lihat halaman Pengingat untuk waktu berikutnya yang benar.
  • Jika field teks seperti phone, message, atau reminder_name dikirim sebagai angka, true, atau null, balasannya berupa halaman error HTML (HTTP 500), jadi kirim nilai teks sebagai string dan tangani body yang bukan JSON, seperti pada contoh Python.
  • Jika nomor whatsapp_client sedang logout saat Anda membuat pengingat, API menolaknya dengan WhatsApp Logged Out. Please Reconnect!!
  • Pesan dikirim dari nomor WhatsApp Anda sendiri, jadi aturan WhatsApp sendiri berlaku: kirim pesan ke orang yang menunggu kabar dari Anda.

Pertanyaan

Apa bedanya pengingat dan pesan terjadwal?
Pesan terjadwal (/api/v1/schedule_msg/) dikirim sekali, pada tanggal dan jam yang Anda berikan. Pengingat berulang sesuai jadwal cron-nya sampai Anda membatalkannya.
Bagaimana cara menghentikan pengingat saat pelanggan membayar?
Panggil /api/v1/reminder/cancel/ dengan reminder_id miliknya. Pengingat langsung berhenti dan tidak berjalan lagi. Pesan yang sudah masuk antrean sebelum Anda membatalkan mungkin tetap terkirim.
Bisakah saya menjeda atau mengedit pengingat lewat API?
Belum bisa. Jeda atau edit di halaman Pengingat di dashboard Anda, atau batalkan dan buat yang baru dengan jadwal baru.
Bisakah pengingat mengirim PDF?
Bisa. Gunakan msg_type 2, isi URL publik file di img_url dan namanya beserta ekstensi (seperti invoice.pdf) di file_name. File diunduh setiap kali pengingat berjalan, jadi pastikan tautannya tetap berfungsi.
Paket mana yang mencakup pengingat?
Setiap paket berbayar: Lite (1 nomor), Standard (3 nomor), dan Advanced (10 nomor) – $25, $59, dan $149 per bulan di AS; halaman Harga menampilkan harga untuk negara Anda. Semuanya mengirim pesan tanpa batas sesuai penggunaan wajar. Uji coba gratis tidak mencakup pengingat.

Baca panduannya

Terkait

Kirim pesan WhatsApp otomatis pertama Anda hari ini

Buat akun, scan kode QR, dan kirim pesan dalam waktu kurang dari lima menit.

Mulai gratis

Paket berbayar mulai $25 per bulan di AS. Harga