Getting Started
Connect your first AI agent to Chanl and run a test in under 5 minutes
Getting Started
Get your AI agent connected, tested, and monitored in under 5 minutes. No credit card required.
Works with all major voice and text platforms
What You'll Do
Build
Give your VAPI, Retell, or Bland agent tools, knowledge, and memory via MCP
Test
Run a realistic test scenario with AI-generated callers
Monitor
See the transcript, scorecard, and analytics from your test
Prerequisites
- A Chanl account — sign up free
- An AI voice agent on any platform (VAPI, Retell, Bland, Twilio, or custom)
- Your agent's API key or connection credentials
Step-by-Step Setup
Go to app.chanl.ai/signup and create a free account. You'll land on the dashboard.
The free tier includes 50 test simulations per month, full analytics, and unlimited scorecards.
Navigate to Build → MCP in the sidebar. Choose your platform and follow the setup wizard.
# In your VAPI dashboard, add Chanl as an MCP server
# Server URL: https://mcp.chanl.ai
# API Key: your Chanl API key from Settings → API KeysVAPI agents automatically get access to Chanl's knowledge base, memory, and tools through the MCP connection.
# In your Retell dashboard, configure the MCP endpoint
# Endpoint: https://mcp.chanl.ai
# Authentication: Bearer token from Chanl Settingscurl -X POST "https://api.chanl.ai/api/v1/agents/connect" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "custom",
"name": "My Agent",
"phoneNumber": "+1234567890"
}'Once connected, your agent appears in the Agents list on the dashboard.
Personas are the AI-generated callers that test your agent. Go to Test → Personas and create a few:
Simulate real caller behaviors

Angry Caller
Frustrated
Polite Pro
Professional
Confused User
Uncertain
VIP Client
High-value
Tech Savvy
Expert
First-Time Caller
NervousFrustrated Customer
Impatient, interrupted mid-sentence, demands escalation. Tests your agent's de-escalation skills.
Detail-Oriented Buyer
Asks follow-up questions, wants specific numbers, compares options. Tests accuracy and depth.
Or create them via API:
curl -X POST "https://api.chanl.ai/api/v1/personas" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Frustrated Customer",
"description": "Impatient caller who has been on hold too long",
"emotionalTone": "frustrated",
"speakingStyle": "interrupting"
}'A scenario combines your agent + personas + a scorecard into an automated test.
Go to Test → Scenarios → Create Scenario, then:
- Name it (e.g., "Refund Request Handling")
- Describe the situation the caller is in
- Select your personas
- Select your agent
- Choose a scorecard (use the default "Customer Service" scorecard to start)
- Click Run
Chanl will run a realistic phone conversation between each persona and your agent, then score the results.
With 3 personas and 1 agent, Chanl runs 3 separate conversations automatically and scores each one.
After simulations complete (usually 1-2 minutes), go to Observe → Analytics to see:
100 batch runs
- Overall score — how your agent performed across all test calls
- Per-persona breakdown — which customer types your agent handles well vs. poorly
- Full transcripts — read every word of every test conversation
- Scorecard results — detailed pass/fail on each evaluation criterion
If your agent scores below 70%, review the transcripts to identify common failure points before deploying to production.
What's Next?
Set Up Knowledge Base
Upload your docs, policies, and FAQs so your agent answers accurately
Create Custom Scorecards
Define your own grading criteria for agent evaluation
Enable Live Monitoring
Watch production calls in real-time and get alerts
Explore the API
Build testing and monitoring into your CI/CD pipeline