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

# Get notifications on your phone

> Get handovers and new messages on your iPhone or Android phone, even when Popcorn is closed, and choose which ones arrive.

Popcorn can alert your phone the moment your AI agent hands a conversation to your team, a customer replies, or a conversation is assigned to you, even when Popcorn is closed. It works from the web dashboard itself, with nothing to download: on an iPhone you add Popcorn to your Home Screen, on Android you allow notifications in Chrome. You turn it on once per phone, and the same switch works on a computer.

## Before you start

* Your Popcorn sign-in.
* On an iPhone or iPad: iOS 16.4 or later, and Safari.
* On Android: Chrome.
* The events you want on your phone switched on under **Settings → Notifications**, with **Browser and devices** ticked. Teammates who are not **Owner** or **Admin** start without **Handovers** and **Unassigned messages**; see [Which alerts reach your phone](#which-alerts-reach-your-phone).

## On an iPhone or iPad

> [!NOTE]
>
> On an iPhone, notifications come only to Popcorn added to your Home Screen. Popcorn in a Safari tab can't receive them, and its **This device** row says so: "On an iPhone, notifications come to Popcorn AI on your Home Screen."

**1. Open Popcorn in Safari**

On your iPhone, open Safari and go to **app.trypopcorn.ai**.

**2. Add it to your Home Screen**

Tap the Share button (on recent iOS versions, tap **⋯** first), then **Add to Home Screen**. If you don't see it, tap **View More**. Leave **Open as Web App** on if your iPhone shows it, and tap **Add**. A **Popcorn** icon appears on your Home Screen.

**3. Open Popcorn from your Home Screen and sign in**

Tap the **Popcorn** icon. It opens in its own window, apart from Safari, so sign in again the way you usually do.

**4. Turn on notifications**

Open **Settings → Notifications**. Under **This device**, tap **Turn on**, then tap **Allow** when your iPhone asks. You see **Notifications are on for this device**, and the row now reads "Notifications come to this device even when Popcorn AI is closed."

> [!TIP]
>
> Right after your first sign-in in the Home Screen app, Popcorn may show "Get handovers and new messages on this iPhone, even when Popcorn AI is closed." with **Turn on**. Tapping it does the same as the last step. It shows once and only for a few seconds, so if it's gone, use **Settings → Notifications**.

## On an Android phone

**1. Open Popcorn in Chrome**

Go to **app.trypopcorn.ai** and sign in.

**2. Allow notifications**

Chrome may ask straight away whether Popcorn can send notifications. Tap **Allow**, and the phone is on. If it doesn't ask, open **Settings → Notifications**, tap **Turn on** under **This device**, then **Allow**.

**3. Check it's on**

**This device** reads "Notifications come to this device even when Popcorn AI is closed."

## On a computer

The same works in Chrome, Edge, Firefox and Safari on a computer. When Popcorn asks to send notifications after you sign in, click **Allow**; or open **Settings → Notifications** and click **Turn on** under **This device**. Alerts then arrive while your browser is running, even with no Popcorn tab open.

## Which alerts reach your phone

Your phone gets the events that are switched on under **Settings → Notifications** with **Browser and devices** ticked. These choices are yours alone and apply to every phone and computer you turned on.

* **Handovers**: the agent hands a conversation to your team. On by default for **Owner** and **Admin**.
* **Unassigned messages**: a customer sends a message no one is handling. On by default for **Owner** and **Admin**.
* **Customer replies**: a customer replies in a conversation assigned to you. On by default for everyone.
* **Conversation assignments**: a conversation is assigned to you. On by default for everyone.

To get handovers on your phone as a **Manager**, **Agent** or **Viewer**, switch **Handovers** on and click **Save changes**.

* To stop an event on your phones and computers but keep the pop-up inside Popcorn, untick **Browser and devices** for it and leave **In-app** ticked.
* To stop all alerts on one phone, open **Settings → Notifications** on that phone and tap **Turn off** under **This device**. It stays off there until you tap **Turn on** again.

See [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#notifications) for the full settings page.

## What an alert looks like

* **Handovers** arrive as **Conversation Handover**: "A conversation with *customer* has been handed over to you", followed by the agent's reason when it gave one. A handover Popcorn makes on its own says why in the title, such as **Conversation Handover - Credits Exhausted**, **Conversation Handover - Plan Ended**, **Conversation Handover - No AI Agent Configured** or **Conversation Handover - AI Completion Failed**.
* **Conversation assignments** arrive as **New Conversation Assigned**: "*Teammate* assigned a conversation with *customer* to you".
* **Customer replies** arrive as "*Customer* replied", with the start of their message.
* **Unassigned messages** arrive as **New Unassigned Message**: "*Customer* sent a message:" and the start of it.

Alerts are written in English, whatever language you use Popcorn in.

* **Tap an alert** to open that conversation. If it belongs to another of your workspaces, Popcorn switches to it.
* **One alert per conversation.** More messages in the same conversation update its alert quietly; a handover or an assignment alerts you again.
* **Phone off or offline?** An alert waits up to 4 hours, then it is dropped. The conversation is still in your Inbox.
* **Looking at Popcorn when it arrives?** On an iPhone or iPad, and in Safari on a Mac, the alert shows anyway. In Chrome, Edge and Firefox, on Android or a computer, the page in front of you already shows it (a pop-up, or the Inbox updating), so no notification is added. An alert from another of your workspaces still shows.

## Several phones, people and workspaces

* Turn on each phone and computer separately. Every one you turn on gets your alerts.
* A phone alerts whoever is signed in to Popcorn on it. When a teammate signs in on the same phone or browser, the alerts follow them.
* Signing out stops alerts on that phone. When you sign in again, check **This device** under **Settings → Notifications**, and tap **Turn on** if it is off.
* If you belong to several workspaces, you get alerts from each of them. A choice you saved for an event applies in every workspace; an event you never changed follows your role in each one.

## Troubleshooting

| Symptom | Fix |
| - | - |
| **This device** says "On an iPhone, notifications come to Popcorn AI on your Home Screen" | You are in Safari. Add Popcorn to your Home Screen, open it from the **Popcorn** icon, sign in, and turn it on there |
| **This device** says "Your browser blocks notifications from Popcorn AI" and has no **Turn on** | Notifications were refused on this phone. On an iPhone, open the iPhone's **Settings → Notifications → Popcorn** and turn on **Allow Notifications**, or delete the **Popcorn** icon and add it again. On Android or a computer, allow notifications for app.trypopcorn.ai in the browser's site settings. Then come back to **Settings → Notifications** |
| **This device** says "This browser can't show notifications when Popcorn AI is closed." | This browser can't receive them. On an iPhone, update to iOS 16.4 or later and use the Home Screen app; on Android, use Chrome |
| **Couldn't turn on notifications for this device** | The reason is shown under the title. Check your connection and tap **Turn on** again |
| It's on, but handovers never arrive | Check that **Handovers** is switched on with **Browser and devices** ticked; it starts off unless you are **Owner** or **Admin**. Also check that Focus or Do Not Disturb isn't silencing the phone |
| Alerts stopped after you signed out and back in | Open **Settings → Notifications** and tap **Turn on** under **This device** |
| No notification while you're looking at Popcorn | Expected in Chrome, Edge and Firefox: the page shows the alert instead. See [What an alert looks like](#what-an-alert-looks-like) |

## Related

* [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#notifications) for every notification setting
* [Popcorn mobile app](https://docs.trypopcorn.ai/inbox/mobile-app.md), which has its own **Push Notifications** switch
* [Inbox troubleshooting](https://docs.trypopcorn.ai/inbox/troubleshooting.md) for other alerts that don't arrive


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