Aggiorna la Storia di Stato di WhatsApp Usando l'API

18 settembre 2024

Back to Blog

Automatizza il tuo stato WhatsApp per mantenere i tuoi contatti/clienti aggiornati sulle ultime novità

Aggiornare il tuo stato WhatsApp non è solo una funzionalità divertente, è uno strumento potente per rimanere connessi e coinvolgere i tuoi contatti.

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

Che tu stia condividendo un aggiornamento rapido, un messaggio ispiratore o un momento spensierato, aggiornare regolarmente il tuo stato aiuta a mantenere le relazioni e a tenere la tua rete informata. Come le Storie di Instagram o Snapchat, lo stato di WhatsApp ti permette di condividere momenti fugaci che scompaiono dopo 24 ore, creando un senso di immediatezza e connessione. Per aziende e privati, uno stato WhatsApp attivo può migliorare la comunicazione e aggiungere un tocco personale alle interazioni quotidiane.

Nota: la funzionalità API per lo stato WhatsApp è disponibile solo nei piani Platform. Se desideri usarla, per favore effettua l'upgrade del tuo piano.

Requisiti

Endpoint API

Utilizzeremo il seguente endpoint API per aggiornare lo stato WhatsApp:

Prepara la richiesta

URL API di destinazione usando il metodo POST

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

Intestazioni HTTPS richieste > Ottieni la tua API key qui

Content-Type: application/json
Token: $API_TOKEN

Usa il body in formato JSON per un aggiornamento immagine

{
  "message": "This is a image caption message that can also include links: https://youtube.com",
  "media": {
    "url": "https://picsum.photos/seed/picsum/600/400"
  }
}

Usa il body in formato JSON per un aggiornamento video

{
  "message": "This is a video caption message that can also include links: https://youtube.com",
  "media": {
    "url": "https://download.samplelib.com/mp4/sample-5s.mp4"
  }
}

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

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

Carica lo stato usando il codice

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

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

Pubblica un'immagine

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/66d1a54430541033/status"
payload = {
"message": "This is a image caption message that can also include links: https://youtube.com", 
"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

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
import requests
url = "https://api.wassenger.com/v1/chat/66d1a54430541033/status"
payload = {
"message": "This is a image caption message that can also include links: https://youtube.com", 
"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())

Pubblica un'immagine

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/66d1a544305410/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 image caption message that can also include links: https://youtube.com',
    '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

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.wassenger.com/v1/chat/66d1a5443054103/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 video caption message that can also include links: https://youtube.com',
    '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

// 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 video caption message that can also include links: https://youtube.com',
    'media' => [
      'url' => 'https://picsum.photos/seed/picsum/600/400',
    ],
  ])
);
$request->setRequestUrl(
  'https://api.wassenger.com/v1/chat/66d1a54430541033/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

# Examples requires to have installed requests Python package.
# Install it by running: pip install requests
// 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 video caption message that can also include links: https://youtube.com',
    'media' => [
      'url' => 'https://download.samplelib.com/mp4/sample-5s.mp4',
    ],
  ])
);
$request->setRequestUrl(
  'https://api.wassenger.com/v1/chat/66d1a54430541033/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

// 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/66d1a54430541033/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a image caption message that can also include links: https://youtube.com\", \"media\":{\"url\":\"https://picsum.photos/seed/picsum/600/400\"}}")
.asString();

Pubblica un video

// 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/66d1a5443054103/status")
.header("Content-Type", "application/json")
.header("Token", "API TOKEN GOES HERE")
.body("{\"message\":\"This is a video caption message that can also include links: https://youtube.com\", \"media\":{\"url\":\"https://download.samplelib.com/mp4/sample-5s.mp4\"}}")
.asString();

Serve altro? Esplora tutti i nostri esempi per lo stato WhatsApp e mettiti all'opera!

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

Test live del caricamento file tramite 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 ritardati.
  • Quando gli aggiornamenti di stato sono programmati, vengono memorizzati in una coda in ordine non rigoroso first-in-first-out (FIFO).
  • L'ordine rigoroso può essere imposto 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 collegati: come inviare messaggi tramite un numero specifico?

Se hai più numeri collegati al tuo account, devi specificare il campo device nel body 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 c'è 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 validare se un numero di telefono può ricevere messaggi WhatsApp

Puoi validare 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 API di validazione numeri. Questo endpoint valida solo il corretto formato E164, 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 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 la documentazione dove troverai tutti i dettagli sui parametri di richiesta accettati, sulle possibili risposte di successo o di errore e esempi di codice pronti all'uso in più linguaggi di programmazione:

https://app.wassenger.com/docs/#tag/User-Status/operation/getUserStatus

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