Troubleshooting & FAQ
Quick answers to the problems people hit most, grouped by area. Find the message you see, then follow the fix. Error codes in brackets are what the API returns.
Account and access
| Problem | Why | Fix |
|---|---|---|
| Check Your Email screen after signing in | Your email isn't verified yet. | Click the link in the email. Use Resend Verification Email if you can't find it, then I've Verified — Continue. |
| No Subscription in the account menu | Only Admin Users manage billing. | Ask an Admin User, or ask them to change your role in Workspace menu › Manage members. |
| Can view settings but can't save them ("No access to modify the object.") | The User role is view-only on most settings. | Ask an Admin User to make the change or update your role. |
| Most of the sidebar is missing | You're a Voice User (Taalk Phone only), or you're in the free sandbox. | See Navigating the Taalk Console. |
| You're looking at the wrong workspace | You belong to more than one. | Click the workspace name at the top of the sidebar › Switch workspace, or press ⌘K. |
| A feature shows a lock or Unlock | It's an add-on that isn't on your plan. | Open it from Platform › Marketplace (Marketplace and Add-ons). |
Free sandbox and going live
| Problem | Why | Fix |
|---|---|---|
| Verify this number before your first test call. | Sandbox test calls only go to phones you've verified (up to two). | Enter the code we text you. |
| Too many codes sent to this number. Try again in an hour. / Too many attempts. Request a new code. | Verification is rate-limited. | Wait, then request a new code. |
| Sandbox test calls support US phone numbers only. | The sandbox dials US numbers only. | Verify a US phone. |
| Too many test calls. Try again in a few minutes. | Sandbox test calls are limited to a few at a time. | Wait a few minutes. |
Your free test balance is used up. (402 sandbox_exhausted) |
You've used your $2.50 sandbox balance. | Click Go live to move to Starter with your $5.00 welcome balance. |
| You have used all your free real texts. | Up to 10 sandbox replies can go to your phone as real texts. | Keep testing in the browser, or go live. |
| Channels › Phone numbers is greyed out | Numbers need your own workspace. | Go live first. |
| The Go live dialog opens when you launch, buy a number or turn on inbound | These reach real customers. | Click Add card and go live. Nothing is charged today. See Is There a Free Trial? |
| This feature is not available on the free tier. (402) | The feature needs a paid workspace. | Go live. |
Agents and test calls
| Problem | Why | Fix |
|---|---|---|
| Turn on auto-recharge to keep testing. (428) | Paid workspaces need auto-recharge before test calls. | Click Set it up, or see Billing and Subscriptions. |
| This phone number is in TCPA DNC. (423) | The number you're calling is on a Do-Not-Call list. | Test with another number. See DNC and Compliance. |
| TCPA Restriction. | The call was blocked by a calling-rule check. | Check Calling Hours for the number's state. |
| Caller ID Issue Found. Please check your Contact Center Settings | The agent's caller ID couldn't be used. | Check the number in Outreach › Channels › Phone numbers. |
| Service Unavailable. Please check your plan and balance. | Usually a zero balance or an inactive plan. | Check your balance on the Subscription page. |
| The agent goes off-script or says the wrong thing | Script or knowledge needs tightening. | See Testing Your Agent and Optimization Guide. |
| Transfers drop or ring out | Wrong target number or nobody answering. | See Transfers and Call Flow. |
[Confirm] 423, "TCPA Restriction." and the Caller ID and Service Unavailable messages are decided by the calling engine; the causes above are the expected ones.
Campaigns not dialing
Launch is blocked
| You see | Why | Fix |
|---|---|---|
| AI Agent Required | No agent on the campaign. | Go to Settings and pick an agent. |
| Caller ID Required / "A Caller ID must be assigned before launching this campaign." | No caller ID on the campaign. | Pick a caller ID in the campaign's Settings. |
| "The selected caller ID group has no phone numbers." | The caller ID group is empty. | Add numbers to the group or choose another caller ID. |
| Save or discard your settings changes first | You have unsaved settings. | Save or discard, then click Launch. |
| "Auto-recharge must be configured before launching a campaign." (428) | Paid workspaces need auto-recharge to launch. | Turn it on in Subscription › Auto Balance Restore. |
| "Before launching, confirm your contacts gave consent, your calling hours, and your Do-Not-Call settings." (400) | The compliance confirmation is missing. | In the app, tick all three on Before you launch. Over the API, send complianceAttested: true with the start request. |
| "You have reached the max concurrent campaign limit" (429) | Too many campaigns are running at once in this workspace. | Pause or cancel a running campaign, then launch. |
| "the campaign is already under run" (409) | The campaign is already running. | Use Pause / Resume instead. |
If you click Confirm & Launch and nothing changes, check the items above and try again.
Running, but no calls go out
| Check | Fix |
|---|---|
| Outside calling hours | Calls only go out inside the campaign schedule and state calling hours. See Campaign Scheduling. |
| Balance ran out | With auto-recharge off, the campaign pauses when your balance runs out. Add balance and turn on auto-recharge. |
| Fuse tripped | The campaign's safety fuse paused it. See Fuse Protection. |
| Every contact is done or stopped | Contacts hit their attempt limit or a stop condition. See Retry and Stop Rules. |
| Contacts were skipped at launch | The launch options skip contacts who refused, were transferred, texted, succeeded or opened a link. Relaunch with Rerun all contacts if you meant to call them. See Launching a Campaign. |
| Numbers on your DNC list | They're skipped. See DNC and Compliance. |
Numbers and texting
| Problem | Why | Fix |
|---|---|---|
| "The phone number is locked by others." (423) | Someone else is setting up that number right now. | Pick a different number. |
| "The phone number is blocked for spam" | That number is on our spam block list. | Pick a different number. |
| "Too many phone numbers" (402) | You've reached your workspace's number limit. | Submit a ticket to raise it. |
| Texts aren't delivered | US carriers need a registered 10DLC brand and campaign. | Register in Compliance › Registration (Compliance Setup). |
| Low answer rate | Caller ID reputation, calling times or list quality. | See Phone Numbers and Answer Rate. |
Billing
| Problem | Why | Fix |
|---|---|---|
| Red alert "Please set the auto recharge to avoid service stop for low balance." | Auto-recharge isn't set. | Fill in Auto Balance Restore on the Subscription page and Save. |
| Auto-recharge didn't top up | The card on file failed or expired. | Add a new card under Payment Method. |
| An add-on feature returns 402 (for example "Requires Taalk AI Builder add-on." or "Post-call AI analysis requires the Post-Call Analysis add-on.") | The add-on isn't on your plan. | Get it in Platform › Marketplace. |
| "Operator seat limit reached." (402) | All your Taalk Phone seats are used. | Buy more seats in the Marketplace. |
| What a call cost | Open the call's Cost detail, or see How Billing Works. |
API errors
| Code | Meaning | Fix |
|---|---|---|
| 400 | Bad request, for example a missing complianceAttested on campaign start. |
Read the message and fix the request body. |
| 401 | Missing, invalid or revoked API key, or your role can't change this object. | Check the Authorization: Bearer header and the key's owner. See API Keys. |
| 402 | Add-on not on your plan, free workspace, or sandbox balance used up (sandbox_exhausted). |
Get the add-on or go live. |
| 403 | "Please use api.taalk.ai" | Send API requests to api.taalk.ai. |
| 404 | The object doesn't exist in this workspace. | Check the ID and the workspace the key belongs to. |
| 409 | The campaign is already running. | Pause or resume instead of starting. |
| 413 | A large report is still being built. | Retry after the Retry-After time (60 seconds). |
| 423 | The number is on a DNC list, or a number is locked by someone else. | Use another number. |
| 428 | Auto-recharge isn't set ("Turn on auto-recharge"). | Set Auto Balance Restore on the Subscription page. |
| 429 | Too many requests for your key's rate limit, or the concurrent campaign limit. | Slow down and retry, or pause another campaign. |
Reporting a bug
- Go to Platform › Support › Submit Ticket.
- Add a Subject and a Description with the steps to reproduce.
- If it's about one call, paste the call link in Session ID (optional). Add the Agent Affected or Campaign Affected if it helps.
- Click Submit Ticket. Replies show under My Tickets and arrive by email.
Tip: open the bell in the top bar and click Copy details to copy your app version, the page you're on and your browser, then paste it into the ticket.
Still stuck? Go to Platform › Support › Submit Ticket. See Support Tickets.