# Schedule Wake-up Calls

Wake-up calls let the hotel ring a guest room at a set time and play a recorded message. Front-desk staff can create these alarms from the Cloud Voice App, and guests can also set their own directly from the room phone. This page covers all three approaches.

:::note
Each guest room can hold as many as 23 pending wake-up calls at a time.
:::

## Set a wake-up call from the Wake-up Service panel

The Wake-up Service panel is built specifically for managing alarm calls, so it works well when you need to program the same wake-up for several rooms in one pass.

1. Sign in to the Cloud Voice App and open **Hotel Management > Wake-up Service**.
2. On the **Wake-Up Task** tab, click **Add** in the top-left corner.
3. Fill in the task details.

   ![Wake-up task form with scheduling fields](/images/pbx/wakeup-task.png)

   | Setting | Description |
   | --- | --- |
   | **Extension / Extension Group** | Choose the guest room or rooms that should receive the wake-up call. |
   | **Wake-up Type** | Set how often the call repeats: **Once**, **At Daily**, **Week**, or **Month**. |
   | **Wake-Up Time** | Pick the time the call should be placed. |
   | **Snooze** | Decide how many times the call retries when the guest does not answer, and how long to wait between attempts. |
   | **Voice Prompt** | Choose the recording the guest hears after answering. |
   | **Ring Timeout (s)** | Set how long the call rings before giving up, in seconds. Accepted range is 5 to 300. |
   | **Failover Destination** | Choose where an unanswered call is routed: **Hang Up**, **Extension**, or **Ring Group**. |
   | **Remark** | Add any notes you want to keep with the task. |

4. Click **Save**.

:::note
The recordings offered under **Voice Prompt** come from the hotel manager's custom prompt library, found at **PBX Settings > Voice Prompt > Custom Prompt**.
:::

The new task appears in the list once saved.

![Saved wake-up task shown in the task list](/images/pbx/wakeup-task-created.png)

When the scheduled time arrives, the system dials the room phone, plays the selected prompt after the guest picks up, and then ends the call.

:::caution
A red dot badge flags any wake-up call that could not be completed.

![Task list marked with a red failure badge](/images/pbx/failed-wakeup.png)

Open the **Wake-Up Logs** page to see why the call failed.

![Wake-up log entry showing the failure reason](/images/pbx/check-failed-reason.png)
:::

## Set a wake-up call from the Room Panel

The Room Panel lays out every guest room visually, which makes it convenient for adding an alarm to a single occupied room or to a group of them.

1. Sign in to the Cloud Voice App and open **Hotel Management > Room Panel**.
2. Open the wake-up settings for the rooms you want.

   **For a single room**

   On a checked-in room, click the wake-up icon ![Wake-up icon](/images/pbx/wake-up.png) in its top-right corner.

   ![Wake-up icon on a checked-in room tile](/images/pbx/wake-up-call-button.png)

   **For several rooms**

   1. Click **Bulk Management** in the top-left corner.

      ![Bulk Management control above the room grid](/images/pbx/bulk-management.png)

   2. Select the checkboxes of the checked-in rooms, then click **Add Wake-Up**.

      ![Multiple checked-in rooms selected for a wake-up call](/images/pbx/wakeup-multiple-room.png)

3. In the window that opens, enter the wake-up details and save.

   ![Wake-up call settings for a room](/images/pbx/single-room-wakeup.png)

   | Setting | Description |
   | --- | --- |
   | **Wake-up Type** | Set how often the call repeats: **Once**, **At Daily**, **Week**, or **Month**. |
   | **Wake-Up Time** | Pick the time the call should be placed. |
   | **Snooze** | Decide how many times the call retries when the guest does not answer, and how long to wait between attempts. |
   | **Voice Prompt** | Choose the recording the guest hears after answering. |
   | **Ring Timeout (s)** | Set how long the call rings before giving up, in seconds. Accepted range is 5 to 300. |
   | **Failover Destination** | Choose where an unanswered call is routed: **Hang Up**, **Extension**, or **Ring Group**. |
   | **Remark** | Add any notes you want to keep with the task. |

:::note
The recordings offered under **Voice Prompt** come from the hotel manager's custom prompt library, found at **PBX Settings > Voice Prompt > Custom Prompt**.
:::

The scheduled call is added to the list.

![Room Panel showing a scheduled wake-up task](/images/pbx/room-panel-wakeup-task.png)

At the scheduled time the system dials the room phone, plays the selected prompt after the guest answers, and then hangs up.

:::caution
A red dot badge flags any wake-up call that could not be completed.

![Task list marked with a red failure badge](/images/pbx/failed-wakeup.png)

Open the **Wake-Up Logs** page to see why the call failed.

![Wake-up log entry showing the failure reason](/images/pbx/check-failed-reason.png)
:::

## Let guests set their own wake-up call from the room phone

Guests can program a wake-up call themselves without calling the front desk. Ask the hotel manager for the wake-up number, share it with guests, and let them follow the voice menu.

The steps below walk through setting an alarm for **6:00 AM tomorrow** from a room phone.

:::tip
The same wake-up number doubles as a self-service menu. From the room phone a guest can press `2` to hear their scheduled calls, `3` to delete one, or `0` to clear them all, so they can adjust an alarm without calling the front desk.
:::

1. Dial the wake-up number. The system announces: "Please choose your operation. Press 1 to add wake-up calls. Press 2 to query wake-up calls. Press 3 to delete wake-up calls. Press 0 to delete all wake-up calls. Press # to exit."
2. Press `1` to add a call. The system announces: "Please choose the date for your wake-up call. Press 1 to choose today. Press 2 to choose tomorrow. Press 3 to set custom date."
3. Press `2` to schedule the call for tomorrow. The system announces: "Please enter your wake-up call time in a 24-hour format. For example, 1400 means 2:00 PM."
4. Press `0600` to set the time to 6:00 AM. The system confirms: "Operate Successfully. Your wake-up call is set for {wakeup_time}."
5. Hang up, or repeat steps 2 through 4 to add another wake-up call.
