> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revring.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your first RevRing AI agent up and running in minutes

This guide walks you through connecting a Twilio Elastic SIP trunk, creating your first AI voice agent, and making your first test call.

## Prerequisites

Before you begin, ensure you have:

* A RevRing account with access to the [dashboard](https://dashboard.revring.ai)
* A Twilio account with Elastic SIP Trunking enabled
* At least one phone number provisioned in Twilio

## Step 1: Connect Your SIP Trunk

SIP trunks connect your AI agents to the phone network, enabling both inbound and outbound calling.

### Configure Twilio

1. Log into your [Twilio Console](https://console.twilio.com)
2. Navigate to **Elastic SIP Trunking** → **Credential Lists** and create a new Credential List with a username and password
3. Go to **Elastic SIP Trunking** → **Trunks** and create or select an existing trunk
4. In **Origination**, add an **Origination SIP URI**: `sip:sip.revring.ai`
5. In **Termination**, note your **Termination SIP URI** (e.g., `yourtrunk.pstn.twilio.com`)
6. In **Termination** → **Authentication** → **Credential Lists**, select your Credential List
7. Assign your phone numbers to the trunk in the **Numbers** tab

### Add the Trunk to RevRing

1. Navigate to [SIP Trunks](https://dashboard.revring.ai/app/sip-trunks) in your RevRing dashboard
2. Click **Add SIP Trunk**
3. Fill in the form:
   * **Name**: `Twilio Elastic` (or any descriptive name)
   * **Proxy**: Your Twilio Termination SIP URI from step 5 above (e.g., `yourtrunk.pstn.twilio.com`)
   * **Username**: Enter the username from your Twilio Credential List
   * **Password**: Enter the password from your Twilio Credential List
   * **Phone Numbers**: Enter your phone numbers in E.164 format, separated by commas (e.g., `+12025551234, +14155552671`)
4. Click **Add Trunk**

<Note>
  Phone numbers must be in E.164 format starting with `+` followed by country code and number (no spaces or dashes). For detailed Twilio setup instructions, see the [Telephony Setup](/platform/telephony) guide.
</Note>

## Step 2: Create Your First Agent

Agents are AI-powered voice assistants that handle phone conversations based on the instructions you provide.

### Create the Agent

1. Navigate to [Agents](https://dashboard.revring.ai/app/agents)
2. Click **New Agent**
3. Enter a **Name** (e.g., `Sales Assistant`)
4. Click **Create**

### Configure Agent Behavior

After creation, you'll be taken to the agent detail page with several tabs. Configure the **Overview** tab:

1. **SIP Trunk**: Select the trunk you just created
2. **Status**: Set to `Active` to enable the agent
3. **First Message**: Enter an opening greeting (optional)
   ```
   Hello! Thanks for calling. How can I help you today?
   ```
4. **Prompt**: Define how the agent should behave during calls
   ```
   You are a helpful sales assistant for Acme Corp. Your role is to:
   - Greet callers warmly
   - Answer questions about our products and services
   - Collect contact information if they want a callback
   - Transfer to a human rep if needed

   Be professional, friendly, and concise. Keep responses under 30 seconds.
   ```
5. Click **Save**

<Tip>
  The prompt is the most important field - it defines your agent's personality, knowledge, and behavior. You can use `{{variables}}` to personalize responses based on caller data.
</Tip>

### Configure Voice Settings

Switch to the **Voice** tab to customize how your agent sounds:

1. **Voice**: Select a voice that matches your brand (click play to preview)
2. Click **Save Voice**

<Tip>
  Browse all 300+ available voices in the [Voice Library](https://dashboard.revring.ai/app/agents/voices). You can filter by language and preview each voice before selecting.
</Tip>

## Step 3: Test Your Agent

The **test panel** on the right side of the agent page lets you call your agent directly from the browser — no phone required.

### Make a Test Call

1. Open your agent and look at the **test panel** on the right
2. Click the **call button** (microphone icon) to start a WebRTC call
3. Speak into your computer's microphone — you're now talking to your agent
4. Click the button again (X icon) to end the call

The **Transcript** section updates in real time as the conversation progresses. After the call ends, review the full transcript to check for errors or unexpected behavior.

<Tip>
  Expand the **Test Variables** section at the bottom of the test panel to set variable values (like `{{customer_name}}`). These are passed to your agent during test calls so you can verify personalization works correctly.
</Tip>

### Send an Outbound Test Call

To test outbound calling over the phone network (real SIP calls):

1. Navigate to [Send Call](https://dashboard.revring.ai/app/testing/send)
2. Select your **Agent**, enter a **From Number** and **To Number**
3. Click **Send Test Call**

The call will initiate within seconds. Answer your phone to speak with your agent.

### Iterate and Improve

Based on your test call:

1. Return to the **Overview** tab
2. Refine your **Prompt** to improve agent responses
3. Adjust **First Message** if needed
4. Make another test call to validate changes

## Next Steps

Now that you have a working agent, explore more advanced features:

<CardGroup cols={2}>
  <Card title="Telephony Setup" icon="phone" href="/platform/telephony">
    Learn about configuring Twilio and Telnyx for production use
  </Card>

  <Card title="Inbound Calls" icon="arrow-left-to-line" href="/platform/inbound">
    Set up phone numbers to receive inbound calls
  </Card>

  <Card title="Tools" icon="gear" href="/platform/tools">
    Enable call transfer, voicemail detection, and custom tools
  </Card>

  <Card title="Webhooks" icon="webhook" href="/platform/webhooks">
    Integrate with your systems using pre-call and post-call webhooks
  </Card>
</CardGroup>

## Common Issues

<AccordionGroup>
  <Accordion title="Test call fails to connect">
    * Verify your SIP trunk proxy address is correct
    * Ensure phone numbers are in valid E.164 format
    * Check that your Twilio trunk has the phone number assigned
    * Confirm your agent status is set to `Active`
  </Accordion>

  <Accordion title="Agent doesn't respond as expected">
    * Review and refine your prompt for clearer instructions
    * Check the transcript for specific errors
    * Ensure your prompt isn't too long or complex
    * Try different voices to find the best fit for your use case
  </Accordion>

  <Accordion title="Can't find my phone numbers">
    * Phone numbers must be added to both your telephony provider AND your RevRing SIP trunk
    * Use E.164 format: `+[country code][number]` with no spaces or special characters
    * You can edit phone numbers by clicking the menu on any trunk in the SIP Trunks list
  </Accordion>
</AccordionGroup>