Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Quick start Guide

Get started with Talkover AI Voice Agent platform in just 5 minutes. This guide will walk you through setting up your first voice agent and making your first call.

​
Prerequisites

  • A Talkover account (sign up at app.talkover.ai)
  • A phone number for testing
  • Basic knowledge of HTTP requests

​
Step 1: Get Your Environment Token

Your environment token is your API key for authenticating requests to the Talkover API.

​
How to Get Your Token:

  1. Log in to your Talkover dashboard at app.talkover.ai
  2. Navigate to Account → Environments
  3. Copy your Environment Token from the list (it starts with talq_)
Keep your environment token secure and never share it publicly. Treat it like a password.

​
Step 2: Create Your First Voice Agent

Voice agents are the AI personalities that handle your calls. You need to create one before making calls.

​
How to Create a Voice Agent:

  1. Go to Voice Agents in your dashboard
  2. Click “Create New Agent”
  3. Configure your agent:
    • Name: Give your agent a descriptive name (e.g., “Customer Service Agent”)
    • Voice: Choose a voice personality
    • Language: Select the language for conversations
    • Call Flow: Design how your agent should handle conversations
  4. Save your agent
  5. Copy the Agent ID (you’ll need this for API calls)
Start with a simple call flow for testing. You can make it more complex later.

​
Step 3: Make Your First Call

Now you’re ready to make your first call using the Talkover API!

​
API Endpoints

​
Individual Agent Call

POST /api/v1/agents/{agent_id}/call

​
Campaign Call

POST /api/v1/campaigns/{campaign_id}/call

​
Example Requests

​
Agent Call

curl -X POST "https://app.talkover.ai/api/v1/agents/agent_123456/call" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1234567890"
  }'

​
Campaign Call

curl -X POST "https://app.talkover.ai/api/v1/campaigns/campaign_789012/call" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1234567890",
    "payload": {
      "customer_name": "John Doe",
      "customer_id": "12345"
    }
  }'

​
Example Response

{
  "call_id": "call_789012",
  "agent_id": "agent_123456",
  "to": "+1234567890",
  "status": "initiated",
  "created_at": "2024-01-15T10:30:00Z",
  "estimated_duration": 120
}

​
Step 4: Monitor Your Call

After initiating a call, you can:
  1. Check call status in your dashboard
  2. Listen to call recordings (if enabled)
  3. View call transcripts (if enabled)
  4. Monitor call analytics

​
What’s Next?

Congratulations! You’ve successfully set up Talkover and made your first AI-powered call.