İçeriğe geç
WbizTool

API ile tekrarlayan WhatsApp hatırlatmaları gönderin

Aynı WhatsApp mesajını bir zamanlamayla – aylık kira, haftalık ders programı, günlük kontrol mesajı – kendi numaranızdan gönderin. Hatırlatıcıyı bir cron ifadesi ve saat dilimiyle bir kez oluşturun; WbizTool zamanlama her eşleştiğinde mesajı sıraya alır. Hatırlatıcılar ABD’de aylık $25’dan başlayan tüm ücretli planlara dahildir (sizin fiyatınız Fiyatlar sayfasındadır).

Hatırlatıcılar ücretli plan gerektirir: ABD’de aylık $25’dan başlar.

Nasıl çalışır

  1. API anahtarınızı alın ve numaranızı bağlayın

    WhatsApp numaranızı WhatsApp numaraları sayfasında bir QR kod veya eşleştirme koduyla bağlayın ve Ayarlar → API anahtarları sayfasında bir anahtar oluşturun. Hatırlatıcılar ücretli plan gerektirir (Lite, Standard, Advanced veya Enterprise).

  2. Zamanlamayı seçin

    Zamanlamayı beş alanlı bir cron ifadesi olarak yazın: 0 10 1 * * her ayın 1’inde saat 10:00, 0 9 * * 1-5 hafta içi her gün saat 09:00 demektir. Asia/Kolkata gibi bir IANA saat dilimi ekleyin.

  3. Hatırlatıcıyı oluşturun

    reminder_name, phone, message, cron_expression ve timezone ile /api/v1/reminder/create/ adresine POST gönderin. Yanıttaki reminder_id değerini saklayın.

  4. Daha sonra listeleyin veya iptal edin

    /api/v1/reminder/list/ hatırlatıcılarınızı sayfa başına 50 tane olmak üzere döndürür. reminder_id ile /api/v1/reminder/cancel/ bir hatırlatıcıyı kalıcı olarak durdurur – örneğin müşteri ödediğinde.

Hatırlatıcı API’si kod örnekleri

Aylık bir hatırlatıcı oluşturun
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"
  }'
Python’da hatırlatıcı oluşturun
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"])
Haftalık görselli bir hatırlatıcı
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)
Hatırlatıcılarınızı listeleyin
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
  }'
Bir hatırlatıcıyı iptal edin
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"
  }'

Neler yapabilirsiniz

  • Cron’un ifade edebildiği her zamanlama

    Her gün saat 09:00 (0 9 * * *), her pazartesi (0 9 * * 1), günde iki kez (0 9,18 * * *), her ayın 15’i (0 10 15 * *) veya 6 saatte bir (0 */6 * * *).

  • Sizin için doldurulan tarihler

    {current_date_formatted}, {current_time_12h} ve {reminder_name} gibi şablon değişkenleri, hatırlatıcı her çalıştığında kendi saat diliminde yerine konur.

  • Görseller ve dosyalar

    msg_type 1, img_url adresindeki bir görseli gönderir. Dosya için msg_type 2 kullanın; dosyanın herkese açık URL’sini img_url alanına, adını file_name alanına yazın.

  • Panelinizde görünür

    API ile oluşturulan hatırlatıcılar Hatırlatıcılar sayfasında da görünür; orada onları duraklatabilir veya düzenleyebilirsiniz. Bu sayfa bir CSV veya Excel tablosundan çok sayıda hatırlatıcıyı içe de aktarabilir.

  • Seçtiğiniz numaradan gönderir

    Numarayı seçmek için whatsapp_client ayarlayın. Boş bırakırsanız her çalışma, o anda bağlı olan bir numarayı kullanır.

Bilmeniz gerekenler

  • Hatırlatıcılar ücretli plan gerektirir. Ücretsiz denemede API Upgrade your plan to use reminders feature yanıtını verir.
  • Asia/Kolkata veya America/Chicago gibi IANA saat dilimi adları kullanın. IST veya CST gibi kısaltmalar Invalid timezone ile reddedilir; saat dilimi verilmezse zamanlama UTC’ye göre çalışır.
  • phone, numarayı 919876543210 gibi ülke koduyla alır – bu endpoint’te country_code alanı yoktur.
  • API’de güncelleme veya duraklatma çağrısı yoktur. Zamanlamayı değiştirmek için hatırlatıcıyı iptal edip yenisini oluşturun; duraklatmak için Hatırlatıcılar sayfasını kullanın.
  • Hatırlatıcılar saniyesi saniyesine değil, belirli aralıklarla kontrol edilir; bu yüzden bir çalışma zamanından en fazla 10 dakika sonra gidebilir, kontrol bundan daha geç kalırsa o çalışma atlanır. Her çalışma, numaranın günlük 1.000 mesajından sayılır.
  • List reminders yanıtında next_run, hatırlatıcının saat dilimi UTC’ymiş gibi hesaplanır. Doğru sonraki zaman için Hatırlatıcılar sayfasına bakın.
  • phone, message veya reminder_name gibi bir metin alanı sayı, true veya null olarak gönderilirse yanıt bir HTML hata sayfası (HTTP 500) olur; bu yüzden metin değerlerini dize olarak gönderin ve Python örneğindeki gibi JSON olmayan bir gövdeyi ele alın.
  • Hatırlatıcıyı oluşturduğunuzda whatsapp_client numarasının oturumu kapalıysa API isteği WhatsApp Logged Out. Please Reconnect!! ile reddeder.
  • Mesajlar kendi WhatsApp numaranızdan gider, bu yüzden WhatsApp’ın kuralları geçerlidir: sizden haber bekleyen kişilere yazın.

Sık sorulan sorular

Hatırlatıcı ile zamanlanmış mesaj arasındaki fark nedir?
Zamanlanmış bir mesaj (/api/v1/schedule_msg/) verdiğiniz tarih ve saatte bir kez gider. Hatırlatıcı ise siz iptal edene kadar cron zamanlamasına göre tekrarlanır.
Müşteri ödediğinde hatırlatıcıyı nasıl durdururum?
reminder_id ile /api/v1/reminder/cancel/ çağırın. Hatırlatıcı hemen durur ve bir daha çalışmaz. İptal etmeden önce sıraya almış olduğu bir mesaj yine de gönderilebilir.
API ile bir hatırlatıcıyı duraklatabilir veya düzenleyebilir miyim?
Henüz değil. Panelinizdeki Hatırlatıcılar sayfasında duraklatın veya düzenleyin ya da iptal edip yeni zamanlamayla yenisini oluşturun.
Hatırlatıcı PDF gönderebilir mi?
Evet. msg_type 2 kullanın; dosyanın herkese açık URL’sini img_url alanına, uzantılı adını (örneğin invoice.pdf) file_name alanına yazın. Dosya hatırlatıcı her çalıştığında indirilir, bu yüzden bağlantıyı çalışır tutun.
Hangi planlarda hatırlatıcı var?
Tüm ücretli planlarda: Lite (1 numara), Standard (3 numara) ve Advanced (10 numara) – ABD’de aylık $25, $59 ve $149; Fiyatlar sayfası ülkenizin fiyatını gösterir. Hepsi adil kullanım kapsamında sınırsız mesaj gönderir. Ücretsiz deneme hatırlatıcıları içermez.

Kılavuzları okuyun

İlgili sayfalar

İlk otomatik WhatsApp mesajınızı bugün gönderin

Bir hesap oluşturun, QR kodu okutun ve beş dakikadan kısa sürede mesaj gönderin.

Ücretsiz başlayın

Ücretli planlar ABD’de aylık $25’dan başlar. Fiyatlar