Specific CUCM/WxC DI Product Configurations

Global Settings

AXL setup and device association with the rooms

Hotel Link needs AXL access to CuCM to change the phone display name and clear the call history. Ensure you complete all the AXL configuration steps, let the AXL service work for some minutes, then check the result through the Detected phones and devices web page. It can be displayed by clicking Admin, System Parameters, IP Telephony System Parameters, Detected phones and devices.

Note: Analog phones are not displayed in the Detected phones and devices web page

TAPI and TSP configuration

The recommended blocking technology for the room phones is ECC/Curri. Nevertheless, TSP installation is required if you want to integrate Imagicle Attendant Console and to display the lock message on some IP phone model. For this reason, installing Cisco TSP is recommended.

Configuring Imagicle Call Analytics

Hotel Link relies on Call Analytics to calculate the call costs, so it must be fully configured and tested before configuring Hotel Link. Please refer to Call Analytics administration guide available here.

When configuring Call Analytics, please mind the following:

Only calls that have a cost are posted (that is, calls which are Outgoing and Answered). So configure Call Analytics to discard internal calls, to save database and CPU resources. You should activate internal calls processing only if advanced call analysis is explicitly required by the customer.
The number of calls placed from the hotel rooms is usually low. When configuring the call check interval for the Recorder service, the recommended value is 30 seconds.
Calls older than 20 minutes are discarded. For this reason, it is mandatory that the Imagicle UCX Suite server time and the CUCM time are aligned. Usage of a NTP service is recommended.
Calls with a wrong date and time are not reported in the Hotel web interface, even if they are displayed in Call Analytics home page. Please double check the time zone setting on the CUCM.
In the tariff, make sure emergency calls have no cost.
PMS protocols do not include currency information. Make sure you create a tariff with costs calculated in the currency of the country where the hotel is located.
PMS protocols do not support masking digits in the called number. This feature might be provided by the PMS on the guest folio. In the UCX Suite room configuration, always set "Number of masked digits in billing" to 0.
PMS protocols do not support timezone information. Call start time always refer to the Hotel timezone. Make sure the UCX Suite server timezone is the same as the Hotel timezone.

When testing the call costs posting hotel feature, please keep in mind:

Any cost lesser than 0.01 is not posted to the PMS.
Costs are sent to the PMS almost in real time, that is, within 3 minutes from the moment the call is terminated.
Call details other than the call cost, such as the called number and the call duration, are sent to the PMS only if the connection protocol (FIAS, UHLL...) supports it.

Proceed to Hotel Link configuration only when you can see Outgoing Answered calls with a cost displayed in Call Analytics home page.

Configuring Phone Lock

Hotel Link locks the room phone by changing the PhoneLock "Lock phone administratively" flag, to prevent the room phones to call external numbers when the room is not occupied by guests. This means the PhoneLock application must be fully functional and tested before continuing with Hotel Link configuration. Please refer to PhoneLock administration guide for the configuration steps.

PhoneLock can work through two blocking technologies, TAPI and ECC/Curri. ECC/Curri is recommended because it allows easier troubleshooting and has a lower impact on the system performance.

You should create an ECC profile which is involved when the room phones try to reach the PSTN. The recommended configuration is through Translation Patterns. Route Patterns call the ECC profile each time a digit is typed on the phone, slowing call processing. ECC profiles for Directory Numbers are triggered only for incoming calls.

Configuring the Annunciator to play a message to let the caller know the call is locked is highly recommended, and simplifies the application testing.

When configuring PhoneLock parameters:

Remember to properly set the numbering parameters in the UCX Suite System Parameters. They are needed to distinguish internal numbers from external numbers.
On the room phones, do not configure the Phone Lock XML service, or the Automatic Lock leveraging Idle url
Remember to configure the list of the emergency numbers in the "List of allowed numbers when phones are locked" on the Phone Lock ⇒ Global Settings web page.
If you are using the TAPI technology, and redirecting the locked calls to a service number playing the "phone is locked", make sure this number is included in the "List of allowed numbers when phones are locked" on the Phone Lock ⇒ Global Settings web page.

PhoneLock also clears the Call history at checkout, provided that Imagicle AXL service is running and configured, as described in the Main Configuration, System Parameters section of the UCX Suite System guide.

Continue Hotel Link configuration only when you are able to administratively lock/unlock a phone from the web interface.

Configuring Voicemail

Imagicle VoiceMail is required to allow the guests to receive personal messages, left from internal phones (such as the reception) or from external callers if DID is available.

It must be fully functional and tested before continuing with Hotel Link configuration. Please refer to VoiceMail administration guide for the configuration details.

VoiceMail configuration is pretty standard. You might want to customize the default welcome message from the web interface.

When used in a room, the voicemail IVR does not ask for a PIN to listen to the messages. If needed, the guest could set a personal PIN number through the voicemail IVR. The pin is removed at checkout.

The IVR language is the UCX Suite default language you choose during setup. To change the IVR language for a specific room, open the room configuration in the Users Management web interface, and enter the language code in the web interface. Warning: the language is not reset at checkout.

If you need the concierge to be notified when a voicemail message has been left on a room IVR, go to the room configuration is Users Management. Fill the voicemail address with the reception email address (e.g. info@myhotel.com). Make sure "do not keep sent voicemails" flag is not checked.

Configuring CuCM for Hotel Link

Provided you have already configured the PBX for other UCX applications (VoiceMail, Call Analytics, PhoneLock), CuCM configuration for Hotel requires just another SIP trunk and a route pattern.

The SIP trunk is need by the wakeup service to call the room phones. The same SIP trunk is used to reach the Housekeeping IVR from the room status. The route pattern is needed to assign a number to the maid status service.

CuCM configuration for Hotel Link is described in the dedicated page in this guide.