Skip to content

NethHotel: a NethVoice hotel management system #7283

Open
2 of 4 issues completed
Open

Description

@andrea-marchionni

NethVoice CTI: Hotel Reception Telephone Management Interface

This section of NethVoice CTI is designed to manage the telephone aspects of a hotel reception installation. It integrates with a hotel's PMS (Property Management System) via the FIAS protocol, serving as a bridge for communication between the two systems. While the hotel PMS will remain the primary interface for managing room statuses (e.g., check-in/check-out, cleaning, wake-up calls, guest details, etc.), NethVoice CTI will handle the telephone-related functionalities and communicate relevant data back to the PMS.


Features of the Hotel Telephone Management Interface

1. View and Manage Rooms

  • Display all configured extensions (rooms) within the "rooms context" of NethVoice.
  • Allow sorting and filtering by floor, establishment, and/or group.

2. Room Interactions

Users can interact with room extensions to perform the following actions:

  1. Check-in/Check-out
  2. Mark as Inspected/Occupied.
  3. Enter guest name.
  4. Select the language for system-generated telephone messages.
  5. Set alarm.
  6. Add extra costs (e.g., minibar, room service).
  7. Generate cost reports broken down by telephone usage and extra services.
  8. View group memberships, assign rooms to groups, or remove them from groups.
  9. View and update the cleaning status (status information retrieved from FIAS).
  10. Enable internal calls (restricted to the group if the room belongs to one).
  11. Enable external calls.

3. Settings Section

The settings section will allow administrators to configure the following:

General Settings

  1. External Call Prefix: Define the prefix for making external calls.
  2. Internal Patterns: Specify the format for internal extensions (e.g., XXX).
  3. Tariff Management:
    • Configure predefined tariffs (e.g., mobile calls, national calls).
    • Add custom tariffs with associated costs per second.

Room Group Management

  1. Manage room groups and perform batch operations for:
    • Check-in/Check-out
    • Mark as Inspected/Occupied
    • Wake-up calls
    • Cleaning status updates
    • Language settings
  2. Create custom room groups with the following options:
    • Define group name.
    • Enable calls between rooms within the group.
    • Enable or disable internal calls.
    • Enable or disable external calls.

Short Number Management

  • Assign short numbers to internal numbers (e.g., extensions, queues, groups) for easy dialing.
  • Configure time-based behaviors for short numbers using time groups (e.g., varying call routing based on time of day).

Call Restrictions

  1. Manage call permissions for rooms not in check-in:
    • Enable/disable external calls.
    • Enable/disable internal calls.
    • Restrict calls between groups.
  2. Handle unanswered wake-up calls for internal follow-up.

Telephone Code Management

  1. Enable telephone codes for key operations such as:
    • Check-in/Check-out
    • Logging cleaning status updates
    • Adding extra costs
    • Setting wake-up calls

Language and Extra Costs Management

  1. Define the language for reception messages.
  2. Manage extra costs with options to:
    • Add, edit, or delete items (e.g., water, minibar, etc.).
    • Assign names, costs, unique codes for telephone activation, and enabling options.

4. Reporting

Generate detailed reports that include:

  • Telephone Costs: Breakdown of call charges per room.
  • Extras: Itemized lists of extra services and charges.

5. Telephone Codes

NethVoice will support the following telephone codes for room operations:

  1. Check-in/Check-out: Initiated from the reception.
  2. Cleaning Updates: Can be reported directly from the room.
  3. Adding Extras: Managed via service extensions or from the room.
  4. Wake-up Calls: Configurable from the room or a service extension.

FIAS Integration

This system integrates with the hotel PMS via the FIAS protocol to synchronize room-related data, including:

  • Room statuses (e.g., cleaning, check-in, check-out, Inspected/Occupied).
  • Telephone activity and associated costs.
  • Extra charges (e.g., minibar, room service).

For more details about the FIAS protocol, refer to the [NethHotel FIAS Repository](https://github.com/nethesis/neth-hotel-fias).

Pics from old version

Image
Image
Image
Image
Image
Image
Image
Image
Image
Image

Activity

  1. converted this from a draft issue on Jan 27, 2025
  2. added
    nethvoiceBug or features releted to the NethVoice project
    nethvoice-ctiThe issue is related to NethLink (NethVoice Web client)
    on Jan 27, 2025
  3. assigned and unassigned on May 14, 2025
  4. removed theissue type on May 28, 2025
  5. moved this from Todo to In Progress in NethVoiceon May 28, 2025
  6. Amygos commented on Jun 23, 2025

    @Amygos
    Member

    Release nethesis/ns8-nethvoice 1.3.4

  7. removed this from the NethVoice 1.3 milestone on Jun 23, 2025
  8. 8 remaining items

  9. viktec commented on Nov 12, 2026

    @viktec

    Created the related feature issue: #8317 — NethHotel: Automatically disconnect NethVoice apps at check-out. It is assigned to milestone 2.0 and labeled nethvoice / nethvoice-cti.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    milestone goal 👑This describes an announced milestone goalnethvoiceBug or features releted to the NethVoice projectnethvoice-ctiThe issue is related to NethLink (NethVoice Web client)

    Projects

    • Status
      In Progress

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions