In questo tutorial imparerai come programmare l'invio di messaggi usando l'API.
Ci sono due modi per programmare la consegna di un messaggio a un momento e/o giorno successivo: specificando il giorno e l'orario esatti in cui vuoi che venga inviato oppure indicando dopo quanti minuti, ore o giorni desideri posticiparne la consegna.
Se vuoi inviare messaggi da codice, puoi usare qualsiasi linguaggio di programmazione per effettuare richieste HTTPS all'API. Di seguito c'è il tester API live con esempi di codice pronti all'uso in vari linguaggi di programmazione.
Requisiti
- Avere un numero WhatsApp già collegato alla piattaforma e online.
- Numero di telefono del destinatario con prefisso internazionale in formato E164. Esempio:
+393517224449. Puoi convalidare il numero di telefono qui.
Endpoint API
In questo tutorial useremo il seguente endpoint API:
Preparare la richiesta
URL target dell'API (POST)
https://api.wassenger.com/v1/messages
Header HTTPS richiesti
Content-Type: application/json
Token: ENTER API KEY HERE
Inviare un messaggio a una data specifica in formato ISO8601
Esempio di corpo della richiesta in formato JSON
# Examples requires to have installed requests Python package. # Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = { "phone": "+12345678909", "message": "This is a scheduled message to be sent to a phone number in 10 minutes", "deliverAt": "2025-01-07T11:50:41.608Z" } headers = { "Content-Type": "application/json", "Token": "API KEY GOES HERE" }
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Puoi anche inviare messaggi programmati a una chat di gruppo:
# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = {
"group": "${group_ID@g.us}",
"message": "This is a scheduled message to be sent tomorrow to a group chat.Date format is based on ISO 8601 format with default UTC time zone",
"deliverAt": "2025-01-08T11:40:41.608Z"
}
headers = {
"Content-Type": "application/json",
"Token": "API KEY GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Rimandare la consegna del messaggio di minuti, ore o giorni
Esempio di corpo della richiesta in formato JSON
Esempi di valori validi sarebbero: 1m = tra 1 minuto, 2h = tra 2 ore, 15d = tra 15 giorni.
I valori devono essere numeri interi, quindi se hai bisogno di programmare un messaggio per 1,5 ore, per esempio, devi specificare 90m = in 90 minuti
# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = {
"group": "${group_ID@g.us}",
"message": "This is a scheduled message to be sent tomorrow to a group chat.Date format is based on ISO 8601 format with default UTC time zone",
"schedule": { "delayTo": "1h" }
}
headers = {
"Content-Type": "application/json",
"Token": "API KEY GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
In alternativa, puoi ritardare la consegna del messaggio di un dato numero di secondi:
# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/messages"
payload = {
"group": "${group_ID@g.us}",
"message": "This is a scheduled message to be sent tomorrow to a group chat.Date format is based on ISO 8601 format with default UTC time zone",
"schedule": { "delayTo": "180" }
}
headers = {
"Content-Type": "application/json",
"Token": "API KEY GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Tester API live
Ora puoi giocare, fare debug e testare l'API in tempo reale direttamente dal tuo browser, esplorare e provare altri esempi di API e ottenere con un clic snippet di codice pronti all'uso disponibili in oltre 15 linguaggi di programmazione 😎
Prova il tester API live di Wassenger
Hai domande? Consulta le domande frequenti qui sotto.
Domande frequenti
Come inviare messaggi a più numeri di telefono
Devi semplicemente inviare più richieste API, una per ogni numero di telefono destinatario.
Ad esempio, se vuoi inviare un messaggio a 10 numeri di telefono, dovresti inviare 10 richieste HTTPS indipendenti all'API.
Non esiste un'opzione per inviare più messaggi in un'unica richiesta API.
Che tipo di messaggi si possono inviare?
Puoi inviare diversi tipi di messaggi, inclusi testo, immagini, video, emoji, audio, gif, posizioni geografiche e documenti tramite API.
Consulta altri tutorial per maggiori informazioni.
Come verificare se un numero di telefono può ricevere messaggi su WhatsApp
Puoi verificare se un determinato numero di telefono è collegato a un account WhatsApp e può ricevere messaggi.
La API fornisce un endpoint che può convalidare se un dato numero di telefono esiste su WhatsApp o meno.
L'unico requisito è avere almeno un numero WhatsApp collegato alla piattaforma nel tuo account corrente.
Per maggiori dettagli, consulta la documentazione dell'endpoint API qui.
Prima di verificare se un numero di telefono esiste su WhatsApp, puoi anche convalidare e normalizzare il formato di una lista di numeri di telefono usando l'endpoint validator numeri. Questo endpoint convalida solo il corretto formato E164, ma non verifica se il numero di telefono esiste effettivamente su WhatsApp o meno.
Nota: il numero di verifiche WhatsApp è limitato al mese in base al tuo piano di abbonamento. Consulta la tabella dei prezzi per maggiori dettagli sui limiti.
Cerchi altre risposte? Dai un'occhiata alle FAQ estese.
Ulteriori risorse utili
Documentazione API
Per maggiori dettagli sull'endpoint API, consulta il documento dove troverai tutti i dettagli sui parametri di richiesta accettati, le possibili risposte di successo o errore e gli esempi di codice pronti all'uso in più linguaggi di programmazione.
