Skip to main content

​
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 typeCapture method
Errors you catch with try/catchErrorLogger.log() in your Apex code
Unhandled Apex exceptions, batch failuresEmail inbound ({orgId}@zentienapp.com)
Flow fault pathsEmail 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)
  • 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 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.

​
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 with:
  • Your organisation name
  • The Salesforce org ID (found in Setup → Company Information)
  • A description of the issue and what you have already tried