> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypersender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Keep the App Running

> Stop Android from pausing Hypersender SMS: turn off unused-app restrictions, remove battery limits, and check the app permissions on your gateway phone.

A gateway phone often sits on a desk for weeks without anyone opening the app. Android doesn't know the app is busy, so it may limit or pause it. When that happens, messages from the API wait on our side and incoming SMS stop reaching your webhooks.

Three settings prevent this. Check all three on every gateway phone.

> [!NOTE]
>
> The screenshots are from a Xiaomi phone on Android 16. Menu names differ a little between brands and Android versions. The names on your phone appear in the Hypersender app itself, under **Settings → Privacy & Security**.

## 1. Turn off unused-app restrictions

If an app isn't opened for a few months, Android can remove its permissions and stop it from running. For a gateway app, that means messages stop without warning.

**1. Open the setting from Hypersender**

During setup, the **Keep Hypersender running** card tells you whether the switch is on. Tap **Open settings**. You can also open it later from **Settings → Unused App Restrictions** in the app.

**2. Turn the switch off**

On the App info screen, turn off the switch. Its name depends on your phone:

| Android version | Switch name |
| - | - |
| 15 and 16 | **Pause app activity if unused** or **Manage app if unused** |
| 13 and 14 | **Pause app activity if unused** |
| 12 | **Remove permissions and free up space** |
| 11 | **Remove permissions if app isn't used** |

When you return to the app, the card shows **Done**.

![The Keep Hypersender running card showing Done, and the App info screen with Pause app activity if unused turned off](https://mintcdn.com/hypersender/ia-WQ1K4yk3iyu2U/images/sms/unused.webp?fit=max\&auto=format\&n=ia-WQ1K4yk3iyu2U\&q=85\&s=730b07a1ee3fa90e252416d62628fbcb)

## 2. Remove battery limits

Battery savers close background apps to save power. Hypersender needs to stay ready to send a message at any moment, so give it no restrictions.

**1. Open the battery settings for Hypersender**

Open the phone's **Settings → Apps → Hypersender SMS**, then tap **Power** or **Battery**. You can also tap **Settings → Battery Optimization** in the Hypersender app and pick **Hypersender SMS** from the list.

**2. Choose No restrictions**

Select **No restrictions** (on some phones: **Unrestricted** or **Don't optimize**).

![The App info screen for Hypersender SMS and the Battery details screen with No restrictions selected](https://mintcdn.com/hypersender/ia-WQ1K4yk3iyu2U/images/sms/battery.webp?fit=max\&auto=format\&n=ia-WQ1K4yk3iyu2U\&q=85\&s=df4c41ad9a99a86975e56adcce731029)

> [!WARNING]
>
> Some brands add their own background limits on top of Android's. If messages still stop after a while, look for these on your phone:
>
> * **Xiaomi, Redmi, POCO:** Autostart on, and battery saver set to No restrictions.
> * **Samsung:** Settings → Battery → Background usage limits. Make sure Hypersender SMS is not in Sleeping apps or Deep sleeping apps.
> * **Oppo, Realme, OnePlus:** Allow auto launch and Allow background activity.
> * **Huawei, Honor:** Launch manually, with Auto-launch, Secondary launch, and Run in background turned on.

## 3. Check the app permissions

Hypersender asks for its permissions during setup. If one was skipped or removed later, open **Settings → App Permissions** in the app (or the phone's App info screen) and check that these are allowed:

| Permission | Why the app needs it |
| - | - |
| **SMS** | Send, receive, and show your messages. |
| **Phone** | Detect your SIM cards and which carrier is in each slot. |
| **Notifications** | Show new messages and delivery updates. On Android 13 and newer this is a separate permission. |
| **Contacts** | Show contact names in your conversations. Optional. |

![The App permissions entry on App info, the list of allowed permissions, and Xiaomi's Other permissions with Service SMS set to Always allow](https://mintcdn.com/hypersender/ia-WQ1K4yk3iyu2U/images/sms/permissions.webp?fit=max\&auto=format\&n=ia-WQ1K4yk3iyu2U\&q=85\&s=de4ac741eda6f5e5b2871442d7950516)

On Xiaomi phones there is one more: open **Other permissions** and set **Service SMS** to **Always allow**. Without it, MIUI and HyperOS may block messages sent in the background.

Hypersender also needs to stay your **default SMS app**. If you install another messaging app and make it the default, Hypersender stops sending. Switch back from **Settings → Apps → Default apps → SMS app**.

## Check that everything works

Open the **Hypersender** tab in the app:

* The service switch at the top shows **Active**.
* Each SIM you use shows **Linked to** and **Receiving enabled**.
* **Heartbeat** shows a recent time. Tap **Send** to check the connection right away.

If the phone stops sending heartbeats for a while, Hypersender marks it offline and sends a `phone.heartbeat.offline` webhook. See the [SMS heartbeats guide](https://docs.hypersender.com/v2/hypersender/overview/sms/sms-heartbeats-guide.md).

> [!TIP]
>
> Keep the phone on a charger and on a stable Wi-Fi or mobile data connection. A dedicated phone that does nothing else is the most reliable setup.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.