Invia messaggi audio automatici utilizzando l'API di WhatsApp

14 aprile 2025

Hai bisogno di aiuto con le richieste dei clienti, le promozioni e gli aggiornamenti che devi inviare? Immagina di poter automatizzare queste attività, ad esempio inviando messaggi audio simili a registrazioni vocali su WhatsApp direttamente ai clienti o alle chat di gruppo, per fare tutto in modo rapido ed efficiente. Con Wassenger, questo è facilmente realizzabile!

Sia che si tratti di un promemoria, una notifica o una promozione, i tuoi messaggi audio garantiscono una consegna efficace e migliorano l'esperienza del cliente. Usare l'audio invece del testo risparmia anche tempo e offre una migliore esperienza utente.

In questo tutorial ti guideremo passo-passo su come configurare e usare la Wassenger API per automatizzare la consegna di messaggi audio WhatsApp (simili a registrazioni vocali) per🚀

Esempi di codice pronti all'uso in Python, C#, PHP, JavaScript, Ruby, Java, Go e cURL sono disponibili qui.

🫣 Non vuoi usare la programmazione? Nessun problema! Esplora la nostra nuova funzionalità no-code Campagne WhatsApp. Importa i tuoi contatti, definisci un messaggio, imposta una data di consegna e rilassati! 🥳 🥳

🤩 🤖 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 registrandoti per una prova gratuita e iniziando in pochi minuti**!**

Questo tutorial ti insegnerà come inviare messaggi audio a numeri di telefono e liste di chat di gruppo usando l'API.

Puoi inviare file audio in uno dei seguenti formati: MP3, OGG, MP4, ACC.

Se hai bisogno di inviare messaggi dal 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

Endpoint API

In questo tutorial useremo il seguente endpoint API:

Puoi inviare messaggi audio in una singola richiesta API passando l'URL remoto dove il file è memorizzato. Clicca qui per provarlo

Inviare un messaggio audio da URL

Per inviare un messaggio audio simile a una registrazione vocale (PTT o Push-To-Talk) come messaggio multimediale, in questo caso un file audio, devi fornire un URL pubblico remoto (raggiungibile da Internet) che punti al contenuto del file audio.

Per inviare un messaggio audio (PTT) usando i seguenti metodi tramite l'API:

  • URL remoto usando JSON con un campo url con l'URL accessibile pubblicamente per scaricare il file audio.

Esempio di file audio MP3 audio file da usare

https://download.samplelib.com/mp3/sample-9s.mp3

Nota: nel caso in cui l'URL non sia pubblicamente accessibile, restituisca uno stato HTTP non valido (>=400) o restituisca contenuti non binari, come HTML o testo, l'API restituirà un errore.

URL API di destinazione (POST)

https://api.wassenger.com/v1/messages

Header HTTPS richiesti

Content-Type: application/json
Token: $API-TOKEN

Corpo della richiesta in formato JSON

{
  "phone": "+1234567890",
  "media": {
    "url": "https://download.samplelib.com/mp3/sample-9s.mp3",
    "format": "ptt"
  }
}

A seconda del linguaggio di programmazione o del software client HTTP che stai utilizzando, il processo potrebbe variare. Per semplificare, evidenziamo gli strumenti più popolari, come Postman, e altri linguaggi di programmazione.

🤩 🤖 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 registrandoti per una prova gratuita e iniziando in pochi minuti**!**

Inviare audio usando il codice

Scopri come usare il codice nel tuo browser senza installare nulla.

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

# Gli esempi richiedono il pacchetto requests per Python. # Installalo eseguendo: pip install requests

import requests

url = "https://api.wassenger.com/v1/messages"

payload = { "phone": "+1234567890", "media": { "url": "https://download.samplelib.com/mp3/sample-9s.mp3", "format": "ptt" } } headers = { "Content-Type": "application/json", "Token": "ENTER API KEY HERE" }

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

var axios = require('axios');
var options = {
  method: 'POST',
  url: 'https://api.wassenger.com/v1/messages',
  headers: { 'Content-Type': 'application/json', Token: 'ENTER API KEY HERE' },
  data: {
    phone: '+1234567890',
    media: {
      url: 'https://download.samplelib.com/mp3/sample-9s.mp3',
      format: 'ptt'
    }
  }
};
axios
  .request(options)
  .then(function (response) {
    console.log(response.data);
  })
  .catch(function (error) {
    console.error(error);
  });
