# Process Notifications

### Overview&#x20;

The Process Notification feature allows you to configure automated email alerts for critical document processing events. By setting up notifications, you ensure that relevant team members are promptly informed when documents are processed successfully, encounter errors, require human review, or trigger validation failures.&#x20;

Process Notifications can be accessed from the Monitoring section in the left navigation panel of the Docspire web client.&#x20;

<p align="center"><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FIqLCB6cpLPKQO4spmeOP%2Funknown.png?alt=media&#x26;token=8b09f001-3e03-4381-bb7f-936336f14ed9" alt=""></p>

### Notification Events&#x20;

You can configure notifications for the following processing events:&#x20;

| **Event**                    | **Description**                                                                                          |
| ---------------------------- | -------------------------------------------------------------------------------------------------------- |
| Document Processing Complete | Triggered when a document has been successfully processed and data extraction is complete.               |
| Document Processing Failed   | Triggered when document processing encounters an error and cannot be completed.                          |
| Validation Failure           | Triggered when extracted data fails to meet configured validation rules or business logic.               |
| Human Review Required        | Triggered when a document is flagged for manual verification due to low confidence scores or exceptions. |
| Workflow Succeeded           | Triggered when a complete workflow pipeline executes successfully.                                       |
| Workflow Failed              | Triggered when a workflow encounters an error during execution.                                          |
| Integration Established      | Triggered when a new integration connection is successfully established.                                 |

### Setting Up Notifications&#x20;

#### Adding a Notification Recipient&#x20;

Follow these steps to add a new email recipient for process notifications:&#x20;

1. Navigate to **Monitoring** **>** **Process Notification** in the left sidebar.&#x20;
2. In the **Notification Settings** section, click the **+ Add Recipient** button located in the upper right corner.&#x20;

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2Frxorym0aLAs0FxHApSPT%2FScreenshot%202026-01-06%20221812.jpg?alt=media&#x26;token=553d8966-4089-4304-a037-7df2f343a6b5" alt=""><figcaption></figcaption></figure>

3. Enter the recipient's email address in the email field.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FXOMii75mcYVC2hzu65sI%2FScreenshot%202026-01-06%20222016.jpg?alt=media&#x26;token=d5d07696-a011-4af1-b431-690aa979b696" alt=""><figcaption></figcaption></figure>

4. Select the notification frequency from the dropdown. Options include Immediate for real-time alerts.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2Fp4KP9wpEwlIMLHIpBJaE%2FScreenshot%202026-01-06%20222153.jpg?alt=media&#x26;token=e2507b2e-560f-4369-9176-33087ed81ae8" alt=""><figcaption></figcaption></figure>

5. Click the Select events dropdown to choose which events should trigger notifications for this recipient. Check the boxes next to the desired events. You can use Select All to subscribe to all event types.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FRlHcnRvhqfRO2Ka9Q6af%2FScreenshot%202026-01-06%20222306.jpg?alt=media&#x26;token=413afd67-23f3-4aff-a08f-e14377aabd13" alt=""><figcaption></figcaption></figure>

6. Click the green checkmark button to save the recipient configuration, or the red X to cancel.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FI9T2eJcsyzAYpWdyyuNr%2FScreenshot%202026-01-06%20222500.jpg?alt=media&#x26;token=265d7bbc-18f9-4e98-84a6-5cd5bcb711d4" alt=""><figcaption></figcaption></figure>

### Managing Existing Recipients&#x20;

The Email Notification Recipients section displays all configured recipients along with their notification frequency and the number of subscribed events.&#x20;

For each recipient, you can:&#x20;

* **Edit** – Click the pencil icon to modify the recipient's email, frequency, or subscribed events.&#x20;
* **Delete** – Click the trash icon to remove the recipient from the notification list.&#x20;
* **Expand details** – Click the dropdown arrow next to a recipient to view their subscribed events.&#x20;

### Recent Notifications&#x20;

The **Recent Notifications** section at the bottom of the page displays a log of notifications that have been triggered. Each notification entry includes:&#x20;

* **Title** – A summary of the notification event (e.g., "Document Had Been Processed Successfully").&#x20;
* **Description** – Additional details including extraction statistics and a preview of the extracted JSON data.&#x20;
* **Timestamp** – The exact date and time when the notification was generated.&#x20;
* **Document Name** – The filename of the document that triggered the notification.&#x20;
* **Severity** – The severity level of the notification (Info, Warning, or Error).&#x20;
* **Reprocess button** – Allows you to reprocess the document directly from the notification log.&#x20;

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2F4yVX77QInVUDbCncM0Qn%2FScreenshot%202026-01-06%20222904.jpg?alt=media&#x26;token=8b7ce276-66b9-4332-9423-293010655886" alt=""><figcaption></figcaption></figure>

### Best Practices&#x20;

* **Subscribe selectively** – Configure each recipient to receive only the events relevant to their role to avoid notification fatigue.&#x20;
* **Monitor failures actively** – Ensure at least one team member is subscribed to Document Processing Failed and Validation Failure events for timely issue resolution.&#x20;
* **Use Human Review notifications** – Subscribe reviewers to Human Review Required events to minimize processing delays.&#x20;
* **Review notification logs** – Periodically check the Recent Notifications section to identify patterns in processing issues.&#x20;

### Related Features&#x20;

* **Document Tracking** – Monitor the complete lifecycle of documents from ingestion to output delivery.&#x20;
* **Analytics** – View processing statistics and performance metrics across your document workflows.&#x20;
* **Validation Rules** – Configure the business rules that trigger Validation Failure notifications.&#x20;
* **Integrations** – Set up connections to external systems and subscribe to Integration Established notifications.&#x20;
