Troubleshooting for administrators
Typical symptoms – from mock mode and missing emails to webhook and sign-in problems – with cause and fix.
Célcsoport:Adminisztrátor2 perces olvasás
AI and agents
| Symptom | Cause | Fix |
|---|---|---|
| Copilot/proposals show a “Mock” badge | No ANTHROPIC_API_KEY | Set the key, restart the API |
| Agents do not run / proposals missing | Redis unreachable, cron jobs disabled (AGENTS_CRON_DISABLED=1, CRONS_ENABLED=false on all instances) | Check GET /api/agents/status and GET /api/agents/runs?status=FAILED |
| Proposal stays open with “auto-execution failed” | Precondition violated (status, missing ID, partner without email) | Read the risk text, correct the data, edit & accept |
| Many proposals expire | 72-hour limit, nobody decides | Clarify responsibility; raise the level for reversible actions |
Email and integrations
| Symptom | Cause | Fix |
|---|---|---|
| No emails in the inbox | MAIL_INGEST_ENABLED not true or IMAP_HOST empty; wrong tenant | Set settings.mailbox or MAIL_INGEST_TENANT; only unread emails are fetched |
Replies stay “not sent yet” / smtp_send_failed | SMTP_HOST missing or auth/TLS wrong | IMAP/SMTP mailbox integration → test connection |
recipient_missing when sending | Partner without email | Add email addresses on the partner |
| No vehicle positions | Telematics inactive, sync disabled, vehicle without telematics ID | Test connection, add the telematics ID |
| Sanctions check always cleared | List URL empty (sanctions_list_url_missing) | Set the URL in the EU sanctions list integration |
| Webhook deliveries failed | Endpoint does not reply with 2xx within 10 s; HTTP instead of HTTPS | Check deliveries, use HTTPS; idempotency via X-LogCon-Delivery |
Billing and access
| Symptom | Cause | Fix |
|---|---|---|
| E-invoice with warnings | VAT ID, bank, address or customer VAT ID missing | Run the e-invoice check, complete the master data |
| Export file with broken umlauts | Import profile set to Windows-1252 | Choose UTF-8 (BOM) in the BMD/DATEV import |
| 429 on API calls | 600 requests/minute/IP or 60 Copilot messages/hour | Throttle calls – multiple keys do not help (IP-based) |
| User cannot sign in | No password set, deactivated, tenant suspended, wrong company identifier | Set a password via edit; reactivate |
Diagnostic endpoints
GET /health– database and AI mode (ai: 'mock'means demo mode).GET /api/agents/status,GET /api/agents/runs– state of the agents and their runs.GET /api/proposals/stats– proposal statistics.GET /api/webhooks/:id/deliveries– webhook deliveries.
Kapcsolódó cikkek
- Error messages and FAQWhat the app’s error keys mean, what you can do about each of them, and answers to the most common questions.
- Setting up the mailbox (IMAP/SMTP)How emails reach the AI inbox and how replies, quotes and invoices go out – including server variables and multi-tenant operation.
- IntegrationsConnect, test and monitor freight exchange, telematics, accounting, email, routing, geocoding, sanctions list and e-invoicing.
- Managing users and rolesWhat each role may do, how to invite, edit and deactivate users and how driver and portal logins are created.