Enviar Áudio de Voz

Enviar uma mensagem de voz

curl --request POST \
  --url https://{host}/api/sendVoice \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "session": "session",
  "chatId": "5511999999999@c.us",
  "url": "https://example.com/audio.mp3"
}
'

import requests

url = "https://{host}/api/sendVoice"

payload = {
    "session": "session",
    "chatId": "5511999999999@c.us",
    "url": "https://example.com/audio.mp3"
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    session: 'session',
    chatId: '5511999999999@c.us',
    url: 'https://example.com/audio.mp3'
  })
};

fetch('https://{host}/api/sendVoice', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/api/sendVoice",
  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([
    'session' => 'session',
    'chatId' => '5511999999999@c.us',
    'url' => 'https://example.com/audio.mp3'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "apikey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/api/sendVoice"

	payload := strings.NewReader("{\n  \"session\": \"session\",\n  \"chatId\": \"5511999999999@c.us\",\n  \"url\": \"https://example.com/audio.mp3\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("apikey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/api/sendVoice")
  .header("apikey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"session\": \"session\",\n  \"chatId\": \"5511999999999@c.us\",\n  \"url\": \"https://example.com/audio.mp3\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/api/sendVoice")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"session\": \"session\",\n  \"chatId\": \"5511999999999@c.us\",\n  \"url\": \"https://example.com/audio.mp3\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

POST

api

sendVoice

Enviar uma mensagem de voz

curl --request POST \
  --url https://{host}/api/sendVoice \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "session": "session",
  "chatId": "5511999999999@c.us",
  "url": "https://example.com/audio.mp3"
}
'

import requests

url = "https://{host}/api/sendVoice"

payload = {
    "session": "session",
    "chatId": "5511999999999@c.us",
    "url": "https://example.com/audio.mp3"
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    session: 'session',
    chatId: '5511999999999@c.us',
    url: 'https://example.com/audio.mp3'
  })
};

fetch('https://{host}/api/sendVoice', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{host}/api/sendVoice",
  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([
    'session' => 'session',
    'chatId' => '5511999999999@c.us',
    'url' => 'https://example.com/audio.mp3'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "apikey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{host}/api/sendVoice"

	payload := strings.NewReader("{\n  \"session\": \"session\",\n  \"chatId\": \"5511999999999@c.us\",\n  \"url\": \"https://example.com/audio.mp3\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("apikey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{host}/api/sendVoice")
  .header("apikey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"session\": \"session\",\n  \"chatId\": \"5511999999999@c.us\",\n  \"url\": \"https://example.com/audio.mp3\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{host}/api/sendVoice")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["apikey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"session\": \"session\",\n  \"chatId\": \"5511999999999@c.us\",\n  \"url\": \"https://example.com/audio.mp3\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

Descrição

Este endpoint permite enviar mensagens de áudio (notas de voz) para contatos individuais ou grupos no WhatsApp. O áudio deve ser enviado em formato base64. As notas de voz são exibidas como mensagens de áudio reproduzíveis no WhatsApp.

Body

{
  "sessionId": "my-session",
  "jid": "5511999999999@s.whatsapp.net",
  "audio": {
    "content": "iVBORw0KGgoAAAANSUhEUgAAAA...",
    "mimetype": "image/png"
  }
}

Parâmetros do Body

Propriedade	Tipo	Obrigatório	Descrição
`sessionId`	`string`	✅ Sim	ID da sessão autenticada que enviará o áudio
`jid`	`string`	✅ Sim	Identificador do destinatário (JID do WhatsApp). Formato: `5511999999999@s.whatsapp.net` para contatos ou `120363XXXXX@g.us` para grupos
`audio`	`object`	✅ Sim	Objeto contendo os dados do áudio
`audio.content`	`string`	✅ Sim	Conteúdo do áudio codificado em base64
`audio.mimetype`	`string`	❌ Não	Tipo MIME do áudio (ex: `audio/ogg`, `audio/mpeg`, `audio/mp4`). Se não especificado, será detectado automaticamente

{
  "success": true,
  "messageId": "3EB0XXXXXX"
}

Códigos de Status

200 - Áudio enviado com sucesso
400 - Parâmetros inválidos ou áudio corrompido
401 - Sessão não autorizada
404 - Sessão não encontrada
413 - Áudio muito grande

Exemplo de Uso

curl -X POST https://api.wappfy.com.br/api/sendVoice \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "my-session",
    "jid": "5511999999999@s.whatsapp.net",
    "audio": {
      "content": "T2dnUwACAAAAAAAAAABNcnEoAAAAABYMN3EBHFN...",
      "mimetype": "audio/ogg"
    }
  }'

// Ler arquivo e converter para base64
const fs = require('fs');
const audioBuffer = fs.readFileSync('audio.ogg');
const base64Audio = audioBuffer.toString('base64');

const response = await fetch('https://api.wappfy.com.br/api/sendVoice', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    sessionId: 'my-session',
    jid: '5511999999999@s.whatsapp.net',
    audio: {
      content: base64Audio,
      mimetype: 'audio/ogg'
    }
  })
});
const data = await response.json();
console.log(data);

import requests
import base64

# Ler arquivo e converter para base64
with open('audio.ogg', 'rb') as audio_file:
    base64_audio = base64.b64encode(audio_file.read()).decode('utf-8')

response = requests.post(
    'https://api.wappfy.com.br/api/sendVoice',
    json={
        'sessionId': 'my-session',
        'jid': '5511999999999@s.whatsapp.net',
        'audio': {
            'content': base64_audio,
            'mimetype': 'audio/ogg'
        }
    }
)
data = response.json()
print(data)

Authorizations

apikey

string

header

required

Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

Body

application/json

chatId

string

required

Identificador do chat (JID do WhatsApp)

Example:

"5511999999999@c.us"

file

object

required

Arquivo de áudio/voz (URL remota ou dados base64)

Option 1
Option 2

Show child attributes

session

string

required

Nome da sessão (instanceName)

Example:

"my-session"

reply_to

string

ID da mensagem à qual você deseja responder

Example:

null

Response

201 - application/json

The response is of type object.

Status

Início

Integrações

Autenticação

Sessões

Mensagens

Conversas

Contatos

Grupos

Etiquetas

Status

Canais

Presença

Perfil

Eventos

Descrição

Body

Parâmetros do Body

Códigos de Status

Exemplo de Uso

Authorizations

Body

Response

​Descrição

​Body

​Parâmetros do Body

​Códigos de Status

​Exemplo de Uso

Authorizations

Body

Response

Descrição

Body

Parâmetros do Body

Códigos de Status

Exemplo de Uso