> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zentien.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Diagnose and fix common issues with Zentien setup and error capture.

## Errors are not appearing in the dashboard

Work through the following checks in order.

### 1. Is your org connected?

Go to **Orgs** in the dashboard. Your org should appear with a green status indicator. If it shows **Disconnected**, click **Reconnect** and complete the OAuth flow.

### 2. Are you using the right capture method?

| Error type                                | Capture method                           |
| ----------------------------------------- | ---------------------------------------- |
| Errors you catch with `try/catch`         | `ErrorLogger.log()` in your Apex code    |
| Unhandled Apex exceptions, batch failures | Email inbound (`{orgId}@zentienapp.com`) |
| Flow fault paths                          | Email inbound (`{orgId}@zentienapp.com`) |

### 3. For `ErrorLogger.log()` errors

* Confirm the Zentien package is installed: **Setup → Installed Packages → Zentien**
* Confirm your code is calling `ErrorLogger.log(e, 'ClassName', 'methodName')` inside a `catch` block
* Check the Salesforce debug log for any errors publishing `ErrorEvent__e`

### 4. For email inbound errors

* Confirm your inbound address (`{orgId}@zentienapp.com`) is added in both places:
  * **Setup → Apex Exception Email → External Email Addresses**
  * **Setup → Process Automation Settings → Send Process or Flow Error Email**
* Salesforce suppresses duplicate exception emails — try triggering a different error or wait a few minutes and try again (see [FAQ](/reference/faq))
* Check your Salesforce email logs: **Setup → Email Log Files** — confirm Salesforce actually sent the email

***

## Errors appear in Salesforce logs but not in Zentien

This usually means the email was sent by Salesforce but not received by Zentien.

1. Go to **Setup → Email Log Files** in Salesforce and download a recent log
2. Look for emails sent to `{orgId}@zentienapp.com` — confirm they were sent successfully
3. If the email was sent but not appearing in Zentien, contact [hello@zentien.io](mailto:hello@zentien.io) with your org ID and the timestamp

***

## The org connection dropped

Access tokens expire or get revoked when:

* An administrator revokes connected app access in Salesforce
* The connected user's password is reset
* The token is inactive for an extended period

**Fix:** Go to **Orgs → Reconnect** and complete the OAuth flow again. This refreshes the token without losing any historical error data.

***

## Alert notifications are not arriving

1. **Check the rule is active** — go to **Alerts** and confirm the rule shows as enabled
2. **Check the severity threshold** — if your rule is set to ERROR, INFO and WARNING events will not trigger it
3. **Check the destination** — for Slack/Teams, confirm the webhook URL is still valid (webhooks can be deleted or rotated in Slack/Teams settings)
4. **Check the org filter** — if your rule is scoped to a specific org, errors from other orgs will not trigger it
5. **For email alerts** — check your spam folder; alerts come from `alerts@zentien.io`

***

## I can't connect more than one org

The number of orgs you can connect depends on your plan. Starter allows 1 org. To connect additional orgs, upgrade to Team or Enterprise — see [Plans & Limits](/reference/plans).

***

## I can't invite more team members

Your plan's member limit has been reached. Go to **Account → Plan & Usage** to see your current usage. To add more members, upgrade your plan or remove an existing member.

***

## Still stuck?

Email [hello@zentien.io](mailto:hello@zentien.io) with:

* Your organisation name
* The Salesforce org ID (found in **Setup → Company Information**)
* A description of the issue and what you have already tried