{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":37754,"path":"order-management/promote-crm-outlook-emails.md","title":"Configure email promotion rules for Activity Management","bundle":null,"doc_type":null,"release":"australia","body":"\n# Configure email promotion rules for Activity Management\n\nConfigure email promotion rules to automatically process staged emails for manual association through the ServiceNow CRM for Outlook add-in or to trigger AI-powered auto-association with existing sales entities.\n\n## Before you begin\n\n**Note:** Configuring email promotion is required if you're on CRM Outlook Add-in application version 1.0.1.\n\nRole required: admin\n\n## About this task\n\nEmail promotion rules enable the following workflows for managing staged emails:\n\n-   Manual email association: Agents use the ServiceNow CRM for Outlook add-in to associate emails with CRM records, triggering promotion from the Staged Email \\[sys\\_email\\_staging\\] table to the Email \\[sys\\_email\\] table.\n-   AI auto-association: When an agent receives an email with no existing CRM record association, the promotion rule triggers the AI sales activity association workflow to automatically match the email to a relevant sales entity \\(Lead, Opportunity, Contact, or Account\\) using semantic analysis and intent detection.\n\n## Procedure\n\n1.  Log in to your ServiceNow instance.\n\n2.  Add a promotion rule.\n\n    1.  Set the application scope to **Global**.\n\n    2.  Navigate to **All** &gt; **User Mailboxes** &gt; **Promotion Rules**.\n\n    3.  Select **New**.\n\n    4.  On the form, fill in the fields.\n\n<table id=\"table-promotion-rule\"><thead><tr><th>\n\nField\n\n</th><th>\n\nValue\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\n&lt;promotion rule name&gt;\n\n</td></tr><tr><td>\n\nCondition\n\n</td><td>\n\n\\(current.target\\_table == \"&lt;table\\_name&gt;\"\\) &amp;&amp; !gs.nil\\(current.instance\\)\n\n For example, \\(current.target\\_table == \"sn\\_lead\\_mgmt\\_core\\_lead\"\\) &amp;&amp; !gs.nil\\(current.instance\\)\n\n</td></tr><tr><td>\n\nPromotion strategy\n\n</td><td>\n\nPromote and run Triggers\n\n</td></tr></tbody>\n</table>    5.  Select **Submit**.\n\n3.  Create a business rule on the Staged Email \\[sys\\_email\\_staging\\] table.\n\n    1.  Set the application scope to **Global**.\n\n    2.  Navigate to **All** &gt; **System Definition** &gt; **Business Rules**.\n\n    3.  Select **New**.\n\n    4.  On the form, fill in the fields.\n\n<table id=\"table-br-fields\"><thead><tr><th>\n\nField\n\n</th><th>\n\nValue\n\n</th></tr></thead><tbody><tr><td>\n\nName\n\n</td><td>\n\n&lt;business rule name&gt;For example, Trigger promotion rules on CRM emails.\n\n</td></tr><tr><td>\n\nTable\n\n</td><td>\n\nStaged Email \\[sys\\_email\\_staging\\]\n\n</td></tr><tr><td>\n\nActive\n\n</td><td>\n\nSelected\n\n</td></tr><tr><td>\n\nAdvanced\n\n</td><td>\n\nSelected\n\n</td></tr></tbody>\n</table>    5.  In the **When to run** tab, enter the following values.\n\n        |Field|Value|\n        |-----|-----|\n        |When|after|\n        |Insert|Selected|\n        |Update|Selected|\n        |Filter Conditions|\\[Target\\] \\[changes\\] AND \\[Target table\\] \\[changes\\]|\n\n    6.  In the **Advanced** tab, add the following values to trigger email promotion processing for staged CRM emails.\n\n        |Field|Value|\n        |-----|-----|\n        |Condition|sn\\_crm\\_outlook.CRMOutlookAddinConstants.PROMOTED\\_TABLE\\_LIST\\[current.target\\_table\\] == true &amp;&amp; !gs.nil\\(current.instance\\) &amp;&amp; gs.nil\\(current.email\\)|\n        |Script|gs.eventQueue\\(\"email\\_staged.read\", current\\);|\n\n        The script event initiates asynchronous processing to promote the staged email and trigger the appropriate association workflow.\n\n        The following image shows the Advanced tab with Condition and Script fields populated.\n\n        \\[Omitted image \"email-promotion-business-rule.png\"\\] Alt text: Advanced tab with Condition and Script fields populated.\n\n    7.  Select **Submit**.\n\n\n## Result\n\nStaged emails that meet the specified conditions are processed according to the configured promotion rules. Promoted emails appear in the Emails tab on manually associated records or in the activity stream on AI-matched records.\n\n**Related topics**  \n\n\n[Classic Business rules](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/api-reference/c_BusinessRules.md)\n\n[Track emails linked from Microsoft Outlook](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/order-management/view-associated-emails-crm.md)\n\n"}}