An agent that is off, muted, not connected to a channel, out of credits, or has failed tasks: what each label and message in the agents screens means and how to get it working again.
An agent is a worker that keeps running on your account. When it stops answering, the reason is almost always shown on its card or in its conversation: it is off, muted, has no channel, or ran out of agent credits. Find the label or message you see. How agents work is in What agents are and The team screen.
You see | What it means | What to do
"⚪ Off" with "Agent is off - not running and not consuming credits" | Someone turned the agent off. | Open the agent and click ⚪ Turn on.
"🔇 Muted" with "Agent is muted - not replying on any channel. Unmute via agent details." | The agent runs but does not reply anywhere. | Open the agent details and unmute it.
"🚫 Disabled" with "Agent disabled by system administration" | The platform team turned this agent off. | Open a ticket to ask why.
"💬 The agent is not connected to a channel yet - connect WhatsApp or Telegram →" | Nobody can reach this agent from outside. | Click the line and connect a channel. See Agent channels.
"🙋 You are replying manually - the agent is paused in this conversation (hand control back with the switch above)" | You took over this conversation, so the agent waits. | Use the switch at the top of the conversation to hand control back.
"Your agents reached their monthly limit" with "This month's agent credits are used up." | The agent credits of your plan ran out. Agents pause when no credits are left. | Choose Put your agents back to work for …, or buy credits; agents keep working on bought credits. See Credit usage.
"Your agent … stopped answering customers" | Same cause: no agent credits are left, and customers are waiting. | Same fix. The window says how many customers wrote and are waiting.
"⚠️ Processing failed and no reply was generated for this message. Send it again." | One message failed on the way. Nothing was answered. | Send the message again.
"⚠️ Tasks that failed for good" | The system retried these tasks and they failed every time. | Read the error of each task, fix the cause (often a disconnected service), then click Retry.
"No app selected - the agent is blocked from all apps (except the home one). Choose at least one, or go back to All apps." | The app access list of the agent is empty. | Pick at least one app, or choose All apps. See Agent permissions.
"🚫 Disconnected / blocked by WhatsApp" | WhatsApp logged out or blocked the number connected to the agent. | Reconnect it. If WhatsApp blocked it, send less to people who did not write first.
"Not connected - scan QR to connect" | The number was connected by QR and the link to the phone dropped. | Open the QR and scan it from WhatsApp on the phone, under Linked devices.
"WhatsApp Cloud connection failed" | The official WhatsApp Business connection did not complete. | Reconnect on Connections with the account that owns the number.
"The browser blocked the login window - allow popups for the site and try again, or connect from the Connections screen" | The sign-in window of a service was blocked. | Allow pop-ups for the site in the browser, or connect from Connections.
"Loading the agents failed. This is probably temporary." | The screen did not load. | Reload the page after a moment.
"The number is blocked. No agent will reply to it anymore." | You blocked this phone number. | Nothing, if that was on purpose.
"This viewing link is unavailable or has expired." | The link to watch an agent's screen ended. | Open the agent again and start a new view.
"This replay link is not valid" | A replay link expired, was revoked or is wrong. | Ask the agent owner for a fresh link.
Each agent has a permissions picker with three modes: No limits (acts without asking), Balanced (asks only before sensitive steps such as sending messages, payments or publishing; the recommended default) and Ask every time. If approvals pile up, move a trusted agent to Balanced. If it did something you did not want, move it to Ask every time. See Approvals.
1. Check the agent is on: An agent that is off or out of credits does not run its tasks.
2. Check the schedule: Times are in your time zone. A task set for once runs only one time. See Tasks and schedules.
3. Look for an approval: A sensitive step waits for your OK. Open the waiting approvals.
4. Look at failed tasks: If it failed for good, fix the cause and click Retry.
The team screen shows a message under the card or the button you used. The part after the colon is the reason, in the words the server sent.
You see | What it means | What to do
"Couldn't create the agent: …" | The new agent was not created. | Read the reason after the colon, fix what it names and try again.
"Couldn't load the teams. Try again." | The list of ready teams did not load. | Try again in a moment.
"Couldn't load your team." | The team screen did not load. | Reload the page.
"Could not start: …" | A standing task you ran now did not start. | Read the reason. Often the agent is off or out of credits.
"Your decision wasn't saved: …" | Your approve or reject did not reach the server. | Click it again. If it repeats, decide in the agents screen.
"The file could not be read" | A file you attached to a message could not be opened. | Send it again, or save it as another file type and send that.
"No services are connected to this agent. Without a connection it cannot read your email, calendar or files." | The agent has no connected service. | Connect one and share it with the agent. See A connected service stopped working.
"The recording could not be turned into text" | A voice message to the agent was not transcribed. | Record it again, or type the request.
"Couldn't send: …" | Your message was not sent. | Check the connection and send again.
"Not saved: …" | A change to the agent was not saved. | Read the reason and save again.
"The agent's details could not be read. Try again in a moment." | The agent card did not load. | Try again in a moment.
When processing stops in the middle of a customer's message, the agents screen lists it under Messages to review: "Processing stopped for these messages. Open the conversation and check what already happened before continuing." Click Open conversation, check what the agent already did and answer the customer if needed. Then write what you checked in "What did you check or resolve?" and click Mark as reviewed. "This records your review. It does not resend the message or mark the work as completed."
If you see "The message list could not be updated. Please refresh and try again.", click Refresh. Details for support holds what the team needs if you open a ticket. How an agent that answers customers is set up is in A customer service agent.
Agents are never deleted, they move to the archive. "The agent was moved to the archive" means someone clicked 🗄️ Move to archive in its settings. Open 🗄️ Archive at the bottom of the agents list and click ♻️ Restore. All its data is kept. See Problems in My Apps and Studio settings for apps deleted by mistake.
When to open a ticket: The agent is on, not muted, has credits and a channel, and still does not answer for more than an hour. Or it shows Disabled. Open a ticket with the agent name and what you expected it to do.
Q: Does an agent that is off use credits?
A: No. "Agent is off - not running and not consuming credits".
Q: Where do I see what my agents spent?
A: In Credit usage under Agent Credits, and per agent in the agents dashboard.
Q: The microphone does not work when I talk to the agent.
A: See Editing and browser problems for microphone permission.
Q: Can an agent message my customers by itself?
A: Only through a channel you connected, and sensitive steps wait for your approval unless the agent is on No limits.
Related: The team screen: run the business from one place, Tasks and schedules, Approvals: what waits for your OK, WhatsApp or email messages did not arrive, Calls, Voice Studio and avatars