<?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 => "{\"phone\":\"+1234567890\", \"media\":{\"url\":\"https://download.samplelib.com/mp3/sample-9s.mp3\", \"format\":\"ptt\"}}",
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'Token: ENTER API KEY HERE',
  ],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo 'cURL Error #:' . $err;
} else {
  echo $response;
}
// 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(
  '{"phone":"+1234567890", "media":{"url":"https://download.samplelib.com/mp3/sample-9s.mp3", "format":"ptt"}}'
);
$request->setRequestUrl('https://api.wassenger.com/v1/messages');
$request->setRequestMethod('POST');
$request->setBody($body);
$request->setHeaders([
  'Content-Type' => 'application/json',
  'Token' => 'ENTER API KEY HERE',
]);
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();
package main
import(
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url:= "https://api.wassenger.com/v1/messages"
payload:= strings.NewReader("{\"phone\":\"+1234567890\", \"media\":{\"url\":\"https://download.samplelib.com/mp3/sample-9s.mp3\", \"format\":\"ptt\"}}")
req, _:= http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Token", "ENTER API KEY HERE")
res, _:= http.DefaultClient.Do(req)
defer res.Body.Close()
body, _:= ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
  • C# (RestClient)
// This code requires you to have installed RestSharp package.
// Documentation: https://restsharp.dev
// Installation: https://www.nuget.org/packages/RestSharp
var client = new RestClient("https://api.wassenger.com/v1/messages");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Token", "ENTER API KEY HERE");
request.AddParameter("application/json", "{\"phone\":\"+1234567890\", \"media\":{\"url\":\"https://download.samplelib.com/mp3/sample-9s.mp3\", \"format\":\"ptt\"}}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.wassenger.com/v1/messages")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request["Token"] = 'ENTER API KEY HERE'
request.body = "{\"phone\":\"+1234567890\", \"media\":{\"url\":\"https://download.samplelib.com/mp3/sample-9s.mp3\", \"format\":\"ptt\"}}"
response = http.request(request)
puts response.read_body
// 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/messages")
.header("Content-Type", "application/json")
.header("Token", "ENTER API KEY HERE")
.body("{\"phone\":\"+1234567890\", \"media\":{\"url\":\"https://download.samplelib.com/mp3/sample-9s.mp3\", \"format\":\"ptt\"}}")
.asString();

🤩 🤖 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 registrandoti per una prova gratuita e iniziando in pochi minuti!

Inviare messaggi audio a un numero di telefono

Inviare un nuovo messaggio multimediale tramite API è semplice; devi solo conoscere il numero di telefono di destinazione in formato E164 e l'URL del file audio.

Puoi inviare messaggi a qualsiasi numero di telefono nel mondo che abbia un account WhatsApp, non è necessario aggiungere il numero come contatto nella rubrica del tuo dispositivo mobile.

Inviare messaggi audio a una chat di gruppo su WhatsApp

Simile allo scenario precedente, puoi anche inviare messaggi multimediali alle chat di gruppo.

Per farlo, devi conoscere l'ID della chat di gruppo di destinazione e l'URL remoto del file audio.

Per inviare messaggi a un gruppo, devi esserne un partecipante con i permessi per inviare messaggi. Se non sei l'amministratore del gruppo, devi avere il permesso di inviare messaggi.

Preparare la richiesta

URL API di destinazione (POST)

https://api.wassenger.com/v1/messages

Header HTTPS richiesti

Content-Type: application/json
Token: $API_KEY

Corpo della richiesta in formato JSON

Inviare un messaggio a una chat di gruppo:

{
  "group": "1234567890-100000000@g.us",
  "media": {
    "url": "https://download.samplelib.com/mp3/sample-9s.mp3",
    "format": "ptt"
  }
}

Inviare messaggi audio a un Canale WhatsApp

Simile allo scenario precedente, puoi anche inviare messaggi multimediali ai Canali WhatsApp.

Per farlo, devi conoscere l'ID del Canale WhatsApp di destinazione e l'URL del file audio.

Per inviare messaggi a un Canale WhatsApp, devi essere il proprietario del canale.

URL API di destinazione (POST)

https://api.wassenger.com/v1/messages

Header HTTPS richiesti

Content-Type: application/json
Token: $API_KEY

Corpo della richiesta in formato JSON

Inviare un messaggio a un Canale WhatsApp:

{
  "channel": "12345678901234567@newsletter",
  "media": {
    "url": "https://download.samplelib.com/mp3/sample-9s.mp3",
    "format": "ptt"
  }
}

Test dal vivo per inviare messaggi multimediali usando l'API

Ora puoi eseguire, fare debug e testare l'API in tempo reale direttamente dal tuo browser, esplorare e provare altri esempi API e ottenere con un clic frammenti di codice pronti all'uso disponibili in oltre 15 linguaggi di programmazione 😎

Testa il tester API live

🤩 🤖 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 registrandoti per una prova gratuita e iniziando in pochi minuti**!**

Domande frequenti

Posso usare Wassenger per i chatbot?

Sì, puoi costruire il tuo chatbot con la nostra API e i webhook. Per farlo, devi abbonarti a un piano Platform che ti consenta di implementare chatbot sopra l'API.

Scopri di più nel nostro articolo correlato qui.

Che tipo di file multimediali possono essere inviati?

Puoi inviare immagini (JPEG, PNG, WEBP), video (MP4, 3GPP), audio (MP3, OGG, MP4, ACC), gif (MP4) e documenti (PDF, PPT, PPTX, DOCX, DOC, ZIP, RAR, altri tipi binari).

Consulta la documentazione API per maggiori dettagli.

Come posso convalidare i numeri di telefono?

Puoi verificare se un dato numero di telefono esiste su WhatsApp o meno, e quindi può ricevere messaggi su WhatsApp, usando l'endpoint API Number exists.

Nota che devi avere almeno un numero WhatsApp connesso alla piattaforma per eseguire la convalida.

Cerchi altre risposte? Controlla le FAQ estese.

Ulteriori risorse utili

Documentazione API

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

https://app.wassenger.com/docs/#tag/Files

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free