> ## Documentation Index
> Fetch the complete documentation index at: https://help.messagesync.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Text-to-Speech (Audio Generation) with ElevenLabs

## What It Does[​](#what-it-does "Direct link to What It Does")

The **Text-to-Speech** feature automatically converts text messages into natural-sounding voice notes that are sent as WhatsApp audio messages inside your CRM conversations using **ElevenLabs API**. This allows you to **send voice messages from automation workflows** - no need to record audio manually.

You can choose from a wide variety of AI voices and even clone custom voices using ElevenLabs. It's perfect for creating personalized audio responses at scale.

***

## How to Activate Text-to-Speech[​](#how-to-activate-text-to-speech "Direct link to How to Activate Text-to-Speech")

### Steps:[​](#steps "Direct link to Steps:")

<Steps>
  <Step>
    Go to you locations and look for **WhatsApp menu item** in the sidebar.
  </Step>

  <Step>
    Once you click on WhatsApp menu item, Go to **Settings**.
  </Step>

  <Step>
    Scroll down to the **Text-to-Speech (Audio Generation)** section.
  </Step>

  <Step>
    Enter your **ElevenLabs API Key** and Toggle **Enable Text-to-Speech** and click **Save**.
  </Step>
</Steps>

***

## How to Use Text-to-Speech[​](#how-to-use-text-to-speech "Direct link to How to Use Text-to-Speech")

To send a voice note, use this format in any WhatsApp message field (manual messages, workflows, or automations):

### Message Format:[​](#message-format "Direct link to Message Format:")

```text theme={null}
[AUDIO] [voice_id] Your text message here
```

### Example:[​](#example "Direct link to Example:")

```text theme={null}
[AUDIO] [XrExE9yKIg1WjnnlVkGX] In the ancient land of Eldoria, where skies shimmered and forests whispered secrets to the wind, lived a dragon named Zephyros.
```

### Format Breakdown:[​](#format-breakdown "Direct link to Format Breakdown:")

* `[AUDIO]` - Trigger keyword (required)
* `[voice_id]` - Your ElevenLabs Voice ID (required)
* Text after the voice ID - The message that will be converted to speech

### Where You Can Use It:[​](#where-you-can-use-it "Direct link to Where You Can Use It:")

* Manual messages in conversations
* Automated workflow responses
* Trigger-based messages
* Scheduled broadcasts
* Custom values and variables

### Using Variables:[​](#using-variables "Direct link to Using Variables:")

You can also combine it with custom fields:

```text theme={null}
[AUDIO] [XrExE9yKIg1WjnnlVkGX] Hi \{\{contact.first_name\}\}, your appointment is confirmed for \{\{contact.appointment_date\}\}.
```

***

## How to Get Your ElevenLabs API Key[​](#how-to-get-your-elevenlabs-api-key "Direct link to How to Get Your ElevenLabs API Key")

<Steps>
  <Step>
    Go to [ElevenLabs](https://elevenlabs.io/).
  </Step>

  <Step>
    Log in or create an account.
  </Step>

  <Step>
    Navigate to your [Profile Settings](https://elevenlabs.io/app/settings/api-keys).
  </Step>

  <Step>
    Click **Create API Key**.
  </Step>

  <Step title="Important">
    When creating the API key, make sure to enable these permissions:

    * **Text-to-Speech**
    * **Voices** (to access voice library)
  </Step>

  <Step>
    Copy the generated key.
  </Step>

  <Step>
    Paste it into the **Text-to-Speech** settings.
  </Step>
</Steps>

<Warning>
  Make sure to enable **Text-to-Speech** and **Voices** permissions when creating your ElevenLabs API key, otherwise the feature won't work.
</Warning>

***

## How to Find Voice IDs[​](#how-to-find-voice-ids "Direct link to How to Find Voice IDs")

Every voice in ElevenLabs has a unique Voice ID that you'll need to use in your messages.

### Steps to Get a Voice ID:[​](#steps-to-get-a-voice-id "Direct link to Steps to Get a Voice ID:")

<Steps>
  <Step>
    Go to your [ElevenLabs Dashboard](https://elevenlabs.io/app/voice-library).
  </Step>

  <Step>
    Browse the **Voice Library** or use your custom cloned voices.
  </Step>

  <Step>
    Click on any voice you want to use.
  </Step>

  <Step>
    Copy the **Voice ID** (it looks like: `XrExE9yKIg1WjnnlVkGX`).
  </Step>

  <Step>
    Use this Voice ID in your message format (see below).
  </Step>
</Steps>

<Check>
  ElevenLabs offers hundreds of pre-made voices in multiple languages. You can also clone your own voice for brand consistency.
</Check>

***

## FAQs[​](#faqs "Direct link to FAQs")

<AccordionGroup>
  <Accordion title="Does this consume a lot of ElevenLabs credits?">
    Usage depends on the length of your text. ElevenLabs charges based on characters converted. The free plan includes a limited number of characters per month, while paid plans offer higher limits.
  </Accordion>

  <Accordion title="Can I use this in automation workflows?">
    Yes! You can use the \[AUDIO] \[voice\_id] format in any message field within workflows, triggers, or automations.
  </Accordion>

  <Accordion title="Can I use my own cloned voice?">
    Yes. If you have created a custom voice clone in ElevenLabs, simply copy that voice's ID and use it in the message format.
  </Accordion>

  <Accordion title="Do I need a paid ElevenLabs account?">
    No, the feature works with both free and paid ElevenLabs accounts. However, paid plans offer more characters and faster processing.
  </Accordion>

  <Accordion title="What happens if I use the wrong Voice ID?">
    If the Voice ID is invalid or not accessible with your API key, the message will fail to send or send as text instead.
  </Accordion>

  <Accordion title="Can I use different voices for different messages?">
    Yes! Simply use different Voice IDs for each message. You can switch voices as needed.
  </Accordion>

  <Accordion title="What languages are supported?">
    ElevenLabs supports multiple languages. Check the ElevenLabs Voice Library for available languages and voices.
  </Accordion>

  <Accordion title="Is there a limit to message length?">
    WhatsApp voice notes have a practical limit. We recommend keeping messages under 2-3 minutes (approximately 300-450 words) for best results.
  </Accordion>
</AccordionGroup>

***

## Support[​](#support "Direct link to Support")

If you need help with the setup or onboarding:

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)