Our Advanced AI Conversations feature uses Deepseek v3 to provide multi-turn, context-aware dialogues. It:
Maintains session context across calls and messages.
Supports a configurable system prompt for brand- or compliance-specific behavior.
Persists full conversation transcripts and audio recordings to your dashboard for review and auditing.
Can hand off to human operators or trigger follow-up calls automatically based on rules.
Technical details
Conversations are stored in the application's SQLite database (instance/aicall.db) as Conversation records.
The backend calls Deepseek via a server-side API wrapper (services/ai_service.py) and uses the stored system prompt
and conversation history to generate responses. You can configure Deepseek API keys on the Dashboard.
Privacy & compliance
Audio and transcripts are saved to the app instance under static/recordings and the DB. Ensure you have the appropriate consent for recording calls in your jurisdiction.
Crystal Clear Voice (11labs)
11labs provides high-fidelity TTS used for outbound calls and follow-ups. Feature highlights:
Multiple selectable voice models (configure on Dashboard).
Supports SSML-like input and fast generation for low-latency calls.
Fallback to Twilio TTS available when ElevenLabs keys are not supplied or rate-limited.
Generated audio files are stored in static/tts and served to Twilio for playback.
Integration notes
To use ElevenLabs, supply your API key on the Dashboard. The server calls ElevenLabs' text-to-speech endpoint,
saves the returned audio bytes, and provides Twilio with a public URL so calls can play the file. If ElevenLabs
returns an auth or quota error, the app logs diagnostics and will try Twilio's TTS.
Best practices
Use a paid ElevenLabs key for production to avoid usage limits.
Pre-generate frequently used prompts to minimize latency during calls.
Reliable Communication (Twilio)
Twilio enables voice and programmable call flows. Key capabilities:
Programmable outbound calls with recording and status callbacks.
Recording retrieval for transcription workflows (OpenAI Whisper or other STT).
Supports follow-up calls based on callee responses and AI decisions.
Phone number management, authentication via Account SID and Auth Token configured on Dashboard.
Troubleshooting common issues
If you see "Authenticate" errors from Twilio, verify the Account SID, Auth Token, and Twilio phone number
in your Dashboard. Ensure the credentials belong to the same Twilio account that owns the phone number.
Security
Store Twilio credentials securely and rotate them periodically. The app reads credentials from the DB when handling webhooks and making API calls.