Come programmare un aggiornamento di stato WhatsApp Stories

20 settembre 2024

Back to Blog

Ecco tutto quello che devi sapere sulla funzione Stato di WhatsApp e su come pubblicare aggiornamenti automaticamente sul tuo numero WhatsApp per coinvolgere meglio i clienti.

🤩 🤖 Wassenger è una piattaforma di comunicazione completa e una soluzione API per WhatsApp. Scopri oltre 100 casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti a una prova gratuita e iniziando in pochi minuti!

Che cos'è lo Stato di WhatsApp?

Lo Stato di WhatsApp, noto anche come WhatsApp Stories (simile alle Instagram Stories), è una funzione che ti permette di pubblicare aggiornamenti di stato del profilo che scompaiono dopo 24 ore. Puoi pubblicare foto, video, testo, link e GIF.

Se sai già usare le Instagram Stories, ti troverai subito a tuo agio. Imparerai in fretta come controllare lo stato WhatsApp di un amico e aggiornare il tuo.

Per impostazione predefinita, lo Stato WhatsApp è visibile solo tra due utenti che hanno salvato reciprocamente i dettagli di contatto nelle rispettive rubriche. Se non hai il numero di qualcuno nei tuoi contatti, quella persona non può vedere il tuo messaggio di stato.

Detto questo, oggi ti presentiamo il modo più efficace per programmare le tue storie WhatsApp in modo da tenere clienti/contatti informati su tutte le tue novità e sul tuo brand. Scopri quanto è semplice con Wassenger

Scopri come caricare un nuovo stato WhatsApp (story) in pochi minuti qui

Nota: La funzionalità API per lo Stato WhatsApp è disponibile solo nei piani Platform. Se vuoi usarla, per favore aggiorna il tuo piano.

Requisiti

Endpoint API

Useremo il seguente endpoint API per aggiornare lo Stato WhatsApp:

Preparare la richiesta

URL target dell'API utilizzando il metodo POST

https://api.wassenger.com/v1/chat/{deviceId}/status

Header HTTPS richiesti > Ottieni la tua API key qui

Content-Type: application/json
Token: $API_TOKEN

Usa il corpo in formato JSON per un aggiornamento immagine

{
  "message": "This is a scheduled WhatsApp status update for tomorrow with an image",
  "schedule": {
    "date": "2024-09-21T10:53:24.998Z"
  },
  "media": {
    "url": "https://picsum.photos/seed/picsum/600/400"
  }
}

Usa il corpo in formato JSON per un aggiornamento video

{
  "message": "This is a scheduled WhatsApp status update for tomorrow with an image",
  "schedule": {
    "date": "2024-09-21T10:53:24.998Z"
  },
  "media": {
    "url": "https://download.samplelib.com/mp4/sample-5s.mp4"
  }
}

Usa il corpo in formato JSON con parametri aggiuntivi come font del testo o colore di sfondo

Nota: Quando si caricano immagini, il parametro colour non può essere aggiunto

{
"message": "This is a scheduled WhatsApp status update for tomorrow with an image", 
"schedule": {
"date": "2024-09-21T10:53:24.998Z"
}, 
"font": "helvetica", 
"color": "red_purple", 
}

🖥️ Cerchi un esempio di codice? Vai al tester API live e ottieni esempi di codice pronti all'uso in 15+ linguaggi di programmazione, inclusi Python, JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL e altri.

🤩 🤖 Wassenger è una soluzione API completa per WhatsApp. Iscriviti per una prova gratuita di 7 giorni e inizia in pochi minuti!

Carica lo stato tramite codice

Scopri come utilizzare il codice nel tuo browser senza installare alcun software.

Inoltre, puoi trovare diversi linguaggi da testare su Replit.com:

Python

Pubblica un'immagine programmata

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/DEVICE_ID/status"
payload = {
"message": "This is a scheduled WhatsApp status update for tomorrow with an image", 
"schedule": { "date": "2024-09-21T10:53:24.998Z" }, 
"media": { "url": "https://picsum.photos/seed/picsum/600/400" }
}
headers = {
"Content-Type": "application/json", 
"Token": "API TOKEN GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

Pubblica un video programmato

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/DEVICE_ID/status"
payload = {
"message": "This is a scheduled WhatsApp status update for tomorrow with an image", 
"schedule": { "date": "2024-09-21T10:53:24.998Z" }, 
"media": { "url": "https://download.samplelib.com/mp4/sample-5s.mp4" }
}
headers = {
"Content-Type": "application/json", 
"Token": "API TOKEN GOES HERE"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

🤩 🤖 Wassenger è una soluzione API completa per WhatsApp. Iscriviti per una prova gratuita di 7 giorni e inizia in pochi minuti!

Pubblica un'immagine programmata

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/DEVICE_ID/status',
  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([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://picsum.photos/seed/picsum/600/400',
    ],
  ]),
  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;
}

Pubblica un video programmato

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/DEVICE_ID/status',
  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([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://download.samplelib.com/mp4/sample-5s.mp4',
    ],
  ]),
  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;
}

Pubblica un'immagine programmata

// Examples requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://pecl.php.net/package/pecl_http/3.2.0
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://picsum.photos/seed/picsum/600/400',
    ],
  ])
);
$request->setRequestUrl('https://api.wassenger.com/v1/chat/DEVICE_ID/status');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'API TOKEN GOES HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Pubblica un video programmato

