Conversational AI Quickstart

import requests

response = requests.post(
    'https://dev.voice.ai/api/v1/agent/',
    headers={'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'},
    json={
        'name': 'My First Agent',
        'config': {
            'prompt': 'You are a helpful call center agent. Help customers with billing, returns, and questions.',
            'greeting': 'Thank you for calling. How can I help you?',
            'llm_model': 'gemini-2.5-flash-lite',
            'allow_interruptions': True,
            'min_interruption_words': 1,
            'auto_noise_reduction': True
        }
    }
)

agent_id = response.json()['agent_id']
print(f'Agent ID: {agent_id}')

import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}

# Pause agent to update
requests.post(f'https://dev.voice.ai/api/v1/agent/{agent_id}/pause', headers=headers)

# Update agent with phone number
requests.put(
    f'https://dev.voice.ai/api/v1/agent/{agent_id}',
    headers=headers,
    json={'config': {'phone_number': '+14155551234'}}
)

print('Phone number assigned!')

import requests

requests.post(
    f'https://dev.voice.ai/api/v1/agent/{agent_id}/deploy',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

print('Agent deployed!')