Configuration

Runtime settings

Edit `.env`, or run `python -m frontdeskagent.setup_wizard`, then restart the service.

BusinessPrime Properties Dubai

Typeproperty

LLM backendollama

Ollama modelqwen2.5:3b

Database./data/frontdeskagent.sqlite

OpenZero webhooknot set

SMTPnot set

Admin authoff

SMS providernone

Outbound callsnot set

Voice outputnone

Voiceboxnot configured

CRM webhooknot set

Booking webhooknot set

Calendar feedset

Public URLhttps://agent.zuvi8.com

Twilio signaturesnot active

Webhook test

curl -X POST http://localhost:8088/api/webhook/call \
  -H "Content-Type: application/json" \
  -d '{"name":"Test Caller","phone":"+441234567890","transcript":"Need an urgent appointment today"}'

Voicebox test

curl -X POST http://localhost:8088/api/voice/speak \
  -H "Content-Type: application/json" \
  -H "X-FrontDeskAgent-Secret: your-shared-secret" \
  -d '{"text":"FrontDeskAgent voice test complete.","profile_id":""}'

Set `VOICE_TTS_PROVIDER=voicebox` and run Voicebox locally to use open-source voice output for staff alerts and agent speech.

Beginner setup

python -m frontdeskagent.setup_wizard

The wizard creates `.env`, generates safe secrets, and prints the webhook URLs to paste into Twilio, n8n, Zapier, Make, or OpenZero.