Troubleshooting

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 processing runs entirely self-hosted (no external dependency to configure). If a document fails, it's almost always one of:

• Unsupported file type — check Supported File Types.
• Unreadable or corrupted file — a password-protected PDF, a scanned image with no extractable text, or a file that's actually a different format than its extension suggests.
• File too large — very large documents can time out during conversion; try splitting it into smaller files.

If none of those explain it, contact your Talkr admin with the document and the exact error shown in the upload UI.

Still stuck?

Check Core Concepts for how the pieces fit together, or reach out to your organization's Talkr admin.