Setup Guide

After adding AtomChat to your website, there are a lot of ways that you can configure it to meet your requirements. 

We've listed down some questions with their solutions to help you with the setup! 

1. How do I disable/hide the Contacts, Recent Chat list, or Groups tabs? 

Go to your AtomChat Admin Panel (https://app.atomchat.com/licenses) -> Settings - > Contact Configuration. There you will find three settings -> “Display Recent Tab”, “Display Contact Tab”, and “Display Group Tab”. 

You can disable any tab as per your requirement. 

2. How do my users create groups? 

From AtomChat's Layout - 

In the chat layout header, you will find the pencil icon, click on that. You will then see the “New Group” option, click on that.

The “New Group” window will get opened. There you need to enter the group name, and group type. From here, you can create three types of groups 

1. Private Group – will be visible only to the users who are added to it. 

2. Public Group – will be visible in the Groups list and everyone can access it 

3. Password Protected Group – will be visible in the Groups list to everyone, but only the users who have the password can access it. 

Once you have entered the group name and group type, click on Create Group. The newly created group will be visible in the Groups tab under “JOINED GROUPS”.

3. How can I create Groups as an Admin?

Open the Groups section from your AtomChat Admin Panel, there you will see the “Add New Group” section. Here you need to enter the GUID (Group’s Unique Id), group name, and group type and click on “Add Group”.

The added group will be visible in the Groups list in your Admin Panel. 

In the layout, these groups are visible in the Groups tab under “OTHER GROUPS” if you have not joined the group or under “JOINED GROUPS” if you have joined the group. 

From CometChat Admin Panel, you can create three types of groups: 

1. Embed Only Group – which you can embed independently anywhere on your website. 

2. Public Group – which is visible to everyone and any user can access it. 

3. Password Protected Group – which is visible to everyone, but accessible only to the user who has the password.

4. How to use AtomChat's Restful API to create Groups 

You can create a group using the “Create Group” Restful API. Here you need to pass the GUID (Group’s Unique Id), Group name, group type, password (if creating password protected group), and your API Key. 

The added group will be visible in the Groups list beside the “Add New Group” section. 

With Restful API, you can create three types of groups

1. Private Group – which is visible and accessible to the member of that group only.

2. Public Group – which is visible to everyone and any user can access it. 

3. Password Protected Group – which is visible to everyone, but accessible only to the user who has the password. 

For Restful API, please refer to 

https://help.atomchat.com/support/solutions/articles/82000892778-groups

5. How to add users to a Group? 

There are two ways to add users to a Group 

1. From AtomChat's Layout (frontend) - 

Open the Group chat box where you want to add users. 

Open the group menu. For the docked layout, there is an arrow beside the Group name and for the embedded layout, there are three dots. 

Docked layout:

Embedded Layout: 

Once you click on Add Members, you will see the list of the users available, you can select the user you want to add and click on add button. 

If it is a Public Group, then a link to join the group will be sent as a private message will be sent to that particular user. They can click the link and join the group. 

If the group is a private group then the user is added to the group directly.

You can add users to a particular group using our “Add User To Group” Restful API. For Restful API, you can refer following -

https://help.atomchat.com//v1/docs/groups#-add-users-to-group (https://help.atomchat.com//v1/docs/groups#-add-users-to-group) 

(https://developer.cometchat.com/reference#add-users-to-group) 

7. Where can I see Group Members

If you want to see the members of a Group, then the “View Members” option is available in the individual group chat box. 

Open the group chat box where you want to view users. 

Open the group menu, i.e for the Docked layout there is an arrow beside the the group name and for the embedded layout, there is a three dots icon. 

Docked Layout 

Embedded layout

Once you click on the view member option, the group member list will be visible.

8. How to turn off Sound Notifications? 

You can disable the sound notification from the Sound section in your AtomChat Admin Panel. 

You will find two panels over there, Message Sounds and Audio Video/ Audio Call Sounds. Under "Message Sounds", set the setting "Do you want custom Message sound?" to "Yes". Once you set this to "Yes", it will show you an option to upload the ringtone. 

You need to upload a silent or blank mp3 file here. And the same applies to "Audio Video/ Audio Call Sounds" too if you want it to be muted.

Once you make the above changes, please clear the browser cache completely and then check or you can test on a private/incognito browser window.

9. Where can I see all announcements? 

In the chat layout, in the header section of the chat, you will see a bell icon, just click on that. If your admin has added any announcements, you will be able to see all announcements here.

How to add an Announcement as an Admin 

From your AtomChat Admin Panel, please go to Announcements. Here, you can add your announcement which will be visible to your users when they click on the 'Bell' icon!

10. How can I change AtomChat's Font?

You can add a Custom Font or Google Font to change AtomChat's default font. The steps are as follows -

1. First, you need to save that particular font on your server. For example, if you want to add the Google font Muli, then you need to save Muli.ttf file on your application server. 

2. Then you need to allow the domain https://APP_ID.cometondemand.net/ into the security header. 

Please remember, you need to replace APP_ID with your own AtomChat App ID. 

Text Copy Access-Control-Allow-Origin: https://APP_ID.cometondemand.net/ 

3. Then, go to your AtomChat Admin Panel -> Settings -> Editor -> select Custom CSS from the dropdown and add the following code -

@font-face {

font-family: myFirstFont;

src: url(<https://abc.com/Muli/Muli.ttf>);

}

#cometchat * {

font-family: myFirstFont !important;

}

In this code, you need to add the URL where you have saved the font file on your server.

Remember to Enable Custom CSS!

The added font will now reflect on your website's AtomChat layout. 

11. Where can I check my SMTP configuration for Email Notifications? 

There are multiple tools available online to check your SMTP configuration. We recommend 

https://www.gmass.co/smtp-test 

Here you can test your SMTP configuration first, if it works properly, then you can use it for AtomChat's Offline Email Notification setup and also for the Report Conversations feature. 

12. How do I use AtomChat's Advertisement Feature? 

From your AtomChat Admin Panel, go to Features -> Other Features -> There is a setting button next to "Advertisement", click on that -> Add your advertisement HTML code there -> Save it. 

Once the code is added, go to AtomChat on your website -> refresh the page and you will see the added advertisement in the chat box bottom (for embedded) and top (for docked).

Docked layout: 

Embedded layout: 

13. How can my users block other users? 

With AtomChat's Block User feature, your users can block troublesome or unwanted users from their chat contact list. Once any user is blocked, all communication to and from the respective user will be completely blocked. 

There are two ways to block users: 

i. From AtomChat's layout 

Open the chat box of the user you want to block and open the user menu. You will find the “Block user” option here, click on it. Then that specific user gets blocked. 

Docked Layout: 

Embedded Layout: 

ii. Using our “Block User” Restful API 

You can block any user using Using the “Block User” Restful API. Here you need to pass senderUID (UID initiating the block), receiverUID (UID of the user being blocked), and your API Key. 

Please refer to - 

https://help.atomchat.com/support/solutions/articles/82000892776-users

NOTE: If you block a user using the Restful API, it will take some time (at least 60 seconds) to reflect in the chat layout.

14. How to unblock users? 

You can unblock users in two ways: 

1. From AtomChat's Layout 

Click on the "more options" icon from the chat layout header (three dots), and the More window will get opened. 

Here, you will see the option “Blocked User” and next to it, the count of blocked users. 

Click on it, and you will see the list of blocked users. 

Click on the user to unblock them. 

2. Using “Unblock User” Restful API 

You can unblock a user using AtomChat's “Unblock User” Restful API. Here you need to pass senderUID (UID initiating the block), receiverUID (UID of the user being unblocked), and API Key. 

Please refer to-

https://help.atomchat.com/support/solutions/articles/82000892776-users - Block User

NOTE: If you unblock the user using Restful API, it will take some time (at least 60 seconds) to reflect in the chat layout.