Docs Pricing

Basics

The embed code will load a chat room where you place the above <div data-rml-room .../> in your markup. By default it has a width and height of 100% which means it will fill its parent container.

register: The rml('register', ...) part is a Roomlio API call that is required to load the chat room and you should replace the user and room attributes with your own app data.

Each unique value for roomKey will generate new Roomlio rooms. Because the roomKey is specified by you, often dynamaically, we ask which Roomlio App Users should be auto-joined to rooms created by the above embed code. The users you select above, will be notified when a conversation starts in a newly created room and can respond back via the Roomlio App.

Authentication Modes

Roomlio provides two authentication modes. Simple and Secure (advanced)

Simple mode is useful for testing out Roomlio and some use cases where you don't need to be absolutely sure a user is who they say they are.

Secure mode is highly recommended for production environments where you need to guarantee the authenticity of users. Since we use a javascript API to register the users, nothing prevents a malicious user from pretending to be another user by using a browser's dev console. To implement Secure auth mode, base64 encode the payload using the HMAC key (provided above) on your backend before registering the user. Then pass the result to our 'register' API call. We provide an example in the embed code when Secure mode is selected. Here are examples of HMAC base64 encoding in most of the popular languages.

For more details, check out the docs for Roomlio JS API

Please don't hesitate to reach out to Roomlio support for help.