Troubleshooting

Fast Triage Order

1. Confirm service health endpoints (/api/health, /health).
2. Confirm shared secret alignment (AUTH__SECRET_KEY).
3. Check telephony voice_server_url and webhook URLs.
4. Review provider credentials and active provider settings.
5. Inspect call/evaluation events for failure stage.

Common Issues

• API key auth failures on control-plane routes
• Wrong or localhost-only telephony URL in public deployments
• Missing/expired provider credentials
• WS session token mismatch
• Inference endpoint mismatch when using self-hosted STT/TTS
• Core code changes not reflected because prebuilt images are running instead of source builds

If Rust/Python core changes are not showing up locally, restart with the source override:

docker compose -f docker-compose.yml -f docker-compose.source.yml up -d --build