Getting Started
Troubleshooting
Common issues when getting started on Talkr
Web Call won't start
- No model configured — Web Calls need at least an LLM, TTS, and STT provider configured (or a Realtime/speech-to-speech provider). Check Model Configuration.
- Microphone permission denied — your browser needs microphone access. Check the site permissions icon in your browser's address bar and allow microphone access, then reload the page.
- Browser doesn't support WebRTC features — use a recent version of Chrome, Edge, Firefox, or Safari.
Invite email never arrived
- Check Spam or Promotions first — this is by far the most common cause.
- Invites expire after a period of time; ask whoever sent it to check its status and resend if needed (Settings → Team for org invites, Superadmin → Invites for platform invites).
Inbound calls aren't reaching the agent
- Confirm the phone number has an Inbound workflow assigned under Telephony Configurations.
- Confirm the webhook URL is correctly configured on your telephony provider's side — see the provider-specific guide and Inbound Calling.
- Check that your telephony account credentials in Talkr are still valid (not expired or revoked on the provider's side).
Outbound calls fail immediately
- Confirm a default outbound telephony configuration is set, or that the campaign/API call explicitly specifies one.
- Confirm the number you're dialing is in E.164 format (
+then country code then number, no spaces or dashes). - Check your organization's concurrent-call limit hasn't been reached.
Knowledge base document stuck processing or failing
Document upload depends on a backend processing dependency. If uploads consistently fail on your deployment, this is most likely a deployment-level configuration issue — see the MPS_API_URL note in Environment Variables if you're a deployment admin, or contact your Talkr admin otherwise.
Still stuck?
Check Core Concepts for how the pieces fit together, or reach out to your organization's Talkr admin.