Error Handling

{
  "error": "Brief error description",
  "success": false,
  "powered_by": "Teli"
}

{
  "error": "API key is required",
  "success": false
}

{
  "error": "Invalid API key",
  "success": false
}

{
  "error": "agent_name, organization_id, and user_id are required",
  "success": false
}

{
  "error": "agent_type must be 'sms' or 'voice'",
  "success": false
}

{
  "error": "voice_id is required for voice agents",
  "success": false
}

{
  "error": "Failed to create voice AI configuration",
  "success": false
}

{
  "error": "Failed to store voice agent",
  "success": false
}

{
  "error": "organization_id required",
  "success": false
}

{
  "error": "Failed to list agents",
  "success": false
}

{
  "error": "Agent not found",
  "success": false
}

{
  "error": "Failed to get agent - agent may not exist",
  "success": false
}

{
  "error": "Agent not found",
  "success": false
}

{
  "error": "Failed to update agent - please check your data",
  "success": false
}

{
  "error": "Failed to delete agent - agent may not exist",
  "success": false
}

{
  "error": "leads array required",
  "success": false
}

{
  "error": "voice_agent_id required",
  "success": false
}

{
  "error": "agent_outbound_number required",
  "success": false
}

{
  "error": "Failed to start voice campaign",
  "success": false
}

{
  "error": "organization_id required",
  "success": false
}

{
  "error": "Failed to list voice campaigns",
  "success": false
}

{
  "error": "Failed to delete voice campaign",
  "success": false
}

{
  "error": "campaign_name and sms_agent_id required",
  "success": false
}

{
  "error": "SMS not enabled for organization",
  "success": false
}

{
  "error": "Failed to create campaign",
  "success": false
}

{
  "error": "user_id required",
  "success": false
}

{
  "error": "Failed to delete campaign",
  "success": false
}

{
  "error": "area_code and user_id required",
  "success": false
}

{
  "error": "Failed to provision phone number",
  "success": false
}

{
  "error": "Invalid area code or no numbers available in this area",
  "success": false
}

{
  "error": "agent_id or outbound_agent_id required",
  "success": false
}

{
  "error": "Failed to update phone number agent",
  "success": false
}

{
  "error": "Agent not found or invalid agent ID",
  "success": false
}

{
  "error": "Failed to list phone numbers",
  "success": false
}

{
  "error": "organization_id required",
  "success": false
}

{
  "error": "Failed to list calls",
  "success": false
}

{
  "error": "Call not found",
  "success": false
}

{
  "error": "Failed to get call details",
  "success": false
}

{
  "error": "organization_name required",
  "success": false
}

{
  "error": "Failed to create organization",
  "success": false
}

{
  "error": "Failed to list organizations",
  "success": false
}

{
  "error": "Organization not found",
  "success": false
}

{
  "error": "email and name required",
  "success": false
}

{
  "error": "Failed to create user",
  "success": false
}

{
  "error": "Failed to list users",
  "success": false
}

{
  "error": "organization_id and leads required",
  "success": false
}

{
  "error": "Failed to create contact list",
  "success": false
}

{
  "error": "Failed to list contacts",
  "success": false
}

{
  "error": "brandName and organization_id required",
  "success": false
}

{
  "error": "Failed to register brand",
  "success": false
}

{
  "error": "brandId and campaign details required",
  "success": false
}

{
  "error": "Failed to register campaign",
  "success": false
}

{
  "error": "phone_number required",
  "success": false
}

{
  "error": "Failed to add to DNC list",
  "success": false
}

{
  "error": "phone_number required",
  "success": false
}

{
  "error": "Failed to remove from DNC list",
  "success": false
}

if (response.success) {
  // Handle success
} else {
  // Handle error
  console.error(response.error)
}

async function apiCallWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options)
      const data = await response.json()
      if (data.success) return data
      if (response.status < 500) throw new Error(data.error)
      // Retry on 500 errors
      await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000))
    } catch (e) {
      if (i === maxRetries - 1) throw e
    }
  }
}

if (!response.success) {
  console.error('API Error:', {
    endpoint: '/v1/agents',
    error: response.error,
    timestamp: new Date().toISOString()
  })
}

const errorMessages = {
  'Failed to create agent': 'Could not create agent. Please check your configuration.',
  'organization_id required': 'Please select an organization first.',
  'Invalid API key': 'Your session has expired. Please log in again.'
}

const userMessage = errorMessages[response.error] || response.error