// Examples requires to have installed pecl_http package, a simple and elegant HTTP client for PHP.
// Install it by running: pecl install pecl_http
// More information: https://pecl.php.net/package/pecl_http/3.2.0
<?php
$client = new http\Client();
$request = new http\Client\Request();
$body = new http\Message\Body();
$body->append(
  json_encode([
    'message' =>
      'This is a scheduled WhatsApp status update for tomorrow with an image',
    'schedule' => [
      'date' => '2024-09-21T10:53:24.998Z',
    ],
    'media' => [
      'url' => 'https://download.samplelib.com/mp4/sample-5s.mp4',
    ],
  ])
);
$request->setRequestUrl('https://api.wassenger.com/v1/chat/DEVICE_ID/status');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'API TOKEN GOES HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

Pubblica un'immagine programmata

// This code requires you to have installed Unirest package.
// Documentation: https://kong.github.io/unirest-java/#requests
// Installation: http://kong.github.io/unirest-java/
HttpResponse<String> response = Unirest.post("https://api.wassenger.com/v1/chat/DEVICE_ID/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2024-09-21T10:53:24.998Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
.asString();

Pubblica un video programmato

// This code requires you to have installed Unirest package.
// Documentation: https://kong.github.io/unirest-java/#requests
// Installation: http://kong.github.io/unirest-java/
HttpResponse<String> response = Unirest.post("https://api.wassenger.com/v1/chat/DEVICE_ID/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a scheduled WhatsApp status update for tomorrow with an image\", \"schedule\":{\"date\":\"2024-09-21T10:53:24.998Z\"}, \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
.asString();

Hai bisogno di altro? Esplora tutti i nostri esempi per lo Stato WhatsApp e sfrutta tutto il potenziale!

🤩 🤖 Wassenger è una piattaforma di comunicazione completa e una soluzione API per WhatsApp. Scopri oltre 100 casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti a una prova gratuita e iniziando in pochi minuti!

Test live usando l'API

Esplora il nostro tester API live

Domande frequenti

Come funziona l'elaborazione degli aggiornamenti di stato

  • Per impostazione predefinita, gli aggiornamenti dello Stato WhatsApp vengono elaborati in tempo reale a meno che non siano specificati come programmati o con ritardo.
  • Quando gli aggiornamenti di stato sono programmati, vengono memorizzati in una coda in ordine non strettamente FIFO (first-in-first-out).
  • L'ordine rigoroso può essere applicato specificando il campo order = true nel payload JSON (esempio).

È possibile usare variabili di template nei messaggi di stato?

No, la sintassi delle variabili di template non è supportata nei messaggi di stato utente.

Ho più numeri connessi: come inviare messaggi tramite un numero specifico?

Se hai più numeri collegati al tuo account, devi specificare il campo device nel corpo JSON con l'ID del dispositivo del numero WhatsApp di destinazione (valore esadecimale di 24 caratteri) tramite cui vuoi inviare i messaggi.

Se il campo device non è specificato, i messaggi verranno inviati tramite il primo numero WhatsApp collegato al tuo account.

Qui trovi un esempio di come inviare un messaggio tramite un numero WhatsApp specifico

Come inviare messaggi a più numeri di telefono

Devi inviare più richieste API, una per ogni numero di telefono di destinazione.

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.

Come verificare se un numero di telefono può ricevere messaggi WhatsApp

Puoi verificare se un dato numero di telefono è collegato a un account WhatsApp e può ricevere messaggi.

L'API fornisce un endpoint che può verificare 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 validare e normalizzare il formato di una lista di numeri di telefono utilizzando l'endpoint validator dei 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 al mese in base al tuo piano di abbonamento. Consulta la tabella dei prezzi per maggiori dettagli sui limiti.

Ulteriori risorse utili

Documentazione API

Per ulteriori dettagli sull'endpoint API, consulta la documentazione dove troverai tutte le informazioni sui parametri di richiesta accettati, le possibili risposte di successo o di errore e esempi di codice pronti all'uso in più linguaggi di programmazione:

Documentazione API - Wassenger Modifica descrizioneapp.wassenger.com

🤩 🤖 Wassenger è una soluzione API completa per WhatsApp. Iscriviti per una prova gratuita di 7 giorni e inizia in pochi minuti!

More Articles & Tutorials

How Clinics Are Saving Up 25 Hours Weekly With WhatsApp Automation

Come le cliniche stanno risparmiando fino a 25 ore settimanali con l'automazione WhatsApp

October 21, 2025
How Real Estate Agents Are Conquering The Market By Automating WhatsApp

Come gli agenti immobiliari stanno conquistando il mercato automatizzando WhatsApp

October 17, 2025
Connect WhatsApp With AI In 5 Minutes MCP

Collega WhatsApp Con L'IA In 5 Minuti MCP

October 10, 2025
How To Build A WhatsApp Group Moderator With AI

Come Costruire Un Moderatore Di Gruppo WhatsApp Con L'IA

October 8, 2025
I Automated 50 WhatsApp Groups Here S The Code

Ho automatizzato 50 gruppi WhatsApp Ecco il codice

October 6, 2025
How To Make Money With Wassenger Flows While Your Competitors Are Still Doing Everything Manually

Come Guadagnare Con Wassenger Flows Mentre I Tuoi Competitori Fanno Ancora Tutto Manualmente

October 3, 2025

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free