Roomlio Notifications
Email Notifications
Roomlio allows you to keep your app and embed users informed of messages that they have missed by sending them an email. If a user happens to be away from a room that they belong to, Roomlio will automatically send an email to them that will have a link back to the room in question.
EMBED USERS
To utilize this feature you first have to make sure Roomlio has an email for your user. One way of attaching an email to a user is to send in the email when you are registering the user in the rml('register')
or rml('registerSecure')
API calls.
// Sample rml('register') call with an email
rml('register', {
roomElementID: '<your-div-id-to-replace-with-embedded-room>',
options: {
// Room options
roomKey: 'royals1234',
roomName: 'Royals-Baseball',
// User options
userID: 'abc1234',
displayName: 'salvi',
first: 'Salvador',
last: 'Perez',
email: '<user email here>', // HERE IS WHERE TO PASS IN THE EMAIL
traits: {
color: 'blue',
account: 'acct1234',
plan: 'pro',
},
},
});
If you're leaving the user naming up to Roomlio or just don't want to send in the email via one of the register calls, you can use Roomlio's user identify form and ask your user to supply an email. The user identify form can be enabled on the User Identify Form tab of the app's widget settings (be sure to enable the email option and turn on the form). Or you can send in a selfIdentifyFormFields
option in the rml('config')
API call to enable the user identify form if you would rather not rely on the Roomlio app (NOTE: the selfIdentifyFormFields
option in the config call will override the User Identify Form settings in the app). Then when a new user of the room focuses on the message input form, they will be prompted to fill out the user identify form with their email. The "I want to receive email notifications" checkbox will need to be checked when the new user submits the form to give Roomlio permission to send them an email.
Then, when the user steps away from the room they will be notified by email when new messages come into the room. The user will be able to click a button in the notification email to navigate back to the room on your page.
APP USERS
App users will already have an email since one is required to use the Roomlio app. To enable email notifications, just go to Settings > Notifications in the app and toggle Email to "ON". Then if the app user misses a message in a room in which they are a member, a notification email will be sent and the app user will be navigated to that room when they click the button in the email.
OPTING OUT
An embedded user can opt out from receiving email notifications four different ways:
1. Unsubscribe via the "Unsubscribe" link in the notification email.
2. Toggling off the room menu Email Notifications toggle.
REMEMBER: if there is no email associated with the Roomlio user, they will not see any of the Email Notifications toggles.
3. Toggling off the room top bar Email Notifications toggle (Optional).
The room top bar email notifications toggle can be switched to a bell icon by sending in the topBarNotificationsToggleType: 'bellIcon'
option in the rml('config')
API call. Also, this toggle can be hidden by sending in the topBarNotificationsToggle: false
option in the same rml('config')
call.
4. Unchecking the Edit Profile form (aka self identify) "I want to receive email notifications" checkbox which can be access by selecting Edit Profile in the top right room menu.
App users can disable email notifications by either unsubscribing via the "Unsubscribe" link in the email notification or by going to Settings > Notifications in the app and toggling Email to "OFF".
Push Notifications
Roomlio doesn't have push notifications right now.