Frequently asked questions

Creation and integration

How do I create the chat?

You can create the chat in several ways:
1) The easiest and most convenient - via the chat constructor.
2) Using the WordPress plugin.
3) Dynamically create the chat via chatPath.

How to integrate the chat on website to work login via the website?

Detail info.

How to log out of the chat?

In the chat menu (if it's on). If the chat is integrated into a website, it's enough to log out from a website.

How to add my authorization method to the existing one?

For example, like this.

Sync up with messengers

How to link Telegram group/supergroup with the web chat?

To add @ChatbroBot to the right group. Bot will send a link via a personal message, by which you can link the web chat and the Telegram group/supergroup.

How to link the Telegram channel with the web chat?

To add @ChatbroBot to the selected channel as an administrator and type "/sync" in the channel. The bot will send a link for synchronization.

I can not add the bot to the channel

Use the desktop version of Telegram. Add the bot as an administrator (you can not add the bot as a common user).

Is your service suitable for broadcasting the Telegram channel to the website?

Our service is great for this. To send messages to one side (channel -> web chat), configure the web chat so that it does not allow sending messages. Additionally, you can configure the bot so that it can not write to the channel.

How to link Vk conversation with the web chat?

Detail instruction how to add bot.

The bot ceased to synchronize messages/synchronized in one side

If you have some sync problems with telegram, make sure that your bot's privacy mode is disabled. You can check it with BotFather. Contact us if you still have problems.

How to remove the synchronization of the web chat with a group/conversation?

There are a couple of ways to do this:
1) Delete the bot from the conversation/group/supergroup/channel. Synchronization will be automatically deleted, an alert will be sent to the private messages.
2) In the chat editor in the "Synchronization with messengers" block, you can see all active links and delete it.

Can I add my bot to synchronize messages?

You can add your bot. It will work just like the standard one and you will can to control over it. There are 2 types of bots: Telegram and VK. VK bot is any empty or unused page in the social network. To add a bot, follow these steps:
1) Authorize.
2) Go to your profile using the site navigation.
3) Click the "Add your bot" button, select the bot type and enter the authorization data. Then click the "Add" button. If the data is correct, the bot will be added and automatically turned on.


How to add new administrators to the chat?

The administrator in the chat can be only one. But you can add moderator. He be able to ban users and delete messages.

How to add new moderators to the chat?

Moderator can be appointed in two ways:
1) Via the message menu. A potential moderator should log in and write something to the chat. Press "Menu" on his message and select "Set moderator status".
2) Pass to the ChatbroLoader the required set (permissions: ['ban', 'delete']) of rights for a particular person. Used only when spoofing protection is enabled. Example of use.  Detail info.

How to limit the visibility of chat for unauthorized users?

Make a condition in the page's template. If the user is logged in, then show the chat, otherwise - no.

How to allow chatting to authorized users only?

In the chat constructor, the "User authentication" section, disable the "Visitor with a temporary name".

What are the methods for dealing with spammers, trolls?

You can configure flexible filtering of messages on the server and on the client (not efficiently).

How to configure message filtering on a server?

In the chat constructor the "Administration" section a button "edit function". Clicking will open the editor with a couple of examples.

How to configure message filtering on the client?

This is described in detail here.

How to ban and to delete users?

Only the administrator and moderators can to ban users and to delete messages. Place the cursor to the desired message, via the menu that appears, you can take the appropriate action.
You can experiment with site example.

What is a hidden ban?

If you ban a user and indicate a hidden ban, the intruder will not suspect about it. He will also continue to write in the chat, but only he will see his messages.

How to unban a user?

The administrator has a link to the list of all banned in the chat menu, where he can unban them. The second way - to ban a user again for a minute.

What is the spoofing protection and how to use it?

Spoofing is the situation when a person or a program successfully masks under another way of falsifying data and receives illegal benefits. For example, in the chat one person can write under the guise of another. The spoofing protection excludes such situations. This is described in detail here. Example of a chat with the spoofing protection.

How to calculate the signature correctly?

This is described in detail here.

How to use permissions?

You can experiment with site example.
Code on Github
Another example


How to embed a history widget?

There is no such option in the plugin.

How to link Telegram group/supergroup with the WordPress web chat?

Select the "ChatBro" plugin in the site admin area to link ChatBro with WordPress.

You can design the chat in the constructor. You are logged in with the name of the admin of your WordPress. The chat create with the help of the UUID, which generated by plagin. The UUID is used as a secret chat key. Save it (see the following screenshot) lest you should lost access to the chat.

Your secret key.

Omit this step if you have already a Telegram group, with which you want to link the chat. If not, click "create group".

Click on the menu above (step 1) and select "add members" (step 2).

Enter "ChatBroBot" in the search, select the bot (step 1) and click "next" (step 2).

The bot sent a message with a link to the group. You need to open the chat constructor in WordPress via a browser, that you can join chat by clicking on the link. Click on the link.

You join the chat with a bot. Click on the link that it offers you.

You have moved to the constructor. Here you can see the names of chats. Click the "Sync" button in the desired chat.

Done. You can write from the Telegram and messages will be displayed in the chat.

You can write from the chat and users will see messages in the Telegram group.

How to add one more chat on WordPress?

This is not possible, since the hierarchical connection between chats is not supported.


Why does the mismatch domain error occur?

You entered an incorrect domain or domain does not match the referrer. Correct the domain and the error will disappear.

Why does the signature error occur?

This is described in detail here.

Why does not the chat appear on the page?

Contact the support and specify the site and chat id.

I have problems with the chat imposition

Contact the support and specify the site.


Do you have documentation?

Documentation is available here.

How to make a sound in the chat?

There is no built-in mechanism in the chat, but you can do this.

What about private messages?

There are no personal messages yet. If a user is authorized in the chat via the social network, his name and avatar will be a link to the profile in the social network and you can contact him.

How is your load?

This is described in detail here.

How to make full screen chat?

You can make it like this.

I do not like the design. It does not harmonize with my site

The chat does not use an iframe. This means that the original styles can be redefined to fit your needs.

I have a couple of great ideas for the chat, with whom to share?

You can contact us.

I want to see the chat in my language, how to help with this?

You can help translate the site to your language here.