Skip to main content
Prerequisites: You’ll need an active Tuner account to follow this guide. Sign up here if you haven’t already.

​
Overview

Here’s what we’ll accomplish:
1

Create Your Agent

Set up a new agent and choose your integration method.
2

Connect Your Platform

Link your voice platform or configure API access.
3

Send Your First Call

Make a test call or send sample data to verify the integration.
4

Customize Your Agent

Configure call outcomes, intents, and evaluations.
Estimated time: 5 minutes from start to finish

​
Step 1: Create Your Agent

In the sidebar, click on the Select Agent dropdown, then click Add New Agent.

​
Choose Your Integration Method

No-Code (Retell)

Connect your Retell account — Tuner receives call data automatically. ~2 min

Custom API

Use our LiveKit SDK or Pipecat SDK (~2 min), or send data via the REST API directly (~5 min).

​
Fill in Agent Details

  1. Agent Name: Give your agent a descriptive name (e.g., “Customer Support Bot”)
  2. Agent ID: Enter a unique identifier for this agent
The Agent ID must match the identifier used in your voice platform. This ensures call data sent to Tuner is correctly associated with the right agent. If your voice platform already assigns an agent ID, use that exact same ID here.
  1. Provider: Select your integration type:
    • Retell - For Retell AI integration
    • API - For custom integrations (LiveKit SDK, Pipecat SDK, or direct API calls)
  2. System Prompt: Provide a clear prompt that defines your agent’s persona and goals
You are a friendly appointment booking assistant. Your goal is to help users schedule, reschedule, or cancel appointments. Always confirm the date, time, and purpose of the appointment before finalizing. Do not discuss topics unrelated to appointment management.
  1. Click Create Agent

​
Step 2: Connect Your Platform

Choose the tab below based on your integration method:

​
Connect Your Retell Account

  1. In your agent settings, click Connect Retell
  2. Enter your Retell API Key In the Workspace Settings (found in your Retell dashboard under Settings > API Keys)
  3. Click Verify & Connect
Once connected, Tuner will automatically receive call data from your Retell agent.
For detailed instructions, see Connecting to Retell.

​
Step 3: Send Your First Call

​
Make a Test Call

With your Retell account connected, simply make a test call to your Retell agent. The call data will automatically appear in Tuner within seconds.
  1. Trigger a call to your Retell agent
  2. Complete a short conversation
  3. End the call

​
View Your Call in the Dashboard

Navigate to Call Logs in the sidebar. Your test call should appear within a few seconds. Click on it to see the full monitoring results, including:
  • Transcript with speaker labels
  • Call duration and metadata
  • Evaluation results (once configured)

​
Step 4: Customize Your Agent

Now that your integration is working, configure how Tuner monitors your calls. Navigate to Agent Settings by clicking on the gear icon next to your agent name.

​
Define Call Outcomes

Specify what “Success” and “Failure” mean for your agent. For example:
OutcomeTypeDescription
Appointment BookedSuccessUser successfully scheduled an appointment
User Hung UpFailureUser ended the call before completing their goal
Transferred to HumanNeutralCall was escalated to a human agent

​
Set Up User Intents

Define the possible reasons users might call your agent:
  • Schedule Appointment
  • Reschedule Appointment
  • Cancel Appointment
  • General Inquiry

​
Create Custom Evaluations

Add specific checks to evaluate agent behavior on every call. For example:
  • “Did the agent confirm the appointment details?”
  • “Did the agent offer alternative times if the requested slot was unavailable?”

​
Configure Alerts

Set up real-time notifications to get alerted when critical issues occur:
  • Email alerts for failed calls
  • Slack notifications for evaluation failures
For a complete guide on configuring your agent, see Configuring Your Agent.

​
🎉 Congratulations!

You’ve successfully integrated your voice AI with Tuner! Here’s what you’ve accomplished: ✅ Created your first agent ✅ Connected your voice platform ✅ Sent your first call ✅ Learned how to customize your agent settings

​
What’s Next?

Now that your integration is complete, explore these resources to get the most out of Tuner:

Connecting to Retell

Detailed guide for Retell integration.

Connecting to LiveKit

SDK integration for LiveKit Agents.

Connecting to Pipecat

SDK integration for Pipecat Flows.

Custom Integration Guide

Deep dive into API integration options.

Classifying Calls

Set up call outcomes and user intents.

Best Practices

Tips for effective agent monitoring.