← Back to Dashboard

Setup Guide

Connect your phone number and go live in under 10 minutes.

1

Get a Twilio Phone Number

If you don't already have one, create a Twilio account and purchase a voice-enabled phone number. Any US number works.

twilio.com
2

Point Your Twilio Number to Axon

In your Twilio console, go to your phone number → Voice & Fax → "A call comes in" webhook. Set it to:

https://axon-ai-6.polsia.app/api/receptionist/webhook

Set the HTTP method to POST. Twilio will forward every inbound call here.

3

Add Your OpenAI API Key

Axon uses OpenAI's Realtime API to handle voice conversations. Set your key as an environment variable:

OPENAI_API_KEY=sk-...

This must be set in your hosting environment. On Render, add it under Environment → Environment Variables.

4

Add Appointment Slots

Before your AI can book appointments, add available time slots. Click "Seed Demo Data" on the dashboard to load sample slots, or add them manually using the + Add Slot button.

5

Train the AI with Your Knowledge Base

Add Q&A entries so the AI can answer common questions (hours, services, pricing). Use the API:

POST /api/knowledge
{ "question": "What are your hours?", "answer": "We're open Mon–Fri, 9am–5pm.", "category": "hours" }

Test It

Call your Twilio number from a different phone. The AI should answer, greet the caller, and offer to book an appointment or answer questions from your knowledge base.

Required Environment Variables

OPENAI_API_KEYYour OpenAI API key (required for voice AI)
TWILIO_ACCOUNT_SIDTwilio account ID (required for SMS confirmations)
TWILIO_AUTH_TOKENTwilio auth token (required for SMS confirmations)
TWILIO_PHONE_NUMBERYour Twilio phone number (for sending SMS)
BASE_URLPublic URL of your app (auto-detected if not set)

Webhook URL (step 2)

https://axon-ai-6.polsia.app/api/receptionist/webhook