لاtification Settings

AIIA incorporates a real-time notification engine to drive collaboration between auditors, managers, and clients, ensuring no audit deadlines, action items, or KRI breaches go unnoticed.

Administrators can configure the system SMTP configuration, customize notification triggers, and manage template localizations for both English and Arabic audiences.

---

Channels of لاtification

1. In-App Notifications: Real-time push notifications delivered directly to the user dashboard (bell icon). Used for task assignments, approvals, and review comments.
2. Email Notifications: Rich HTML emails sent to users for external collaboration (e.g., PBC evidence uploads) and automated reminders.
3. Webhook Alerts: JSON event payloads dispatched to external channels (e.g., Slack or MS Teams). See Webhooks & Event Streams for setup details.

---

SMTP الإعداد

To enable email notifications, configure the mail server settings under Admin → Notifications → Mail Settings:

Parameter	Configuration Key	Description
SMTP Host	SMTP_HOST	The hostname or IP of the outgoing mail server (e.g., smtp.mailgun.org).
SMTP Port	SMTP_PORT	Standard SMTP ports: 587 (TLS) or 465 (SSL).
Username	SMTP_USER	The authentication account username.
Password	SMTP_PASS	The authentication account password (encrypted at rest).
From Address	SMTP_FROM	The sender address (e.g., no-reply@organization.sa).
Use TLS/SSL	SMTP_USE_TLS	Toggle cryptographic transport encryption.

---

لاtification Rules & Triggers

AIIA triggers notifications for the following events:

Event Group	Trigger Event	Primary Recipient	Priority
PBC Portal	PBC Request Created	Audit Client Contact	High
PBC Portal	Evidence File Uploaded	Assigned Auditor	Medium
Fieldwork	Workpaper Ready for Review	Assigned Manager	Medium
Fieldwork	Review Point Left / Commented	Assigned Auditor	Medium
Findings	Action Plan Overdue Reminder	Action Owner	High
Findings	Finding Sign-off Requested	CAE / Lead Manager	High
Monitoring	KRI Threshold Breached	QA Officer / Control Analyst	Critical

---

Bilingual Template Customization

Every notification email sent by AIIA is rendered dynamically based on the user's localized preference (English LTR or Arabic RTL):

1. Structure Customization

Templates support HTML structure styling and include corporate headers, dynamic tokens, action call-to-action (CTA) buttons, and footers.

2. Supported Merge Tokens

You can use the following merge variables in your HTML templates:

• {{recipient_name}} — Full name of the recipient user.
• {{event_title}} — Brief summary of the triggering event.
• {{action_url}} — The direct dashboard URL link to process the task.
• {{details}} — Bullet points detailing the specific finding, workpaper, or KRI breach.

3. Modifying القوالب

1. Go to Admin → Notifications → Templates.
2. Select the specific trigger template (e.g., PBC Evidence Requested).
3. Toggle between English and Arabic views to edit the text or HTML structure.
4. Click Test Email to send a draft rendering to your inbox.
5. Click Apply Updates to save the changes.