Invia messaggi audio utilizzando l'API di WhatsApp

5 settembre 2025

Back to Blog

Hai bisogno di aiuto per le richieste dei clienti, promozioni e aggiornamenti che devi inviare? Immagina se potessi automatizzare questi compiti, come inviare messaggi vocali simili a registrazioni audio su WhatsApp direttamente ai clienti o alle chat di gruppo, per fare tutto in modo rapido ed efficiente. Con Wassenger, questo è facilissimo!

Che si tratti di un promemoria, notifica o promozione, i tuoi messaggi audio garantiscono una consegna efficace e migliorano l'esperienza del cliente. Inoltre, risparmi tempo e offri una migliore esperienza utente usando l'audio invece del testo.

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

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

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

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

Questo tutorial ti insegnerà come inviare messaggi audio a numeri di telefono e liste di chat di gruppo utilizzando 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 è disponibile il tester API live con esempi di codice pronti all'uso in diversi linguaggi di programmazione.

Requisiti

  • Un numero WhatsApp collegato a Wassenger. Puoi farlo in pochi minuti usando il tuo numero WhatsApp esistente iscrivendoti gratuitamente qui.
  • Ottieni la tua chiave API Wassenger qui: è richiesta la registrazione.
  • Numero di telefono del destinatario con prefisso internazionale nel formato E164 o ID della chat di gruppo WhatsApp. Esempio di numero di telefono: +12345678900. Puoi convalidare il formato del numero di telefono qui.

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 testarlo

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, dovresti 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 pubblicamente accessibile 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 accessibile pubblicamente, restituisca uno status HTTP non valido (>=400), o restituisca contenuto non binario, come HTML o testo, l'API restituirà un errore.

URL API 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 usando, il processo potrebbe variare. Per semplificare, dobbiamo evidenziare gli strumenti più popolari, come Postman, e qualsiasi altro linguaggio di programmazione.

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

Inviare audio usando codice

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

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

# Esempi richiedono di aver installato 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 più di 100+ casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti per una prova gratuita e iniziare in pochi minuti!

Inviare messaggi audio a un numero di telefono

Inviare un nuovo messaggio multimediale tramite API è facile, devi semplicemente conoscere il numero di telefono di destinazione nel 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 nell'agenda o 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 a 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 partecipante con il permesso di inviare messaggi. Se non sei amministratore del gruppo, dovresti avere il permesso di inviare messaggi.

Preparare la richiesta

URL API destinazione (POST)

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

Header HTTPS richiesti

Content-Type: application/json
Token: $API_KEY

Corpo della richiesta in formato JSON

Invio di 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 destinazione (POST)

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

Header HTTPS richiesti

Content-Type: application/json
Token: $API_KEY

Corpo della richiesta in formato JSON

Invio di un messaggio a un Canale WhatsApp:

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

Test live per inviare messaggi multimediali tramite l'API

Ora puoi eseguire, fare debug e testare l'API in diretta direttamente dal tuo browser, esplorare e provare altri esempi API e ottenere con un clic snippet 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 più di 100+ casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti per una prova gratuita e iniziare 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 sottoscrivere uno dei piani Platform che ti permette di implementare chatbot sopra l'API.

Esplora di più dal nostro articolo correlato qui.

Quali tipi 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 determinato numero di telefono esiste su WhatsApp o meno, e quindi se può ricevere messaggi su WhatsApp, utilizzando l'endpoint API Number exists (Number exists API endpoint).

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

Cerchi altre risposte? Consulta le FAQ estese.

Risorse ulteriori 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 di errore e esempi di codice pronti all'uso in più linguaggi di programmazione:

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

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