How the flow works
- A reconciliation run finishes. This happens for a run started manually and for a run started by an automation.
- Darpan checks the active tenant’s notification setting. If a Google Chat webhook is configured and active, it continues. If not, the run completes normally with no alert.
- Darpan builds a run-completed summary from the result: the run name, tenant, result ID, difference count, the “only in” counts for each side, and a link to open the run result.
- Darpan posts that summary to the tenant’s Google Chat webhook.
What the alert contains
| Field | Meaning |
|---|---|
| Run name | The saved run, or its identifier when no name is set. |
| Tenant | The tenant the run belongs to. |
| Result ID | The reconciliation run result identifier. |
| Run result link | A deep link to open the result in the Darpan app. |
| Differences | Total difference count for the run: records present on only one source plus matched pairs that failed a rule. |
| Only in (each side) | Count of records present on only one source. |
Before you start
Confirm:- You are a Tenant Admin for the tenant you want alerts on.
- The correct tenant is active.
- You can create or read a Google Chat incoming webhook for the destination space. The webhook URL must be an
httpsURL onchat.googleapis.comthat targets a space messages endpoint and includes itskeyandtokenquery parameters.
Steps
Create the Google Chat webhook
In the Google Chat space that should receive alerts, create an incoming webhook and copy its URL. Keep the URL secret; treat it like a credential.
Open Tenant Settings
Open Ask Darpan, search for Open Tenant Settings, and open the result. Confirm the active tenant is the one you want alerts on.
Save the webhook
In Operations, choose Notifications. Choose the Google Chat notification action, paste the webhook URL, set the status to active, and save.Darpan validates the webhook URL on save and stores it encrypted. Saved settings show the webhook status without exposing the full URL.
Expected result
Every completed run for the tenant posts a summary to Google Chat while the webhook is active. A run with differences is visible in chat with a one-click path to the result, so authored rules turn directly into alerts.Turning alerts off
Set the notification status to inactive in Tenant Settings. The webhook stays stored but no messages are sent until it is reactivated.Troubleshooting
| Symptom | What to check |
|---|---|
| No message arrives after a run | Confirm the webhook status is active for the correct tenant, the run actually completed, and the Google Chat space allows incoming webhooks. |
| Save is rejected | The webhook URL must be https on chat.googleapis.com, target a space messages endpoint, and include key and token query parameters. |
| Message arrives but the link does not open the result | Confirm the run produced a saved result and that the app base URL for the environment is reachable. |
| Alerts stopped after a tenant switch | Notification settings are per tenant. Confirm the active tenant matches the runs you expect alerts for. |