> ## 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 up and running with Talkover in 5 minutes - learn how to get your agent ID and environment token

# Quick start Guide

Get started with Talkover AI Voice Agent platform. 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](https://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](https://app.talkover.ai)
2. **Navigate to Account** → **Environments**
3. **Copy your Environment Token** from the list (it starts with `talq_`)

<Warning>
  Keep your environment token secure and never share it publicly. Treat it like a password.
</Warning>

## 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)

<Tip>
  Start with a simple call flow for testing. You can make it more complex later.
</Tip>

## 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

```bash theme={null}
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

```bash theme={null}
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

```json theme={null}
{
  "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?

* **Learn about call flows** in our [Call Flow Design Guide](/en/guides/call-flow-design)
* **Explore integration examples** in our [Integration Examples](/en/guides/integration-examples)
* **Check out our SDKs** for easier integration

<Check>
  Congratulations! You've successfully set up Talkover and made your first call.
</Check>