Manage ElevenLabs agents

​

What ElevenLabs agents are in Knotie AI

ElevenLabs is a fully supported voice AI provider in Knotie AI Pro. In the Partner Portal you can:

• Import agents from your ElevenLabs account
• Edit agent settings — system prompt, voice, LLM model, language, and more
• Attach knowledge bases so agents can answer customer-specific questions
• Configure function calls to connect agents to external tools via webhooks
• Assign agents to customers with a profit multiplier
• Manage your ElevenLabs API key directly from the portal

​

Prerequisites

Before managing ElevenLabs agents you need:

1. An ElevenLabs account with at least one agent created there.
2. An ElevenLabs API key added under Partner Portal → Settings → Partner API Keys → Platform API tab.

​

Where to find it

1. Open Partner Portal → AI Agents.
2. Under the Voice Agents group, click ElevenLabs.

You land on the ElevenLabs Agents page at /partner/ai-agents/elevenlabs.

​

Import agents

1. Click Import Agents.
2. The import modal fetches your agents from ElevenLabs using your stored API key.
3. Select the agents you want to import and confirm.
4. After import the list updates automatically.

​

Configure an agent

Click the settings (or edit) icon on any agent to open the agent modal. The modal has five tabs:

​

Customer tab

Assign the agent to one of your customers:

1. Search for or select a Customer from the dropdown.
2. Set a Profit Multiplier (markup on ElevenLabs costs).

If no customers appear, onboard a customer first under Customers.

​

Knowledge Base tab

Attach knowledge base documents so the agent can reference customer-specific content during calls:

1. After selecting a customer, available knowledge bases for that customer appear.
2. Toggle the bases you want to attach.

​

Basic Settings tab

Configure the agent’s core behaviour:

​

Advanced Settings tab

​

Function Calls tab

Connect the agent to external tools (CRMs, booking systems, etc.) via webhook:

1. Click Add Function Call.
2. Select the tool from the available list.
3. Give it a custom name and description — ElevenLabs uses these to know when to invoke the tool.
4. Save the agent — function calls are synced to ElevenLabs automatically.

​

Manage your API key

The API key used to communicate with ElevenLabs is stored encrypted in the portal. To update or re-verify it:

1. Open the agent’s three-dot menu (⋮) — the API Key action lives in the per-agent menu, not as a page-level button. Choose API Key from the menu.
2. Enter your new ElevenLabs API key.
3. The portal verifies the key and shows one of three statuses:
   • ✅ Valid — key is active and verified.
   • ❌ Invalid — key was rejected by ElevenLabs.
   • ⚠️ Error — verification failed (check your network or ElevenLabs status).
4. The last-verified timestamp is shown so you can tell when the key was last checked.

​

Webhooks & analytics

To capture accurate per-call usage and billing data, enable the ElevenLabs webhook:

1. Open the agent’s Webhook settings.
2. Copy the generated webhook URL.
3. Paste it into your ElevenLabs agent’s webhook configuration.

Once active, call duration and credit consumption are tracked under Agent Analytics.

​

Assign to a customer (quick path)

If you only need to assign an agent without changing other settings:

1. Open the agent’s action menu (⋮).
2. Choose Assign to Customer.
3. Select the customer and profit multiplier.
4. Save.

​

Troubleshooting