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

# Notifications

> Choose where Moshi sends notifications to your team: Slack, email, or both.

Moshi sends notifications to your team in Slack, by email, or both.
All notifications post to one default Slack channel.
You can give a notification type its own channel when you want it in a different place.
Each notification type has its own Slack and Email switches.

## Notification types

| Notification | What it tells you | Slack | Email |
| - | - | - | - |
| [Closer alerts](https://docs.moshi.ai/operate/notifications/closer-alerts.md) | Leads that are ready to close. | Yes | Yes |
| More notification types | Coming soon. | — | — |

## Before you start

Only organization admins can change notification settings.
Other members can see the settings but cannot change them.

For Slack notifications, you need one of these:

* The Moshi Slack app in your Slack workspace.
* A shared Slack channel with Moshi.

Email notifications are optional.
For email, you need one address that receives them.

## Set up notifications

**1. Open the settings**

Open Settings and select Notifications.

**2. Connect Slack and choose a default channel**

If Slack is not connected, select Connect Slack.
Approve the Moshi app in Slack and return to Moshi.
Then select a channel in Default Slack channel.
All notifications post to this channel, unless a notification has its own channel.

> [!WARNING]
>
> Invite @Moshi to a private channel before you select it.
> Moshi cannot post to a private channel that it is not a member of.
>
> You cannot select a channel that you share with another company.
> Your shared channel with Moshi is the only exception.

**3. Choose a channel for one notification (optional)**

In the row of the notification, select a channel in Slack channel.
Select Use default to post to the default channel again.

**4. Add a notification email (optional)**

Enter an address in Notification email and select Save.
Moshi also sends notifications to this address.

**5. Turn Slack and email on or off**

Use the Slack and Email switches in the row of each notification.
Both switches are on by default.

The Slack columns appear after you connect Slack.
The Email column appears after you save a notification email.

### Without the Moshi Slack app

If you have a shared Slack channel with Moshi, Slack notifications post there.

Each notification row shows the shared channel and a Slack switch.
Turn the switch off to stop that notification in the shared channel.
To choose other channels, connect the Moshi Slack app.

## Where Slack notifications post

| Your setup | The notification posts to |
| - | - |
| The Slack switch of the notification is off. | No channel. |
| The Moshi Slack app is not connected, and you have a shared channel with Moshi. | Your shared channel with Moshi. |
| The notification row has its own channel. | That channel. |
| The notification row has no channel, and you chose a Default Slack channel. | The default channel. |
| You chose no channel, and you have a shared channel with Moshi. | Your shared channel with Moshi. |
| You chose no channel, and you have no shared channel with Moshi. | No channel. Choose a channel to get Slack notifications. |

After you choose a channel of your own, Moshi stops using the shared channel as a backup.

## Manage notifications from Slack

The `/moshi` command needs the Moshi Slack app.
Run `/moshi` in the Slack channel that you want to change.
Replace `<notification>` with the name of a notification, such as `closer`.

| Command | Result |
| - | - |
| `/moshi subscribe <notification>` | The notification posts in this channel. |
| `/moshi subscribe` | Moshi asks which notifications post in this channel. |
| `/moshi unsubscribe <notification>` | The notification stops in Slack. Run it in the channel where the notification posts. |
| `/moshi status` | Moshi shows where each notification posts. |
| `/moshi help` | Moshi lists the commands, the notification names, and a link to your notification settings. |

Any member of your Slack workspace can run `/moshi status`.
To subscribe or unsubscribe, you must be a Slack workspace admin or the person who installed the Moshi app.

Unsubscribing in Slack does not stop email notifications.
Use the Email switch in Notifications for email.

## Troubleshooting

| Message or symptom | What to do |
| - | - |
| Only org admins can change notification settings. | Ask an organization admin to make the change. |
| Slack access was removed from your workspace. Reconnect to keep getting notifications. | Select Reconnect Slack and approve the Moshi app again. |
| Reconnect Slack to use /moshi in your workspace. | Select Reconnect Slack and approve the new permissions. |
| Moshi can't post to one of your Slack channels. Pick another channel. | Check the default channel and the channel of each notification. Select a channel that exists and that @Moshi can use. |
| Invite @Moshi to this private channel first. | Invite @Moshi to the channel in Slack. Then select the channel again. |
| This channel is shared with another company. | Select a channel that only your team can see. |
| This channel is archived. | Unarchive the channel in Slack, or select another channel. |
| Slack did not find this channel. | Select another channel. |
| The notification rows have no Slack columns. | You have no Moshi Slack app and no shared channel with Moshi. Connect the Moshi Slack app. |
| The Slack channel column shows a channel name, but you cannot change it. | Notifications post to your shared channel with Moshi. Connect the Moshi Slack app to choose channels. |
| The notification rows have no Email column. | Save a notification email. |
| Email notifications do not arrive. | Check the Notification email address and the Email switch of the notification. Check your spam folder. |


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