Envie Mensagens de Áudio Usando a API do WhatsApp

5 de setembro de 2025

Back to Blog

Precisa de ajuda com dúvidas de clientes, promoções e atualizações que precisa enviar? Imagine se você pudesse automatizar essas tarefas, como enviar mensagens de áudio tipo gravação de voz no WhatsApp diretamente para clientes ou chats em grupo, para fazer tudo de forma rápida e eficiente. Com Wassenger, isso é fácil de fazer!

Seja um lembrete, notificação ou promoção, suas mensagens de áudio garantem entrega efetiva e melhoram a experiência do cliente. Além disso, você economiza tempo e oferece uma melhor experiência usando áudio em vez de texto.

🫣 Não quer usar programação? Sem problemas! Explore nosso novo recurso Campaigns (Campanhas) sem código para WhatsApp. Importe seus contatos, defina uma mensagem, agende a entrega e relaxe! 🥳 🥳

Neste tutorial, vamos guiá-lo passo a passo sobre como configurar e usar a Wassenger API para automatizar a entrega de mensagens de áudio do WhatsApp (semelhantes a gravação de voz) para🚀

Exemplos de código prontos para uso em Python, C#, PHP, JavaScript, Ruby, Java, Go e cURL estão disponíveis aqui.

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos!

Este tutorial mostrará como enviar mensagens de áudio para números de telefone e listas de chats em grupo usando a API.

Você pode enviar arquivos de áudio em qualquer um dos seguintes formatos: MP3, OGG, MP4, ACC.

Se você precisa enviar mensagens a partir de código, pode usar qualquer linguagem de programação para realizar requisições HTTPS para a API. Abaixo está o testador de API ao vivo com exemplos de código prontos em várias linguagens de programação.

Requisitos

Endpoints da API

Neste tutorial, usaremos o seguinte endpoint da API:

Você pode enviar mensagens de áudio em uma única requisição de API passando a URL remota onde o arquivo está armazenado. Clique aqui para testar

Enviar mensagem de áudio a partir de URL

Para enviar uma mensagem de áudio tipo gravação de voz (PTT ou Push-To-Talk) como uma mensagem multimídia, neste caso um arquivo de áudio, você deve fornecer uma URL pública remota (acessível pela Internet) apontando para o conteúdo do arquivo de áudio.

Para enviar uma mensagem de áudio (PTT) usando os seguintes métodos na API:

  • URL remota usando JSON com um campo url contendo a URL publicamente acessível para baixar o arquivo de áudio.

Exemplo de arquivo de áudio MP3 audio file para usar

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

Observação: caso a URL não seja publicamente acessível, retorne um status HTTP inválido (>=400), ou retorne conteúdo não binário, como HTML ou texto, a API retornará um erro.

URL alvo da API (POST)

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

Cabeçalhos HTTPS obrigatórios

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

Corpo da requisição em formato JSON

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

Dependendo da linguagem de programação ou do software cliente HTTP que você estiver usando, o processo pode variar. Para facilitar, precisamos destacar as ferramentas mais populares, como Postman, e quaisquer outras linguagens de programação.

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos!

Enviar áudio usando código

Explore como usar o código no seu navegador sem instalar nenhum software.

Além disso, você pode encontrar diferentes linguagens que pode testar no Replit.com:

# Exemplos requerem o pacote requests do Python instalado. # Instale executando: 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 é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos!

Enviar mensagens de áudio para um número de telefone

Enviar uma nova mensagem multimídia via API é fácil, você só precisa saber o número de telefone de destino no formato E164 e a URL do arquivo de áudio.

Você pode enviar mensagens para qualquer número de telefone no mundo que tenha uma conta no WhatsApp, não é necessário adicionar o número como contato na agenda do seu dispositivo móvel.

Enviar mensagens de áudio para um chat em grupo no WhatsApp

Semelhante ao cenário anterior, você também pode enviar mensagens multimídia para chats em grupo.

Para isso, você precisa saber o ID do chat em grupo de destino e a URL remota do arquivo de áudio.

Para enviar mensagens a um grupo, você deve ser participante dele com permissão para enviar mensagens. Se você não for o administrador do grupo, você deve ter permissão para enviar mensagens.

Preparar a requisição

URL alvo da API (POST)

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

Cabeçalhos HTTPS obrigatórios

Content-Type: application/json
Token: $API_KEY

Corpo da requisição em formato JSON

Enviando uma mensagem para um chat em grupo:

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

Enviar mensagens de áudio para um Canal do WhatsApp

Semelhante ao cenário anterior, você também pode enviar mensagens multimídia para WhatsApp Channels.

Para isso, você precisa saber o ID do Canal do WhatsApp de destino e a URL do arquivo de áudio.

Para enviar mensagens a um Canal do WhatsApp, você deve ser o proprietário do canal.

URL alvo da API (POST)

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

Cabeçalhos HTTPS obrigatórios

Content-Type: application/json
Token: $API_KEY

Corpo da requisição em formato JSON

Enviando uma mensagem para um Canal do WhatsApp:

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

Teste ao vivo envia mensagens multimídia usando a API

Você agora pode executar, depurar e testar a API ao vivo diretamente do seu navegador, explorar e testar mais exemplos de API e obter com um clique trechos de código prontos para uso disponíveis em mais de 15 linguagens de programação 😎

Testar o testador de API ao vivo

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso de API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos!

FAQ

Posso usar o Wassenger para chatbots?

Sim, você pode construir seu chatbot com nossa API e webhooks. Para isso, você precisa assinar qualquer plano Platform que permita implementar chatbots sobre a API.

Explore mais no nosso artigo relacionado aqui.

Que tipo de arquivos de mídia podem ser enviados?

Você pode enviar imagens (JPEG, PNG, WEBP), vídeos (MP4, 3GPP), áudios (MP3, OGG, MP4, ACC), gifs (MP4) e documentos (PDF, PPT, PPTX, DOCX, DOC, ZIP, RAR, outros tipos binários).

Consulte a documentação da API para mais detalhes.

Como posso validar números de telefone?

Você pode validar se um determinado número de telefone existe no WhatsApp ou não, e portanto pode receber mensagens no WhatsApp, usando o endpoint Number exists da API (Number exists API endpoint).

Observe que você deve ter pelo menos um número do WhatsApp conectado à plataforma para realizar a validação.

Procurando mais respostas? Confira as FAQs estendidas.

Recursos úteis adicionais

Documentação da API

Para mais detalhes sobre o endpoint da API, por favor verifique a documentação onde você encontrará todos os detalhes sobre os parâmetros aceitos na requisição, possíveis respostas de sucesso ou erro e exemplos de código prontos em múltiplas linguagens de programação:

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

More Articles & Tutorials

How Clinics Are Saving Up 25 Hours Weekly With WhatsApp Automation

Como Clínicas Estão Economizando Até 25 Horas Semanais Com Automação WhatsApp

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

Como Corretores de Imóveis Estão Conquistando o Mercado Automatizando o WhatsApp

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

Conecte o WhatsApp com IA em 5 Minutos MCP

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

Como Construir Um Moderador De Grupo Do WhatsApp Com IA

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

Eu Automatizei 50 Grupos do WhatsApp Aqui Está o Código

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

Como Ganhar Dinheiro Com Flows do Wassenger Enquanto Seus Concorrentes Ainda Fazem Tudo Manualmente

October 3, 2025

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free