LogoLogo
Become a PartnerStatus Page
  • get started
    • Welcome to 360Dialog
    • Quickstarts
      • Getting started as a partner
      • Register as a Meta Tech Provider
      • Add a WhatsApp Number
      • Set up Integrated Onboarding
      • Create a Message Template
      • Send a Message
    • Pricing & Billing
      • Payment Methods for BR: Pix & Boleto
      • Month Closing Invoice (MCI)
    • Get API Access
    • Tech Provider Program
      • Understanding the Meta Tech Provider Program
      • Becoming a Meta Tech Provider: A Step-by-Step Guide
    • Alphas and Betas
      • MM Lite Beta Program
        • Onboarding
        • MM Lite versus Cloud API
        • Sending Messages
        • Expected Errors & Programming Languages
      • Voice Message Alpha Program
  • Partner & Account Management
    • Solutions for Partners
      • Benefits for Partners
      • Partner Hub
      • WABA Management
    • Account Setup & Management
      • Prerequisites and best practices for account creation
      • Account Structure
      • Account Creation
  • Integrations & API Development
    • Webhook Events & Setup
      • Webhook Events (Partner & Messaging API)
      • Webhook Configuration & Management
    • Integration Best Practices
      • Architecture and Security
      • Best Practices for Designing Integrations
        • Design a Stable Webhook Receiving Endpoint
      • Sizing Your Environment Based on Expected Throughput
      • Design a Resilient Message Sending Service
      • Integrated Onboarding
        • Basic Integrated Onboarding
        • Custom Integrated Onboarding
        • Host Your Own Embedded Signup
      • API Key Authentication for the Partner API
  • API Reference
    • Messaging API
    • Messaging Health Status
    • Sandbox (Test API Key)
    • Differences Between Cloud API and On-Premise API for Partners
      • [will be deprecated] Messaging with On-Premise API
    • Partner API
  • WABA Management
    • Managing WABA Accounts
      • Using the Partner Hub to manage Clients and Channels
      • Using the Partner API to manage Clients and Channels
      • Partner Permission to Generate API Key
      • Checking Usage & Statistics
    • Phone Number & Hosting
      • Migrating a Phone Number
        • Migrate number from Meta or alternate BSP to 360Dialog
        • Migrate a phone number to a new WABA
        • Migrate a phone number to a new WABA to change messaging Currency
      • WhatsApp Coexistence
        • Coexistence Onboarding
        • Coexistence Webhooks
        • Testing different messaging scenarios
      • Hosting type Change (On-premise API to Cloud API)
    • WABA Profile & Compliance
      • Display Name Guidelines
      • WABA Profile Info
      • WABA Policy Enforcement
      • Business Account Verification
    • Partner change (between 360Dialog Partners)
    • WhatsApp Flows
    • Accelerated Onboarding
    • Business Account Verification
  • Messaging
    • Sending & Receiving Messages
      • Conversations
      • Receiving messages
      • Before sending a message
    • Message Types
      • Conversational Components
      • Checklist for Message Broadcasts and Campaigns
      • Text messages
      • Interactive messages
        • Single and Multi Product Messages
        • Location Request Messages
        • Address Messages (India and Singapore only)
      • Contacts & Location Messages
    • Template Messages
      • Template Library
      • Template Elements
      • Sending Template Messages
      • Authentication Templates
        • Zero-Tap Authentication Templates
        • One-Tap Autofill Authentication Templates
        • Copy Code Authentication Templates
      • Catalog Templates
      • Product Card Carousel Templates
      • Single-Product Message Templates
      • Coupon Code Templates
      • Limited-Time Offer Templates
      • Multi-Product Templates
    • Media Messages
      • Upload, retrieve or delete media
    • Messaging Health & Troubleshooting
      • Messaging Limits & Quality Rating
      • Errors While Messaging
      • Messages statuses
  • Commerce & Payments
    • Payments (India Only)
      • Receive WhatsApp Payments via Payments Gateway
      • Receive WhatsApp Payments via Payment Links
      • Order Details Template Message
    • Payments (Singapore Only)
      • Receive WhatsApp Payments via Stripe
    • Payments API Brazil
      • Implementation
    • Products and Catalogs
      • India Businesses: Compliance for Commerce
  • Support & Updates
    • Help & Troubleshooting
      • FAQ
      • Error Code Reference
      • User Support Documentation
        • Tutorials
          • Page How to Troubleshoot Login Issues in the 360dialog Hub
          • How to Report an Issue
          • How to Contact Support
        • How-To Guides
          • Raise a Support Request
          • Requesting a Status Update for Business Verification
        • Reference
          • Troubleshooting Embedded Signup Issues
          • Commerce Policy Checks for WhatsApp API Access
          • Support Availability & SLAs
          • Incident Issue Prioritization
          • Case Types Table
        • Explanation
          • Why Business Verification Takes Time
          • Why Some Issues Are Not Emergencies
          • Understanding the Support Process
      • Support with Meta
    • Imprint & Data Privacy
    • Product Updates & News
      • How to ensure your Template Messages will be received
      • Integrated Onboarding new look and Campaigns Best Practices
