Skip to main content
If you’ve built a voice agent with ElevenLabs, you can connect it to Wassist to handle WhatsApp voice messages. Users send voice notes, and your agent responds with natural-sounding audio.

​
What You Get

An ElevenLabs-connected agent provides:
  • Voice message handling — Transcribe incoming voice notes automatically
  • Voice responses — Respond with high-quality synthesized audio
  • Your ElevenLabs agent — Use your existing agent’s personality and knowledge
  • Seamless fallback — Text responses when voice isn’t appropriate

​
Prerequisites

Before you begin:
  • An ElevenLabs account with API access
  • An existing ElevenLabs Conversational AI agent
  • Your ElevenLabs API key
  • A Wassist account (sign up free)

​
Step-by-Step Guide

1

Connect ElevenLabs Integration

First, connect your ElevenLabs account to Wassist:
  1. Go to Settings → Integrations in your Wassist dashboard
  2. Click Add Integration → ElevenLabs
  3. Enter a name for this integration (e.g., “My ElevenLabs Account”)
  4. Paste your ElevenLabs API key
  5. Click Connect
Find your API key at elevenlabs.io/app/settings/api-keys
2

Create New Agent

From your dashboard, click New Agent and select Connect ElevenLabs.
3

Select Your ElevenLabs Agent

Choose which ElevenLabs agent to connect:
  • Select your integration from the dropdown
  • Browse your available ElevenLabs agents
  • Click on the agent you want to use
4

Configure Voice Settings

Customize how voice is handled on WhatsApp:
  • Voice Response Mode — Always respond with voice, or only when user sends voice
  • Transcription Display — Show text transcription alongside audio
  • Fallback Behavior — How to handle when voice generation fails
5

Review and Create

Review your agent configuration and click Create Agent.

​
How Voice Messaging Works

​
Voice Response Options

Every response from your agent is delivered as a voice message, regardless of whether the user sent text or voice.Best for: Hands-free experiences, accessibility, conversational agents
Respond with voice only when the user sends a voice message. Text messages get text responses.Best for: Flexible interactions where users choose their preferred mode
Send both a text transcription and a voice message for every response.Best for: Situations where users might want to read and listen

​
Managing Your ElevenLabs Integration

​
Viewing Connected Agents

Go to Settings → Integrations → ElevenLabs to see:
  • All connected ElevenLabs agents
  • Usage statistics
  • Connection status

​
Updating the Integration

If you need to update your API key:
  1. Go to Settings → Integrations
  2. Click on your ElevenLabs integration
  3. Update the API key
  4. Click Save

​
Monitoring Usage

ElevenLabs usage (character count for synthesis) is billed through your ElevenLabs account. Monitor your usage at elevenlabs.io/app/usage.
Voice synthesis consumes ElevenLabs credits based on character count. For high-volume agents, ensure your ElevenLabs plan supports the expected usage.

​
Best Practices

Keep Responses Concise

Voice messages should be shorter than text. Aim for responses under 30 seconds.

Use Clear Speech

Choose an ElevenLabs voice that’s clear and easy to understand.

Handle Noisy Audio

Add instructions for when transcription might be unclear: “If you didn’t catch that, ask the user to repeat.”

Provide Text Fallback

Always have a text fallback for important information like links or codes.

​
SDK Alternative

Connect an ElevenLabs agent programmatically: 
// First, create an ElevenLabs integration
const integration = await client.integrations.elevenlabs.create({
  name: 'My ElevenLabs Account',
  apiKey: 'your-elevenlabs-api-key',
});

// List available agents
const { agents } = await client.integrations.elevenlabs.getAgents(
  integration.id
);

// Create a Wassist agent from an ElevenLabs agent
const agent = await client.onboarding.createFromElevenLabs({
  integrationId: integration.id,
  agentId: agents[0].agentId,
});

​
What’s Next

Configure Voice Settings

Fine-tune voice response behavior.

Deploy to WhatsApp

Make your voice agent live.