Navigation
20.18. Respond to Integration Health Alerts
Understand the integration health banner in AlgaPSA: which integrations it watches, who sees each alert, what each message means, and how to fix it.
An integration that stops working rarely announces itself. A mailbox password changes and client emails stop becoming tickets. An accounting token expires and invoices quietly stop syncing. An RMM loses its connection and device alerts never arrive. By the time someone notices, the gap can be days old.
AlgaPSA watches the integrations most likely to fail this way and shows a banner across the top of the MSP application when one needs attention. The banner appears on every page, so the problem is visible without anyone opening the settings screen.
Who sees the banner
Each alert is shown only to people who can act on it. A technician without settings access is not interrupted by an accounting alert they cannot fix.
| Integration | Who sees the alert | Edition |
|---|---|---|
| Inbound email | Users who can view ticket settings | All |
| Calendar sync | Only the user whose calendar connection has the problem | Enterprise Edition |
| Active RMM connections (such as NinjaOne, Datto RMM, or Tactical RMM) | Users who can view system settings | All |
| Accounting (QuickBooks Online, Xero) | Users with accounting integration read access | Enterprise Edition |
| Microsoft Teams bot | Users who can update system settings | Where the Teams integration is available and installed |
The banner appears only in the MSP application, never in the client portal. It is checked again every five minutes, so an alert clears on its own shortly after the problem is fixed.
What each alert means and what to do
| Alert | What it means | What to do |
|---|---|---|
| "Inbound email for support@… is paused — its credentials no longer work." | The mailbox's sign-in was rejected, so AlgaPSA stopped polling it. | Reconnect the mailbox in Settings > Email. For Microsoft 365, see 10.11. Connect Microsoft 365 Inbound Email to Create Tickets. |
| "Inbound email for support@… reported an error and may not be receiving messages." | The mailbox is connected but its last check failed. | Open Settings > Email and review the provider's error. |
| "Calendar sync for … reported an error and is not syncing." / "… is disconnected and is not syncing." | Your personal calendar connection failed or was disconnected. | Reconnect it from the calendar tab of your Profile. |
| "… reported a sync error, so device and alert data may be out of date." | The RMM's last sync failed. | Open the RMM's settings and run a sync or test the connection. |
| "… needs to be reconnected — its credentials can no longer be refreshed." | The RMM's access token expired or was revoked. | Reconnect the RMM from its settings. |
| "… needs to be reconnected before accounting sync can run again." | The accounting connection's authorization has lapsed. | Reconnect QuickBooks Online or Xero under the Accounting category. |
| "The last … sync did not finish, so invoices and payments may be out of date." | An accounting sync started but did not complete. | Review the sync results and run it again. |
| "The … bot cannot reply: its bot connector credentials are not configured on the server." | The Teams bot is installed but cannot send replies. | Complete the Teams bot configuration; see 20.9. Connect Microsoft Teams to AlgaPSA for Technician Workflows. |
Every alert has a Review button that opens the settings page where the problem can be fixed.
Dismissing an alert
Select the X on an alert to hide it. The dismissal lasts for the current browser session only. If the integration is still broken the next time you sign in, the alert comes back. That way a known problem can be set aside during a busy shift without being forgotten.
Hudu is not monitored by the banner. Check the Hudu connection from its own settings page; see 20.11. Hudu IT Documentation Integration.
Make alerts reach the right person
- Give whoever owns each integration the permission that matches its alert. An accounting alert is shown only to users with accounting integration read access, so make sure your billing lead has it.
- Record who owns each third-party account (the Microsoft 365 app registration, the QuickBooks login, the RMM API key). When an alert says a connection must be reconnected, that person usually has to sign in.
- After a fix, the alert clears within a few minutes. If it does not, open the integration's settings and check its status there.
For an overview of every integration category, see 20.1. Connect Third-Party Applications and External Integrations.
