Skip to main content

Troubleshooting

"+ New Agent" is greyed out​

New agents require the agent gateway to be running. If the button is disabled, wait a moment and try again — this usually resolves itself within a few seconds of the instance starting up.

A channel's QR code won't scan or expires​

WhatsApp's QR code is only valid for a short time. If it expires before you scan it, use Try again to generate a new one — no need to redo the earlier setup steps.

My agent can't use a business app connection​

Check that agent's Allowed MCPs setting — new agents start with none allowed. See MCP: Agent Allowlisting.

Messages aren't reaching the agent I expect​

Check Message Routing on the agent you expected to receive it, and confirm the channel or group is actually routed there rather than left to the main agent's default catch-all. See Connecting Channels.

I deleted an agent by mistake​

Deleting an agent removes its workspace and session history permanently — this can't be undone from the dashboard. If you need to recreate it, use the same template (see Agent Templates) to get back to a similar starting point quickly.