In questo tutorial imparerai come programmare la consegna dei 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'ora esatti in cui vuoi che venga inviato oppure indicando di quanti minuti, ore o giorni desideri posticipare la consegna.
Se vuoi inviare messaggi da codice, puoi usare qualsiasi linguaggio di programmazione per eseguire richieste HTTPS all'API. Di seguito trovi il tester API live con esempi di codice pronti all'uso in vari linguaggi di programmazione.
Requisiti
- Avere un WhatsApp number già collegato alla piattaforma e online.
- Numero di telefono del destinatario con prefisso internazionale in formato E.164. Esempio:
+12345678909. Puoi convalidare il numero di telefono qui.
Endpoint API
In questo tutorial useremo il seguente endpoint API:
Prepara la richiesta
URL API di destinazione (POST)
https://api.wassenger.com/v1/messages
Header HTTPS richiesti
Content-Type: application/json
Token: ENTER API KEY HERE
Invia un messaggio a una data specifica in formato ISO8601
Esempio di corpo della richiesta in formato JSON
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'phone' => '+12345678909',
'message' =>
'This is a scheduled message to be sent to a phone number in 10 minutes',
'deliverAt' => '2025-01-03T10:11:24.323Z',
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Puoi anche inviare messaggi programmati a una chat di gruppo:
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'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-04T10:01:24.323Z',
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Posticipa la consegna del messaggio per 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 devi programmare un messaggio per 1,5 ore, ad esempio, devi specificare 90m = tra 90 minuti
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'phone' => '+12345678909',
'message' =>
'This is a scheduled message to be sent to a phone number in 10 minutes',
'schedule' => [
'delayTo' => '1h',
],
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
In alternativa, puoi posticipare la consegna del messaggio di un dato numero di secondi:
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.wassenger.com/v1/messages',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode([
'phone' => '+12345678909',
'message' =>
'This is a scheduled message to be sent to a phone number in 10 minutes',
'schedule' => [
'delayTo' => '180',
],
]),
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Token: API TOKEN GOES HERE',
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo 'cURL Error #:' . $err;
} else {
echo $response;
}
Test dell'API in tempo reale
Ora puoi sperimentare, eseguire il 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 😎
Hai domande? Consulta le domande frequenti qui sotto.
Domande frequenti
Come inviare messaggi a più numeri di telefono
Devi semplicemente inviare molteplici richieste API, una per ciascun 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 una singola richiesta API.
Che tipo di messaggi possono essere inviati?
Puoi inviare diversi tipi di messaggi tramite API, tra cui testo, immagini, video, emoji, audio, GIF, posizioni geografiche e documenti.
Consulta altri tutorial per maggiori informazioni.
Come verificare se un numero di telefono può ricevere messaggi WhatsApp
Puoi verificare se un determinato numero di telefono è collegato a un account WhatsApp e può ricevere messaggi.
L'API fornisce un endpoint che può verificare se un numero di telefono è presente su WhatsApp o meno.
L'unico requisito è avere almeno un numero WhatsApp connesso alla piattaforma nel tuo account attuale.
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 API di convalida numeri. Questo endpoint valida solo il corretto formato E.164, ma non verifica se il numero di telefono esiste effettivamente su WhatsApp.
Nota: il numero di verifiche WhatsApp è limitato mensilmente in base al tuo piano di abbonamento. Consulta la tabella dei prezzi per maggiori dettagli sui limiti.
Cerchi altre risposte? Consulta le FAQ estese.
Altre risorse utili
Documentazione API
Per maggiori dettagli sull'endpoint API, consulta il documento dove troverai tutte le informazioni sui parametri della richiesta accettati, sulle possibili risposte di successo o errore e sugli esempi di codice pronti all'uso in diversi linguaggi di programmazione.
