API Reference

// Create a new AI agent
const response = await fetch('https://api.voxanne.ai/api/agents', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Front Desk Agent',
    voice_provider: 'elevenlabs',
    voice_id: 'rachel',
    prompt: 'You are a friendly medical receptionist...',
    tools: ['book_appointment', 'check_availability']
  })
});

const agent = await response.json();
console.log('Agent created:', agent.id);

// List recent calls with filtering
const response = await fetch('https://api.voxanne.ai/api/calls?limit=20&status=completed', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const calls = await response.json();
calls.forEach(call => {
  console.log(`Call from ${call.from}: ${call.outcome}`);
});

// Handle webhook events (Node.js/Express)
app.post('/webhooks/vapi', async (req, res) => {
  const event = req.body;

  // Verify webhook signature (recommended)
  const signature = req.headers['x-vapi-signature'];
  if (!verifySignature(event, signature)) {
    return res.status(401).send('Invalid signature');
  }

  // Process event
  switch (event.type) {
    case 'call.started':
      console.log('Call started:', event.call.id);
      break;
    case 'call.ended':
      console.log('Call ended:', event.call.id);
      await saveCallToDatabase(event.call);
      break;
    case 'appointment.booked':
      console.log('Appointment booked:', event.appointment);
      await sendConfirmationEmail(event.appointment);
      break;
  }

  res.status(200).send('OK');
});