Vai al contenuto
WbizTool

Invia promemoria WhatsApp ricorrenti con l'API

Invia lo stesso messaggio WhatsApp secondo una pianificazione – l'affitto mensile, l'orario settimanale, un check-in giornaliero – dal tuo numero. Crea il promemoria una volta con un'espressione cron e un fuso orario, e WbizTool mette in coda il messaggio ogni volta che corrisponde. I promemoria fanno parte di ogni piano a pagamento, da $25 al mese negli USA (il tuo prezzo è nella pagina Prezzi).

Inizia gratis

I promemoria richiedono un piano a pagamento: da $25 al mese negli USA.

Come funziona

  1. Ottieni la chiave API e collega il tuo numero

    Collega il tuo numero WhatsApp nella pagina Numeri WhatsApp con un codice QR o un codice di abbinamento, e crea una chiave in Impostazioni → Chiavi API. I promemoria richiedono un piano a pagamento (Lite, Standard, Advanced o Enterprise).

  2. Scegli la pianificazione

    Scrivila come espressione cron a cinque campi: 0 10 1 * * sono le 10:00 del 1° di ogni mese, 0 9 * * 1-5 le 9:00 nei giorni feriali. Aggiungi un fuso orario IANA come Asia/Kolkata.

  3. Crea il promemoria

    Fai una POST a /api/v1/reminder/create/ con reminder_name, phone, message, cron_expression e timezone. Salva il reminder_id della risposta.

  4. Elencalo o annullalo in seguito

    /api/v1/reminder/list/ restituisce i tuoi promemoria, 50 per pagina. /api/v1/reminder/cancel/ con il reminder_id ne ferma uno definitivamente – ad esempio quando il cliente paga.

Esempi di codice API Promemoria

Crea un promemoria mensile
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"
  }'
Crea un promemoria in 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"])
Un promemoria settimanale con immagine
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)
Elenca i tuoi promemoria
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
  }'
Annulla un promemoria
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"
  }'

Cosa puoi fare

  • Qualsiasi pianificazione esprimibile con cron

    Ogni giorno alle 9:00 (0 9 * * *), ogni lunedì (0 9 * * 1), due volte al giorno (0 9,18 * * *), il 15 di ogni mese (0 10 15 * *) o ogni 6 ore (0 */6 * * *).

  • Date compilate per te

    Variabili come {current_date_formatted}, {current_time_12h} e {reminder_name} vengono sostituite a ogni esecuzione del promemoria, nel suo fuso orario.

  • Immagini e file

    msg_type 1 invia un'immagine da img_url. Per un file, usa msg_type 2 con l'URL pubblico del file in img_url e il suo nome in file_name.

  • Visibili nella dashboard

    I promemoria creati tramite API compaiono anche nella pagina Promemoria, dove puoi metterli in pausa o modificarli. Quella pagina può anche importare molti promemoria da un foglio CSV o Excel.

  • Invia dal numero che scegli

    Imposta whatsapp_client per scegliere il numero. Se lo ometti, ogni esecuzione usa un numero collegato in quel momento.

Buono a sapersi

  • I promemoria richiedono un piano a pagamento. Con la prova gratuita l'API risponde Upgrade your plan to use reminders feature.
  • Usa nomi di fuso orario IANA come Asia/Kolkata o America/Chicago. Sigle come IST o CST vengono rifiutate con Invalid timezone; senza fuso orario, la pianificazione segue l'UTC.
  • phone vuole il numero con il prefisso internazionale, come 393471234567 – questo endpoint non ha un campo country_code.
  • Nell'API non c'è una chiamata per modificare o mettere in pausa. Per cambiare una pianificazione, annulla il promemoria e creane uno nuovo; per metterlo in pausa, usa la pagina Promemoria.
  • I promemoria vengono controllati periodicamente, non al secondo, quindi un'esecuzione può partire fino a 10 minuti dopo il suo orario; se un controllo arriva più tardi, l'esecuzione viene saltata. Ogni esecuzione conta nei 1.000 messaggi al giorno del numero.
  • In Elenca promemoria, next_run viene calcolato come se il fuso orario del promemoria fosse UTC. Controlla la pagina Promemoria per il prossimo orario corretto.
  • Se un campo di testo come phone, message o reminder_name viene inviato come numero, true o null, la risposta è una pagina di errore HTML (HTTP 500), quindi invia i valori di testo come stringhe e gestisci un body che non sia JSON, come fa l'esempio Python.
  • Se il numero whatsapp_client è disconnesso quando crei il promemoria, l'API lo rifiuta con WhatsApp Logged Out. Please Reconnect!!
  • I messaggi partono dal tuo numero WhatsApp, quindi valgono le regole di WhatsApp: scrivi a persone che si aspettano di sentirti.

Domande

Che differenza c'è tra un promemoria e un messaggio pianificato?
Un messaggio pianificato (/api/v1/schedule_msg/) parte una volta, alla data e all'ora che indichi. Un promemoria si ripete secondo la sua pianificazione cron finché non lo annulli.
Come fermo un promemoria quando il cliente paga?
Chiama /api/v1/reminder/cancel/ con il suo reminder_id. Si ferma subito e non verrà più eseguito. Un messaggio che aveva già messo in coda prima dell'annullamento potrebbe comunque partire.
Posso mettere in pausa o modificare un promemoria tramite API?
Non ancora. Mettilo in pausa o modificalo nella pagina Promemoria della dashboard, oppure annullalo e creane uno nuovo con la nuova pianificazione.
Un promemoria può inviare un PDF?
Sì. Usa msg_type 2, metti l'URL pubblico del file in img_url e il suo nome con l'estensione (come invoice.pdf) in file_name. Il file viene scaricato a ogni esecuzione del promemoria, quindi mantieni il link funzionante.
Quali piani includono i promemoria?
Tutti i piani a pagamento: Lite (1 numero), Standard (3 numeri) e Advanced (10 numeri) – $25, $59 e $149 al mese negli USA; la pagina Prezzi mostra il prezzo del tuo Paese. Tutti inviano messaggi illimitati con uso corretto. La prova gratuita non include i promemoria.

Leggi le guide

Pagine correlate

Invia oggi il tuo primo messaggio WhatsApp automatizzato

Crea un account, scansiona il codice QR e invia un messaggio in meno di cinque minuti.

Inizia gratis

I piani a pagamento partono da $25 al mese negli USA. Prezzi