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": "+5511987654321",
    "payload": {
      "customer_name": "Maria Silva",
      "account_id": "ACC123"
    },
    "context": {
      "user_id": "user_123",
      "source": "web_app"
    },
    "delay_seconds": 0,
    "is_testing": false
  }'

const response = await fetch('https://app.talkover.ai/api/v1/agents/agent_123456/call', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer talq_your_environment_token_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5511987654321',
    payload: {
      customer_name: 'Maria Silva',
      account_id: 'ACC123'
    },
    context: {
      user_id: 'user_123',
      source: 'web_app'
    },
    delay_seconds: 0,
    is_testing: false
  })
});

const result = await response.json();

import requests

url = "https://app.talkover.ai/api/v1/agents/agent_123456/call"
headers = {
    "Authorization": "Bearer talq_your_environment_token_here",
    "Content-Type": "application/json"
}
data = {
    "to": "+5511987654321",
    "payload": {
        "customer_name": "Maria Silva",
        "account_id": "ACC123"
    },
    "context": {
        "user_id": "user_123",
        "source": "web_app"
    },
    "delay_seconds": 0,
    "is_testing": False
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

{
  "success": true,
  "data": {
    "id": "call_789012",
    "agent_id": "agent_123456",
    "to": "+5511987654321",
    "status": "initiated",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

{
  "error": {
    "code": "INVALID_PHONE_NUMBER",
    "message": "Phone number must be in international format (e.g., +5511987654321)",
    "details": {
      "field": "to",
      "value": "1234567890"
    }
  }
}

{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Invalid or missing authentication token"
  }
}

{
  "error": {
    "code": "AGENT_NOT_FOUND",
    "message": "Voice agent not found",
    "details": {
      "agent_id": "agent_999999"
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Account has insufficient credits to place this call"
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please wait before making more requests.",
    "details": {
      "retry_after": 60
    }
  }
}