Enable and configure push notifications for your workspace members using mobile devices.
{% hint style="info" %} By default, community workspaces come with 10,000 free monthly push notifications. If you need more, please contact us to discuss upgrading to an Enterprise plan. {% endhint %}
{% hint style="info" %} To be able to use push notifications, you are required to accept the Cloud Service Privacy Terms Agreement in the Administration > Workspace > Settings > Setup Wizard > Cloud Info settings. {% endhint %}
To enable push notifications:
- Go to Administration > Workspace > Settings > Push
- Enable: Turn on to enable push notifications on your Rocket.Chat instance
- Enable Gateway: Setting this to true allows you to use a custom push notification gateway
{% hint style="info" %} Rocket.Chat SaaS workspaces use the Rocket.Chat gateway by default and cannot be changed.
On self-managed workspaces, you can either use the default Rocket.Chat gateway or set up a custom notification gateway. {% endhint %}
- Gateway: Specify the gateway to use. Multiple lines can be used to specify multiple gateways
- Production: Enable this for workspaces in production
With the configuration all done, you can Send a test push to my user to send a test push to yourself.
{% hint style="info" %} To successfully send a test push to your user, you need to be logged in to the workspace on your mobile device and then close or minimize the application. {% endhint %}
In Privacy, you can configure what information you want your push notification to have.
- Show Channel/Group/Username in Notification: Toggle this on to make the channel name, group name, and username visible in notifications.
- Show Message in Notification: Enabling this makes messages visible in notifications.
- Hide message content from Apple and Google (and the Gateway, if enabled): Turn this on to hide the content of a message from Google/Apple or any other push gateway.
This adds only the message id to the notification data. The mobile client dynamically fetches the content from the server and updates the notification before displaying it.
{% hint style="info" %}
For Enterprise workspaces, failure in fetching a message using the message id provided in the push data results in a "You have a new message" being sent.
{% endhint %}
With the push configuration completed, follow this guide to set the default user preferences for notifications #default-user-preferences.
Manage channel-based notifications using the
{% content-ref url="broken-reference" %} Broken link {% endcontent-ref %}
{% hint style="info" %} On some channels, notifications can stop if the number of users exceeds the set limit. The limit is set in the Administration > General > Notifications. #notifications {% endhint %}
When you purchase a package for push notifications as a self-managed customer, you need to connect your workspace Rocket.Chat Cloud.
Link and sync your account in the Connectivity Services menu.
{% content-ref url="../connectivity-services.md" %} connectivity-services.md {% endcontent-ref %}
To check the count of notifications used per month:
- Go to cloud.rocket.chat
- Switch to the Workspaces tab
- Select the workspace you want to check the count for
- The push notifications block shows the number of used notifications per your current limit per month.