Hotel Manager is a part of Wildix WebAPI library. This document explains how to configure and to use Hotel Manager extension.
Created: December 2018
Permalink:
Introduction
Hotel Manager extension is a part of Wildix WebAPI library. For more information on WebAPI library, read the document WebAPI Admin Documentation.
To be able to access Hotel Manager you need Wildix Collaboration license or UC-Business user profile (more information on Per User licensing: https://manuals.wildix.com/licensing/).
Features available with Hotel Manager:
- guests check-in, check-out
- wake-up calls scheduling
- room housekeeping status clean / dirty
- call billing
Wildix also offers integration with hotel PMS, more information: Hotel Integration - FIAS protocol.
Access Hotel Manager
You have the following options:
- use our online demo available at https://www.wildix.com/webapi/hotelManager/
- use Hotel Manager on a web server accessible via HTTP/HTTPS - download the JavaScript library from the Wildix website and then upload the Hotel Manager folder on your server
- upload Hotel Manager on your Wildix PBX - follow the instructions published in WebAPI document: Access WebAPI Demo
If you are using online demo or Hotel Manager on your server, you need to add the domain to the whitelist in WMS Settings -> PBX -> Security; see documentation: Domain Whitelist (Allow Origin).If you are having issues with accessing Hotel Manager, read the WebAPI document -> Access WebAPI Demo.
To access the Hotel Manager page, click Settings icon (Wheels icon) and enter the credentials:
- Host: URL of your Wildix PBX, example: elenatest.wildixin.com
- Extension: your extension (make sure Collaboration web page is open with the same extension)
- Password: your Web password for access to Collaboration
Collaboration web page should be open from the same user as for access to Hotel Manager interface.
Make sure that user that accesses the Hotel Manager interface is of "admin" type. Otherwise you will not be able to update the guest's name upon check-in:
For more information on user types, read WMS Start Guide - Adding users manually.
Now you should be able to view rooms subdivided by their Group / Department field. You can edit Group / Department field in WMS → Users, double-click on user (room). For more information, read WMS Start Guide - Adding users manually.Here is an example of WMS configuration for the screenshot provided above:
Note that you can select User type - Room (first line) to differentiate normal PBX users from hotel rooms.
Only rooms added to your roster in Collaboration can be viewed in Hotel Manager! You can add more rooms to your roster from Collaboration → Other → Edit Colleagues (read Collaboration guide - Colleagues (roster) for more information) or in WMS → Users → select a user and click Edit preferences, then scroll down to Roster (read WMS Start Guide - User preferences for more information):
Check-in and Check-out
Press "Check-in" icon from the interface to check-in a guest
On the next step you can enter the guest's name
User must be of "admin" type to be able to update the guest's name.
- Guest's name is updated both on Hotel Manager interface, in WMS interface, on the display of a WP4X0 series installed in the room
After you press "Check-out" icon, the guest information will be updated in Hotel Manager interface, in WMS, on the phone's display and the guest will be removed from the room.
Setting Wake-up calls
For the correct processing of wake-up calls you have to configure a new Dialplan procedure in WMS → Dialplan.
Create a new procedure and name it "alarmclock": Called number: X.
- Dial the phone → wake-up call is placed to the room
- Set - Caller name - Failed Alarm Clock-${EXTEN} → in case wake-up call failed (e.g. no answer / reject), caller name is changed to "Failed Alarm Clock-<room number>"
- Dial the phone - 324 (receptionist extension number) → receptionist will receive a call in case of failed alarm clock and as caller name the following information will be displayed "Failed Alarm Clock-1001"
Called number: alarm
- Play sound - select the ring tone or upload a new one (this sound is played to the guest after they answer a wake-up call)
After you have configured the procedure for processing wake-up calls, specify this Dialplan procedure in Hotel Manager Settings (press the "Wheels" icon):
Guests can set up wake up calls directly from the room: dial Feature code 773 and follow the audio instructions. In case a guest places a wake-up call request from the room, the information will be updated on the Hotel Manager web interface automatically.
Service make up room
From Hotel Manager interface you can change housekeeping status of the room: "make up room" / "clean"
Housekeepers can change the room status directly from the room phone: dial Feature code 771 and follow the audio instructions. In case a housekeeper changes the room status from the phone installed in the room, the information will be updated on the Hotel Manager web interface automatically.
Call billing
For the correct charing of call costs, it is necessary to upload pricelists in WMS → Trunks → Pricelists. To download a pricelist template and for the information on how to upload pricelists on the PBX, please refer to the WMS Start Guide - Pricelists:After you have uploaded a pricelist, do not forget to associate the trunk used for outgoing calls with the priceslist in WMS → Trunks.
After you have uploaded a pricelist and associate the trunk with it, authorized users can view the call costs in CDR-View:The information on call costs per room can be also viewed and printed via Hotel Manager interface. To view call costs, click "Call history" icon:
You can select the exact time period using the fields "From" and "To", and click the "Print" icon to print out the call billing information for the guest: