Voice AI might sound complex, but getting started with Ring AI is surprisingly straightforward. In this tutorial, we'll walk through creating a simple voice agent that can handle appointment scheduling.

Prerequisites

Before we begin, make sure you have:

A Ring AI account (sign up free)
Your API key from the dashboard
Basic familiarity with REST APIs

Step 1: Create a Workflow

Workflows define how your voice agent behaves. Let's create a simple one that greets callers and helps them schedule appointments.

curl -X POST https://api.ringai.com/v1/workflows \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Appointment Scheduler",
    "prompt": "You are a friendly appointment scheduling assistant for a dental office. Help callers schedule, reschedule, or cancel their appointments. Available times are weekdays 9am-5pm.",
    "voice": "nova",
    "first_message": "Hi! Thanks for calling Bright Smile Dental. How can I help you today?"
  }'

This creates a workflow with a system prompt that defines your agent's personality and capabilities.

Step 2: Configure Your Voice

Ring AI supports multiple voice providers. For this tutorial, we'll use our default voice, but you can customize it:

// Available voice options
{
  "voice": "nova",        // Warm, professional female
  "voice": "atlas",       // Clear, confident male
  "voice": "aria",        // Friendly, energetic female
  "voice": "echo"         // Calm, measured male
}

Step 3: Connect a Phone Number

Now let's assign a phone number to your workflow. You can either bring your own number or provision one through Ring AI:

curl -X POST https://api.ringai.com/v1/phone-numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "area_code": "415",
    "workflow_id": "wf_abc123"
  }'

This provisions a new number in the 415 area code and connects it to your workflow.

Step 4: Test Your Agent

Before going live, test your agent using our web-based testing tool or make a test call:

curl -X POST https://api.ringai.com/v1/calls/test \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "wf_abc123",
    "test_scenario": "User wants to schedule a cleaning for next Tuesday at 2pm"
  }'

This simulates a conversation and returns the full transcript so you can review how your agent handles the scenario.

Step 5: Go Live

Once you're happy with your agent's responses, activate it:

curl -X PATCH https://api.ringai.com/v1/workflows/wf_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "active"
  }'

Your voice agent is now live and ready to take calls!

Adding Integrations

To make your agent actually book appointments, you'll want to connect it to your calendar system. Ring AI supports 500+ integrations out of the box:

curl -X POST https://api.ringai.com/v1/workflows/wf_abc123/integrations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "google_calendar",
    "credentials": {
      "access_token": "YOUR_GOOGLE_TOKEN"
    }
  }'

What's Next?

You've just built your first voice agent! Here are some ways to make it even better:

Add webhook handlers to trigger custom logic
Enable call recording for quality assurance
Set up analytics to track conversation metrics
Configure handoffs to route complex calls to humans

Check out our documentation for detailed guides on each of these features.

Questions? Reach out to us at support@ringai.com or join our Discord community.

Ring AI Team

Developer Relations

Building Your First Voice Agent in 5 Minutes