Vai al contenuto
WbizTool

Invia messaggi WhatsApp con cURL

Prova l'API WhatsApp di WbizTool dal terminale prima di scrivere codice. Ogni comando qui sotto è una POST a https://wbiztool.com/api/v1/, e il messaggio parte dal tuo numero, collegato come WhatsApp Web.

Inizia gratis

Prova gratuita: 50 messaggi in qualsiasi arco di 30 giorni, senza carta.

Come funziona

  1. Ottieni la chiave API e collega il tuo numero

    Registrati, poi collega il tuo numero WhatsApp nella pagina Numeri WhatsApp con un codice QR o un codice di abbinamento, come WhatsApp Web. In Impostazioni → Chiavi API, crea una chiave e copia il tuo Client ID (la guida Chiavi API qui sotto mostra dove). L'ID sulla scheda del numero (come ID 678) è il tuo whatsapp_client.

  2. Verifica le credenziali

    Invia con una POST il tuo client_id e la tua api_key a /api/v1/me/. "status": 1 con "message": "Okay" significa che funzionano. Non invia nulla e non usa messaggi.

  3. Invia un messaggio

    Fai una POST a /api/v1/send_msg/ con il numero di telefono e il testo. Una risposta con "status": 1 e un msg_id significa che il messaggio è in coda sul tuo numero.

  4. Controlla che sia partito

    Fai una POST a /api/v1/message/status/<msg_id>/. Lo stato 1 significa Inviato; lo stato 2 significa Fallito, con il motivo in error.

Esempi di codice cURL

Verifica le credenziali
curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'
Invia un testo
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, your order #4821 has shipped and will arrive on Thursday."
  }'
Risposta
{"status": 1, "message": "Created", "msg_id": 9817263}
Invia un'immagine da un URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts today 🎉"
  }'
Invia un PDF da un URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 2,
    "country_code": "91",
    "phone": "9876543210",
    "file_url": "https://example.com/invoices/invoice-4821.pdf",
    "file_name": "invoice-4821.pdf",
    "msg": "Your invoice for order #4821 is attached."
  }'
Carica un file dal tuo computer
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -F client_id=12345 \
  -F api_key=YOUR_API_KEY \
  -F whatsapp_client=678 \
  -F msg_type=2 \
  -F country_code=91 \
  -F phone=9876543210 \
  -F "msg=Your invoice for order #4821 is attached." \
  -F file_name=invoice-4821.pdf \
  -F file=@./invoice-4821.pdf
Pianifica un messaggio
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
    "date": "24/12/2026",
    "time": "09:00",
    "timezone": "Asia/Kolkata"
  }'
Controlla lo stato del messaggio
curl -X POST https://wbiztool.com/api/v1/message/status/9817263/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

Cosa puoi fare

  • JSON o campi di modulo

    Invia il body come JSON, come campi di modulo o come multipart form data (-F) quando carichi un file. Gli esempi funzionano così come sono, una volta inseriti i tuoi ID e la tua chiave.

  • Immagini e file

    msg_type 1 invia un'immagine da img_url, msg_type 2 un file da file_url. I file collegati possono arrivare a 100 MB, e il link deve essere pubblico.

  • Pianifica con un fuso orario

    schedule_msg accetta date (gg/mm/aaaa), time (HH:MM) e un nome di timezone come America/New_York o una sigla come IST o EST.

  • Webhook per ogni stato

    Aggiungi "webhook": "https://…" e WbizTool gli invia con una POST msg_id e SENT, FAILED, CANCELLED o EXPIRED quando il messaggio cambia stato.

  • Le stesse chiamate da qualsiasi strumento

    Make, Pabbly Connect e altri strumenti di automazione inviano queste stesse richieste con il loro modulo HTTP. Nella documentazione è disponibile anche una collection Postman.

Buono a sapersi

  • "status": 1 significa che il messaggio è in coda, non consegnato. Inviato è lo stato finale di successo; l'API non segnala se il messaggio è stato consegnato o letto.
  • Dentro il JSON, scrivi un a capo in msg come \n. Un a capo vero o una virgola finale rendono il JSON non valido.
  • Un orario pianificato nel passato viene accettato e inviato subito. La data va scritta con il giorno per primo (24/12/2026), quindi controllala prima di inviare.
  • Gli errori di Invia messaggio arrivano con HTTP 400 (429 al limite giornaliero); quelli di Pianifica messaggio arrivano di solito con HTTP 200 e "status": 0, quindi decodifica sempre il body e controlla status.
  • L'invio a un gruppo WhatsApp tramite API (group_name al posto di phone) funziona con ogni piano, compresa la prova gratuita.
  • La prova gratuita offre 50 messaggi in qualsiasi arco di 30 giorni e 1 numero, senza carta. I piani a pagamento partono da $25 al mese negli USA (il tuo prezzo è nella pagina Prezzi) e inviano messaggi illimitati con uso corretto: fino a 1.000 al giorno per numero.
  • I messaggi partono dal tuo numero WhatsApp, quindi valgono le regole di WhatsApp: scrivi a persone che si aspettano di sentirti.

Domande

Qual è l'endpoint dell'API WhatsApp per inviare un messaggio?
POST https://wbiztool.com/api/v1/send_msg/ con client_id, api_key, whatsapp_client, phone (più country_code se il numero non lo ha) e msg. La risposta contiene status e, in caso di successo, un msg_id.
Come pianifico un messaggio WhatsApp con cURL?
Fai una POST a https://wbiztool.com/api/v1/schedule_msg/ con gli stessi campi più date (gg/mm/aaaa), time (HH:MM) e timezone. Il msg_id della risposta ti permette di controllarlo o annullarlo in seguito.
Come faccio a sapere che il messaggio è stato inviato?
Una risposta con "status": 1 e un msg_id significa che è in coda. Passa un URL webhook per ricevere una POST con SENT, FAILED, CANCELLED o EXPIRED, oppure chiama l'endpoint Stato del messaggio con il msg_id. Inviato è lo stato finale: l'API non segnala se il messaggio è stato consegnato o letto.
In che formato devo inviare il numero di telefono?
Invia il numero con il prefisso internazionale (393471234567), oppure senza (3471234567) insieme a country_code (39). Spazi, +, trattini e parentesi vengono rimossi per te, quindi funziona anche +39 347-123 4567.
Mi servono la WhatsApp Business API o l'approvazione di Meta?
No. WbizTool invia dal tuo numero WhatsApp o WhatsApp Business, collegato come WhatsApp Web. Non serve l'approvazione di Meta e non ci sono template di messaggio da far approvare.
Si paga per ogni messaggio?
No. La prova gratuita include 50 messaggi in qualsiasi arco di 30 giorni. I piani a pagamento inviano messaggi illimitati con uso corretto, fino a 1.000 al giorno per numero: Lite $25, Standard $59 e Advanced $149 al mese negli USA; la pagina Prezzi mostra il prezzo del tuo Paese.

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