Skip to main content

​
Quick Start Guide

This guide will walk you through making your first AI-powered phone call with Ringyo AI.

​
Prerequisites

Before you begin, you’ll need:
  • A Ringyo account (Sign up)
  • A Pro or Agency plan for API access
  • Your API key (available in Dashboard → Developers)

​
Step 1: Get Your API Key

1

Open the Developer Section

Navigate to your Dashboard and click on Developers in the sidebar.
2

Create an API Key

Click Create Key, give it a name (e.g., “My First Key”), select the permissions you need, and click Create.
3

Copy Your Key

Your API key will only be shown once. Copy it and store it securely.
The key will look like: vb_live_ABC123xyz...

​
Step 2: Create a Voice Agent

Before making calls, you need a voice agent. You can create one in the dashboard or via API: 
curl https://api.ringyo.ai/v1/agents \
  -X POST \
  -H "Authorization: Bearer vb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sarah - Receptionist",
    "voice_id": "sarah",
    "personality": "friendly and professional",
    "greeting": "Hello! Thanks for calling. How can I help you today?"
  }'
Save the agent.id from the response — you’ll need it for making calls.

​
Step 3: Make Your First Call

Now let’s make an outbound call: 
curl https://api.ringyo.ai/v1/calls \
  -X POST \
  -H "Authorization: Bearer vb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1234567890",
    "agent_id": "YOUR_AGENT_ID",
    "context": {
      "customer_name": "John Smith",
      "purpose": "appointment reminder"
    }
  }'
Congratulations! You’ve just made your first AI-powered phone call.

​
Step 4: Listen for Events

Set up a webhook to receive real-time updates about your calls: 
curl https://api.ringyo.ai/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer vb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/webhook",
    "events": ["call.completed", "call.failed"]
  }'
When the call completes, you’ll receive a webhook like this: 
{
  "event": "call.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "call_id": "call_abc123",
    "duration_seconds": 145,
    "outcome": "appointment_booked",
    "transcript": "...",
    "extracted_data": {
      "appointment_date": "2024-01-20",
      "appointment_time": "14:00"
    }
  }
}

​
Next Steps

API Reference

Explore all available endpoints and parameters.

n8n Integration

Connect Ringyo to n8n for powerful automations.

Webhooks

Learn about all webhook events and payloads.

Voice Agents

Deep dive into agent configuration options.