Chats have become one of the most popular channels of communication and now you have the possibility to use it to get in touch with the visitors to your website. Users will see a small icon that displays the chat window in the bottom-right corner of your website. It’s a great way of providing your customers or potential customers with real-time assistance.


  1. Log in to the Synerise application.
  2. Go to Settings icon Settings > Tracking Codes and create a new tracking code.
  3. Go to Settings icon Settings > Chats and add as a whitelist domain.
  4. In the same Chats section, adjust the chat settings to your preferences.

Chat Options

The Chat class is responsible for defining the appearance and options.

Parameter Type Default Description
trackerKey String null A tracking code from the Tracking Codes section
toolbarBackgroundColor Integer #000 Toolbar background color
toolbarTitleColor Integer #fff Toolbar title color
toolbarTitle String ‘Chat’ Toolbar title
closeButtonAlignment Integer RelativeLayout.ALIGN_PARENT_LEFT Close button alignment
closeButtonText String ‘Close’ Close button text
errorText String ‘An unknown backend communnication error has occurred. Try again in a moment.’ Default error text
errorTextColor Integer #FF0000 Error label color
Note: Remember that the color format should contain a reference to a resource ID.

setCloseButtonImage(Drawable drawable) - Sets a close button image.

Public Interface

load() - Starts loading chat data.

show() - If the widget is loaded, the chat window is shown. Otherwise it shows loading indicator.

hide() - Hides the chat window.


OnChatListener is used to inform developers about the state of a chat.

  • onLoad() - Called after the chat is loaded.
  • onLoading() - Called when the chat is loading its content.
  • onError(Error error) - Called when an error occurs while loading.

Sample Implementation

private void initializeChat() {
        Chat chat = new Chat("5C89955F-9C9F-86A6-607D-211DED21F7BF");
        chat.toolbarBackgroundColor = R.color.charcoal;
        chat.toolbarTitleColor = R.color.white;
        chat.toolbarTitle = "Chat Communicator";
        chat.closeButtonAlignment = RelativeLayout.ALIGN_PARENT_LEFT;
        chat.setCloseButtonImage(ContextCompat.getDrawable(Synerise.getApplicationContext(), R.drawable.ic_arrow_back));
        chat.closeButtonText = "CloseButton";
        chat.errorText = "Sorry for problems!";
        chat.errorTextColor = R.color.amaranth;
        chat.setChatListener(new OnChatListener() {
            public void onLoad() {

            public void onError(Error error) {

            public void onLoading() {

private fun initializeChat() {
  val chat = Chat("5C89955F-9C9F-86A6-607D-211DED21F7BF")
  chat.toolbarBackgroundColor = R.color.charcoal
  chat.toolbarTitleColor = R.color.white
  chat.toolbarTitle = "Chat Communicator"
  chat.closeButtonAlignment = RelativeLayout.ALIGN_PARENT_LEFT
  chat.setCloseButtonImage(ContextCompat.getDrawable(Synerise.getApplicationContext(), R.drawable.ic_arrow_back))
  chat.closeButtonText = "CloseButton"
  chat.errorText = "Sorry for problems!"
  chat.errorTextColor = R.color.amaranth
  chat.setChatListener(object:OnChatListener() {
    fun onLoad() {
    fun onError(error:Error) {}
    fun onLoading() {}


We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.



Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.