Wiki source code of Notifier
Last modified by Sabrina V. on 2026/07/28 08:45
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{aagon.priorisierung}} | ||
| 2 | 80 | ||
| 3 | {{/aagon.priorisierung}} | ||
| 4 | |||
| 5 | {{aagon.floatingbox/}} | ||
| 6 | |||
| 7 | The ACMP Helpdesk Notifier alerts you when a new ticket is received or when a change is made to an existing one. You can open the corresponding ticket in the ACMP Console directly from a notification. | ||
| 8 | If you have a CTI license, an incoming help desk contact is recognized. You can view a list of their open tickets and open them in the ACMP Console. In addition, you can control your phone from your PC. You can answer calls, dial contacts with a single mouse click, and put calls on hold or transfer them. During a call, you can easily open all of the other party’s open tickets, allowing you to work more effectively. | ||
| 9 | |||
| 10 | = Installing the Notifier = | ||
| 11 | |||
| 12 | To install the Notifier, you must have at least the .NET Framework 3.5 installed. Using the CTI functionality also requires an installed and configured TAPI driver. You can usually obtain the necessary installation files directly from your phone system manufacturer. However, drivers from other vendors can also be used. | ||
| 13 | |||
| 14 | In addition, the ACMP Console should be installed, as this is the only way to benefit from quick access to tickets. Once all prerequisites are met, you can install the Notifier by executing the corresponding setup file “~\~\%ACMP-Server%\ACMP\Notifier\ACMP Notifier_Installer.msi” and following the installation instructions. A corresponding Whitepaper for the background services “ACMP Data Proxy” and “ACMP Data Gateway” also provides detailed information on the installation and configuration of these services, which are required for the Notifier. These should be installed by the administrator. | ||
| 15 | |||
| 16 | After starting the ACMP Helpdesk Notifier, you can log in with your user credentials. If the “Log in automatically” option is activated, you will no longer need to enter your login credentials when starting the Notifier, and the Notifier will start immediately. Additionally, when starting the Notifier for the first time, you must specify the URL for the ACMP Data Proxy. You can obtain this from your administrator. | ||
| 17 | |||
| 18 | (% style="text-align:center" %) | ||
| 19 | [[image:XWiki.Images.WebHome@hmfile_hash_fbc34e07.png||alt="12.1 - Notifier Login" height="367" width="505"]] | ||
| 20 | Notifier Login Window | ||
| 21 | |||
| 22 | === **Automated Deployment of the Notifier** === | ||
| 23 | |||
| 24 | Deploying the Notifier can be made easier by using a Client Command. To do this, use the available [[MSI Commands>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.MSI.WebHome]]. To simplify the configuration of the Notifier, it is also possible to create a template for user-specific configuration. This allows you to set all settings before the Notifier is launched for the first time. To create a configuration template, please proceed as follows: | ||
| 25 | |||
| 26 | 1. Install the Notifier and configure it. | ||
| 27 | 1. Open the folder “%AppData%\Aagon\AcmpNotifier” and copy the file Configuration.xml to Configuration.Default.xml. | ||
| 28 | 1. Open the file with a suitable text editor and customize the following section: | ||
| 29 | |||
| 30 | {{figure}} | ||
| 31 | [[image:65_Helpdesk_Notifier_Automatisierte Verteilung des Notifiers_723.png||data-xwiki-image-style-alignment="center"]] | ||
| 32 | |||
| 33 | {{figureCaption}} | ||
| 34 | Customized XML file | ||
| 35 | {{/figureCaption}} | ||
| 36 | {{/figure}} | ||
| 37 | |||
| 38 | |||
| 39 | 4. Remove the GUID from ComponentId and set FirstTimeConnectedToThisProxy to True. | ||
| 40 | 5. Copy the file to the Notifier’s installation folder. | ||
| 41 | |||
| 42 | |||
| 43 | As long as no custom configuration file exists, the Notifier will now use Configuration.Default.xml to create a custom configuration file based on the default configuration. | ||
| 44 | |||
| 45 | = Configuring the Notifier = | ||
| 46 | |||
| 47 | After successfully logging in, you can now configure the ACMP Helpdesk Notifier. To do this, open the configuration window either via the “Program” menu in the Notifier’s menu bar or via the context menu of the Notifier icon in the system tray. | ||
| 48 | |||
| 49 | In the General section, you can customize the Notifier’s behavior to suit your needs. For example, you can set the display duration of notifications and specify a ringtone for notifications. In addition, you can set the interval (in seconds) at which the ACMP Helpdesk Notifier queries the ACMP Data Proxy for Events, as well as the Notifier’s language. You can also configure whether the Notifier should start automatically at system start. | ||
| 50 | |||
| 51 | [[image:hmfile_hash_288d9620.png||alt="12.2 - Notifier General Config" data-xwiki-image-style-alignment="center" height="524" width="700"]] | ||
| 52 | |||
| 53 | In the Helpdesk settings, you can enable or disable notifications for the Helpdesk. You can also configure which types of notifications should be displayed for which editors. All ACMP Users who belong to the //Helpdesk// role are available for this. This makes it possible to receive notifications about tickets handled by another employee should that employee be absent due to illness or vacation, for example. The “Unassigned” editor applies to all tickets that have not yet been assigned to an editor. These may include, for example, tickets received via email or through the web interface. | ||
| 54 | |||
| 55 | [[image:hmfile_hash_e2e461e3.png||alt="12.2 - Notifier Helpdesk Config" data-xwiki-image-style-alignment="center" height="524" width="700"]] | ||
| 56 | |||
| 57 | In the phone settings, you can configure the CTI interface of the ACMP Helpdesk Notifier. Please note that you can only enable the phone functionality if you have installed and properly configured a TAPI driver. First, you must activate the CTI interface by checking the corresponding checkbox. Once the CTI interface is enabled, you must select a phone line from your TAPI driver and enter the corresponding parts of your phone number into the appropriate fields. Specify whether area codes should be recognized for incoming calls and also select whether the phone window should close after the call ends. Finally, you can set a speed dial hotkey. Using this key combination, you can select any text from, for example, Word or Excel documents and make a call directly. Please note that you should not use key combinations that are already assigned (e.g., Ctrl+C) or individual letters. Once you have configured all settings, save your entries by clicking //OK//. | ||
| 58 | |||
| 59 | [[image:hmfile_hash_e27c16bd.png||alt="12.2.1 - Notifier CTI Config" data-xwiki-image-style-alignment="center" height="524" width="700"]] | ||
| 60 | |||
| 61 | Example: | ||
| 62 | |||
| 63 | Your company has the following phone number: +492921789200 | ||
| 64 | |||
| 65 | This phone number is broken down as follows: | ||
| 66 | |||
| 67 | * Country code: +49 | ||
| 68 | * Area code: 02921 (Please enter the area code with a leading zero) | ||
| 69 | * Main number: 7892 | ||
| 70 | |||
| 71 | You must specify the extension “00” when configuring the TAPI driver. For the “External Line Access Code,” enter the digits you must dial before making an external call to access an outside line. Since the extension in this example is “00” and thus consists of two digits, you must enter a 2 for “Extension Length.” | ||
| 72 | |||
| 73 | = Setting Up the Notifier = | ||
| 74 | |||
| 75 | Once you have completed all the settings, the Notifier is ready for use. As soon as one of the actions previously configured in the Helpdesk settings occurs for the corresponding user, a notification appears at the bottom right of the screen, informing you of the type of action, the contact, and the corresponding ticket. Clicking on the ticket name opens the corresponding ticket, provided the ACMP Console is installed. | ||
| 76 | |||
| 77 | [[image:hmfile_hash_ec9f9a78.png||alt="12.3 - Notifier Notification" data-xwiki-image-style-alignment="center" height="100" width="320"]] | ||
| 78 | |||
| 79 | [[image:hmfile_hash_34fba769.png||alt="12.3 - Notifier Notifications_nummeriert" data-xwiki-image-style-alignment="center" height="460" width="743"]] | ||
| 80 | |||
| 81 | |||
| 82 | |(% style="width:178px" %)1. Menu bar:|(% style="width:1186px" %)((( | ||
| 83 | Using the “Program” menu, you can either open the ACMP Helpdesk Notifier configuration window or close the Notifier's main window. | ||
| 84 | |||
| 85 | The “Help” menu gives you access to the CTI Console, the Notifier Help, and release notes. The CTI Console is designed to make it easier to troubleshoot errors or misconfigurations of the TAPI driver and, for this purpose, logs all Events related to the TAPI driver. | ||
| 86 | ))) | ||
| 87 | |(% style="width:178px" %)2. Notifications:|(% style="width:1186px" %)((( | ||
| 88 | The “Notifications” tab opens a list of events that have occurred since the Notifier was started. This list is sorted chronologically, with the most recent message at the top. For example, it logs calls, ACMP system notifications, or changes to tickets. This list is automatically cleared when the Notifier is exited. | ||
| 89 | ))) | ||
| 90 | |(% style="width:178px" %)3. Contacts:|(% style="width:1186px" %)((( | ||
| 91 | Use the “Contacts” tab to open the contact list. This list contains all contacts stored in ACMP and is automatically synchronized with the ACMP Database at regular intervals. You can call contacts directly from this list or display their open tickets. | ||
| 92 | ))) | ||
| 93 | |(% style="width:178px" %)4. Phone:|(% style="width:1186px" %)((( | ||
| 94 | Click the phone icon to open the phone window, which gives you access to CTI functions. | ||
| 95 | ))) | ||
| 96 | |(% style="width:178px" %)5. Filter options:|(% style="width:1186px" %)((( | ||
| 97 | Use the drop-down list to filter the list of events by different categories. The following options are available: | ||
| 98 | |||
| 99 | * All: Displays all events unfiltered and sorted chronologically. | ||
| 100 | * Helpdesk (grouped): In this view, all events for a single ticket are grouped together and displayed in a block, sorted chronologically. The ticket with the most recent change is always displayed at the top. | ||
| 101 | * Helpdesk displays only Helpdesk tickets in chronological order. | ||
| 102 | * Phone displays only phone notifications. | ||
| 103 | * System displays only system notifications. | ||
| 104 | ))) | ||
| 105 | |(% style="width:178px" %)6. Search:|(% style="width:1186px" %)((( | ||
| 106 | Using the search field, you can find notifications by tickets and calls or by contacts. For tickets, the search takes into account the ticket name, the contact, and the editor. Calls can be searched by contact name and phone number. Contacts can be searched by first and last name, company, or phone number, among other criteria. | ||
| 107 | ))) | ||
| 108 | |(% style="width:178px" %)7. Create new ticket:|(% style="width:1186px" %)((( | ||
| 109 | Use this button to create a new help desk ticket directly from the Notifier interface. The ACMP Console opens in the Helpdesk section. | ||
| 110 | ))) | ||
| 111 | |||
| 112 | = CTI functions = | ||
| 113 | |||
| 114 | |(% style="width:1007px" %)((( | ||
| 115 | === **1. Status:** === | ||
| 116 | |||
| 117 | * “No active call”: Indicates that the phone is in standby mode. | ||
| 118 | * “Active call”: You are currently on a call with someone. If the phone number is associated with a contact, the contact’s name appears on the number pad (3). | ||
| 119 | * “Incoming call” | ||
| 120 | * “Dialing …” | ||
| 121 | )))|(% rowspan="2" style="width:354px" %)((( | ||
| 122 | (% style="text-align:center" %) | ||
| 123 | [[image:XWiki.Images.WebHome@embim1.png||alt="https://manual.aagon.com/acmp/de/61/embim1.png" height="384" width="239"]] | ||
| 124 | Bild 7: Telefonfenster | ||
| 125 | ))) | ||
| 126 | |(% style="width:1007px" %)((( | ||
| 127 | === **2. Quick Access to Contacts:** === | ||
| 128 | |||
| 129 | Click the contact icon to display a list of Helpdesk contacts. Double-click a contact to open its details. If at least one phone number is listed, you can call the contact directly using the assigned phone number by clicking the call icon next to the number. | ||
| 130 | ))) | ||
| 131 | |(% colspan="2" %)((( | ||
| 132 | === **3. Phone Number Field:** === | ||
| 133 | |||
| 134 | Displays the other party’s phone number. Please note that when you insert a phone number, it is automatically formatted. This means that all non-numeric characters are automatically removed, and the “+” sign in the country code is replaced with two zeros. This occurs both when inserting from the clipboard and when dialing directly from the contact details. Phone numbers can therefore be entered into the ACMP Helpdesk’s contact management system in any supported format. | ||
| 135 | |||
| 136 | The following number formats are supported: | ||
| 137 | |||
| 138 | * “0049-2921 7892/00” | ||
| 139 | * “+492921/789200” | ||
| 140 | * “02921-789200” | ||
| 141 | * “789200” | ||
| 142 | * “00” | ||
| 143 | |||
| 144 | Special characters are automatically omitted during dialing or caller ID display. | ||
| 145 | |||
| 146 | The following number formats are not permitted: | ||
| 147 | |||
| 148 | * “0049-2921 7892/00 or 7892/01” | ||
| 149 | * “+49 (0) 2921/7892-00” | ||
| 150 | |||
| 151 | You may not enter two phone numbers or extensions in a single phone field. Additionally, you may not include a zero after the country code (in this case, after the +49). | ||
| 152 | |||
| 153 | |||
| 154 | ))) | ||
| 155 | |(% colspan="2" %)((( | ||
| 156 | === **4. Dialing Keys:** === | ||
| 157 | |||
| 158 | You can use the number keys to enter the phone number of the person you want to call. Alternatively, you can use the number keys on your keyboard to enter the desired phone number or insert a number from the clipboard. | ||
| 159 | |||
| 160 | If you click the arrow above the dialing keys, the number keys will be hidden. | ||
| 161 | ))) | ||
| 162 | |(% colspan="2" %)((( | ||
| 163 | === **5. Call Options:** === | ||
| 164 | |||
| 165 | Depending on your current status, you have different options: | ||
| 166 | |||
| 167 | * No active call: | ||
| 168 | ** Make a call | ||
| 169 | |||
| 170 | [[image:XWiki.Images.WebHome@embim2.png||alt="https://manual.aagon.com/acmp/de/61/embim2.png" height="47" width="184"]] | ||
| 171 | |||
| 172 | |||
| 173 | * Incoming call: | ||
| 174 | ** Answer | ||
| 175 | ** Answer and open contact details | ||
| 176 | ** Dismiss | ||
| 177 | |||
| 178 | [[image:XWiki.Images.WebHome@embim3.png||alt="https://manual.aagon.com/acmp/de/61/embim3.png" height="47" width="184"]] | ||
| 179 | |||
| 180 | |||
| 181 | * Active call: | ||
| 182 | ** Hang up | ||
| 183 | ** Transfer | ||
| 184 | ** Hold | ||
| 185 | |||
| 186 | [[image:XWiki.Images.WebHome@embim4.png||alt="https://manual.aagon.com/acmp/de/61/embim4.png" height="47" width="184"]] | ||
| 187 | |||
| 188 | To put a call on hold, first click the “Hold” button. The person on the other end will then hear the “Please hold” tone from the phone system. To resume the call, click the “Resume” button. | ||
| 189 | If you want to transfer the caller, first click the “Transfer” button. In the dialog box that appears, you can enter the phone number to which the call should be transferred, or select a contact’s phone number from your contact list and confirm by clicking “OK.” The system will now attempt to establish a connection between the two parties while the caller hears the phone system’s “Please hold” tone. If this is successful, you can hang up and the parties will be connected. If the connection fails - for example, because the new party does not answer—you can resume the call with the original caller by clicking the “Retrieve” button. | ||
| 190 | ))) |

