#how to use the whatsapp integration in elevenlabs
1 messages · Page 1 of 1 (latest)
Here’s exactly how to use ElevenLabs’ WhatsApp integration, per the official docs.
Prerequisites
- A WhatsApp Business account and number managed in WhatsApp Manager. Enable voice calls there, and add a payment method if you want to place outbound calls. (elevenlabs.io)
Connect WhatsApp to an Agent
- In the Agents console, open Deploy > WhatsApp and click Import account.
- Authorize ElevenLabs to manage the WhatsApp account.
- Assign an agent to the imported account. If you don’t assign an agent, inbound messages will be ignored and inbound calls will be rejected (you can still place outbound calls). (elevenlabs.io)
Use it: Text and Calls
- Text conversations: Send a message to your WhatsApp business number; the assigned agent replies. Conversations end via the End conversation system tool (if enabled) or after Max conversation duration. Currently there’s no user-side indication when a timeout ends the chat. (elevenlabs.io)
- Inbound calls: Call the WhatsApp business number; the agent answers. You can also send texts during a call and they’re incorporated into the conversation. (elevenlabs.io)
- Outbound calls (UI): Create a WhatsApp message template in WhatsApp Manager that includes a call-permission request. In the WhatsApp page, click Outbound call, choose the agent, provide the WhatsApp user ID, and select the permission template; ElevenLabs automatically sends the permission request if needed and places the call once approved. You can also schedule multiple calls using batch calling. (elevenlabs.io)
Use it: Outbound calls via API
- Endpoint: POST /v1/convai/whatsapp/outbound-call
- Required fields: whatsapp_phone_number_id, whatsapp_user_id, whatsapp_call_permission_request_template_name, whatsapp_call_permission_request_template_language_code, agent_id.
- Returns success, message, and conversation_id on 200. (elevenlabs.io)
Personalize conversations
- The platform sets dynamic variables you can use in tools or a conversation initiation webhook:
- {{system__caller_id}} (WhatsApp user ID)
- {{system__called_number}} (your WhatsApp phone number ID)
You can copy your WhatsApp phone number ID from the WhatsApp page in the console. (elevenlabs.io)
Pricing and limits
- Meta charges for outbound calls and call-permission requests sent outside the Customer Service Window; outbound calls won’t work until a payment method is added in WhatsApp Manager. (elevenlabs.io)
- Zero-Retention Mode: messages are ignored and outbound calls are disallowed for WhatsApp. (elevenlabs.io)
Announcement/overview
- ElevenLabs’ blog post summarizes the WhatsApp channel support and points to the setup docs. (elevenlabs.io)
Docs to follow
- WhatsApp integration guide (setup, text, inbound/outbound calls, personalization, limits). (elevenlabs.io)
- Outbound call API reference (parameters and response). (elevenlabs.io)
- Product announcement (context). (elevenlabs.io)
If you
how can i assign a conversation agent using elevenlabs to it
Here’s how to assign an ElevenLabs Agent to your WhatsApp Business account:
- In the Agents console, go to Deploy > WhatsApp, import your WhatsApp Business account, and complete the Meta authorization. After import, you’ll land on the account’s settings page where you can assign an agent to that WhatsApp account. (elevenlabs.io)
- If no agent is assigned, inbound WhatsApp messages will be ignored and inbound calls rejected; outbound calls are still possible. (elevenlabs.io)
- For outbound calls, you can also pick the agent per call from the Outbound call dialog after selecting your WhatsApp account. (elevenlabs.io)
- Optional: personalize by using the dynamic variables system__caller_id and system__called_number (set automatically for WhatsApp) in tools or a conversation initiation webhook. (elevenlabs.io)
For a quick overview of WhatsApp channel support in Agents, see the product announcement. (elevenlabs.io)
Sources:
WhatsApp | ElevenLabs Documentation
WhatsApp | ElevenLabs Documentation
WhatsApp | ElevenLabs Documentation
WhatsApp | ElevenLabs Documentation
ElevenLabs - ElevenLabs Agents now support WhatsApp
no like conversation thru message/text
Got it — if you want text-only conversations (no calls), you have two supported options:
-
WhatsApp channel (business account)
- Import your WhatsApp Business account in Agents > WhatsApp, complete the authorization, then assign your Agent on the account’s settings page. If no agent is assigned, inbound messages are ignored. Once assigned, users can text your WhatsApp number and the Agent will reply. Conversations end via the End conversation system tool (if enabled) or when the max duration is reached; there’s currently no user-side “conversation ended” indicator. (elevenlabs.io)
-
Chat Mode (text-only agents in your own web/app UI)
- Enable Chat Mode either in the agent config (set conversation.text_only = true) or via runtime overrides. Make sure you handle the agent_response event/callback and send messages programmatically (e.g., conversation.send_user_message). Chat-only conversations use a separate pool with much higher concurrency than voice. (elevenlabs.io)
If you specifically meant carrier SMS (not WhatsApp), I can’t find an official, documented SMS channel in ElevenLabs right now. The supported text channel documented today is WhatsApp, or you can embed text chat via Chat Mode in your own UI. (elevenlabs.io)
Do you want to proceed with WhatsApp texting or an in‑app/web chat?
Sources:
WhatsApp | ElevenLabs Documentation
Chat Mode | ElevenLabs Documentation
WhatsApp | ElevenLabs Documentation
whatsapp texting