Invia messaggi audio utilizzando l'API di WhatsApp

3 giugno 2024

Hai bisogno di aiuto per le richieste dei clienti, le promozioni e gli aggiornamenti che devi inviare? Immagina se potessi automatizzare queste attività, come inviare messaggi audio simili a registrazioni vocali su WhatsApp direttamente ai clienti o ai gruppi, per completare tutto rapidamente ed efficacemente. Con Wassenger, questo è facilmente fattibile!

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. Inoltre, risparmi tempo e offri una migliore esperienza utente usando l'audio invece del testo.

In questo tutorial ti guidiamo 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 invio e rilassati! 🥳 🥳

🤩 🤖 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 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 da codice, puoi usare qualsiasi linguaggio di programmazione per effettuare richieste HTTPS all'API. Qui sotto trovi il tester API live con esempi di codice pronti all'uso in vari 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 API key di 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 validare 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 è memorizzato il file. 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, dovresti fornire un URL pubblico remoto (raggiungibile via 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 contenente 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 pubblicamente accessibile, restituisca uno status HTTP non valido (>=400) oppure restituisca contenuto non binario, 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 client HTTP che stai usando, 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 più di 100+ casi d'uso API e automatizza qualsiasi cosa su WhatsApp iscrivendoti per una prova gratuita e iniziando in pochi minuti!

Inviare audio usando il codice

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

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

# Examples requires to have installed requests Python package. # Install it by running: 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 iniziando in pochi minuti!

Inviare messaggi audio a un numero di telefono

Inviare un nuovo messaggio multimediale via API è semplice, devi solo 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 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 essere un partecipante con il permesso di inviare messaggi. Se non sei l'amministratore del gruppo, dovresti 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 a WhatsApp Channels.

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 live per inviare messaggi multimediali usando l'API

Ora puoi eseguire, debuggare e testare l'API direttamente dal tuo browser, esplorare e provare più 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 iniziando in pochi minuti**!**

FAQ

Posso usare Wassenger per chatbot?

Sì, puoi costruire il tuo chatbot con la nostra API e i webhook. Per farlo, devi sottoscrivere uno qualsiasi dei piani Platform che ti permettono 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 dato numero di telefono esiste su WhatsApp o meno, e quindi può ricevere messaggi su WhatsApp, usando l'endpoint Number exists API (Number exists API endpoint).

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

Cerchi altre risposte? Consulta le FAQ estese.

Risorse utili aggiuntive

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