Troubleshooting
Diagnose and fix the most common issues in TeamMate. Each page follows the same shape: the symptom you see, the likely causes, a step-by-step fix, and where to look for evidence (Diagnostics, logs, history).
Start here
Before opening a specific guide, run these quick checks. They resolve most reports.
- Reload the page and retry. Transient network or streaming hiccups usually clear on a second attempt.
- Confirm your workspace has credits at Settings → Usage & Billing. A zero balance blocks chat, tasks, and workflows.
- Open Settings → Diagnostics and test the Inngest connection. Tasks, workflows, and scheduled runs all depend on background job processing.
- Check the relevant history view (task history, workflow execution history, or conversation) for an error message before assuming the agent itself is broken.
Common issues
| Symptom | Guide |
|---|---|
| Agent stays silent, never replies, or replies with an error | Agent not responding |
| A one-time or scheduled task ended in a failed state | Task failed |
| A workflow run is queued or never finishes | Workflow stuck |
| Slack, WhatsApp, email, or another connection stopped working | Integration disconnected |
| Responses cut off, time out, or the stream errors | Streaming or chat errors |
| ”Out of credits” or “monthly limit reached” messages | Credit / quota issues |
Where to look
- Diagnostics — /settings/diagnostics tests the Inngest background-job connection that powers tasks, workflows, and scheduled runs.
- Usage & Billing — /settings/usage-billing shows your workspace credit balance and per-user caps.
- Task history — /automation/tasks/history-and-logs records each run, its status, and its output.
- Workflow execution history — /automation/workflows/execution-history shows per-node results for each run.
- Connected apps — /settings/connected-apps lists integration connections and their health.
Still stuck
If none of these resolve the issue, see Contact support for what to gather and how to reach the team.