Chat Engine with Custom Frontend
The ability to incorporate Rocket.Chat's chat functionalities in your application with a custom frontend allow you to provide a seamless chat experience while maintaining your desired user experience.
The Chat Engine leverages the use of WebSockets API to enable real-time chat functionality.
Following are some important factors to consider when implementing Chat Engine capabilities using a custom frontend.
Make sure you do all API calls to Rocket.Chat on the backend to avoid exposing sensitive data.
In this scenario, you have your application's login mechanism for end users. However, you need to authenticate the user with Rocket.Chat to provide chat functionality.
To achieve this:
Use a specified Rocket.Chat admin credentials to call the Create User Token API endpoint from your backend for an existing user. This allows your backend service (accessible only to authenticated users on your platform) to request
Authorization tokenfrom Rocket.Chat for the user. Use this token for subsequent requests to Rocket.Chat.
A typical workflow for logging in a user involves the following steps:
- Once a user is authenticated on your platform, your backend service requests a token session from Rocket.Chat for that user. (If you don't have a corresponding user on Rocket.Chat yet, you can create it using the Create User API endpoint).
- The backend receives the
authTokenfrom the Create Token API response.
- These credentials (
authTokenare then used for all subsequent Rocket.Chat API calls and embeddings that require authorization.
authTokenhas an expiry time set. Be sure to refresh when it expires.
When a user navigates to another page, they must be reauthenticated. You can simulate the logout process appropriately by calling the Logout API endpoint. This causes the
You can structure the user interface as much as you can by utilizing the endpoints available.
A typical example is: Upon successful login, the application presents the user with a list of Rooms to which the user has access. When the user selects a room, an iframe is populated with the corresponding embedded URL for that channel or room.
To interact with the rooms and handle user actions, such as opening a room, you can implement event listeners and utilize the Rocket.Chat WebSocket API. The WebSocket API allows real-time communication and provides a seamless chatting experience for users.