Powered by GitBook
On this page
  • What is Voice Message?
  • Why Join?
  • Submit your participation
  • How to Implement
  • In practice
  • Examples:
  • Generating Media ID
  • Restrictions
  • Timeline

Was this helpful?

  1. get started
  2. Alphas and Betas

Voice Message Alpha Program

This program aims to allow Partners to test a feature still in development.

PreviousExpected Errors & Programming LanguagesNextSolutions for Partners

Last updated 14 days ago

Was this helpful?

What is Voice Message?

Cloud API Voice Messages is an Alpha feature (meaning in the early testing stage) that allows businesses to send native voice messages on WhatsApp — similar to how users already exchange audio in everyday conversations. Unlike traditional audio files, voice messages are automatically downloaded, transcribed, and displayed in the familiar WhatsApp voice note format, creating a more authentic, accessible, and seamless experience for end users.

Compared to standard audio media, this format:

  • Feels more native and familiar to users.

  • Enables advanced playback controls (speed control, waveform view).

  • Allows automatic transcription.

  • Improves accessibility for users with low literacy or disabilities.

Why Join?

By participating in the Alpha program, you can:

✅ Create more human, accessible experiences Reach users in a format they’re used to — especially those with low tech literacy, visual impairments, or complex language contexts.

✅ Enhance engagement and comprehension Voice messages allow businesses to share richer information that may be hard to convey through text, while letting users multitask.

✅ Stand out with a preferred message format Voice messages are one of the most used formats on WhatsApp — now available for business messaging with a native look and feel.

✅ Leverage extra features Enjoy auto-download, transcription, and playback features that aren’t available in traditional audio messages.

✅ No extra costs Voice Messages do not generate any additional costs. They replace the current audio file experience in a Service conversation, offering a more native and accessible format for end users.

Submit your participation

Ensure the best experience for your clients by joining the Alpha program. Just send an email to betas@360dialog.com to get started!

How to Implement

Implementation is simple and ideal for clients already using the Cloud API:

1

Access to the Alpha (Allowlist)

We will submit your clients to the allowlist.

2

Send messages using the same Cloud API payload,

but now with the specific parameters for voice message.

3

Start sending native voice messages,

displayed just like a personal voice note on WhatsApp.

In practice

Transcription requirements

Supported Media Types

At the moment, only audio/ogg (with OPUS codec only) supports native voice messages. For all other formats, the voice flag will be ignored and a regular audio message will be delivered instead.

Payload Difference

Sending a voice message works similarly to sending a regular audio file, with one key difference: you must include a new boolean field called voice in your payload.

To send a native voice message, set the voice parameter to true. If this parameter is omitted or set to false, the message will be delivered as a standard audio message.

Examples:

Voice message using Media ID:

curl --location 'https://waba-v2.360dialog.io/messages' \
--header 'Content-Type: application/json' \
--header 'D360-API-KEY: {{YOUR-D360-API-KEY}}' \
--data '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{recipient-phone-number}}",
  "type": "audio",
  "audio": {
    "id": "{{previously-uploaded-media-id}}",
      "voice": true
  }
}'

Voice message using URL:

curl --location 'https://waba-v2.360dialog.io/messages' \
--header 'Content-Type: application/json' \
--header 'D360-API-KEY: {{YOUR-D360-API-KEY}}' \
--data '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{recipient-phone-number}}",
  "type": "audio",
  "audio": {
    "link": "link-to-opus-file",
      "voice": true
  }
}'

Generating Media ID

Restrictions

  • Currently in Alpha: we recommend a gradual rollout.

  • Feature still evolving: expect updates and required feedback loops.

  • Available for all regions.

Timeline

Phase

Status

Allowlist

✅ Ongoing

Onboarding

✅ Ongoing

Sending

✅ Ongoing

Feedback Collection

✅ Ongoing

Beta Launch

TBC

For the voice transcription to work, the end user must have the relevant . Otherwise, the message will appear as a regular audio note.

Please refer to to learn how to generate a media ID before sending your message.

WhatsApp settings enabled
this documentation
Cover

Current Cloud API experience

Cover

New Voice Message Feature (in Alpha)