This site is no longer updated.Go to new Conversational Cloud docs

Webim v2

Webim is an online consulting platform. Multiple channels can be used for communication: chat on the site, messengers, social media, chat bots, mobile applications and others. The platform also integrates with CRM and HelpDesk systems.

Webim on the JAICP platform can be connected as either an incoming or an outgoing channel. Connection of the Webim v2 channel is covered in this article. Bots can be enabled via External Bot API 2.0 for this channel.


Webim v2 configuration

Sign in to the Webim platform as administrator. Click Settings > Bots in the control panel.

Start creating your new bot by specifying the following:

  • Bot operator — select the operator to assign the bot to. We recommend creating separate operators for bots.
  • Bot type — select Smart bot
  • Sort order — defines the position of the bot in the bot list. The lower the number, the higher the priority.
  • Status — select bot status.
  • Version — select version 2.
  • External API reference — specify https://example.com. You will need to replace this link after you connect the channel on the JAICP platform.

Click Save. Copy the authorization token: you will need it when you create your channel in JAICP.


Creating a channel

Click Channels > Incoming > Create channel on the control panel. Select Webim v2 under Others.

Fill out the following fields:

  • Name — specify a name for the channel or keep the default one.
  • Access token — paste the previously copied token.
  • Email — specify the email address of the Webim service administrator account.
  • Password — specify the password of the Webim service administrator account.

Administrator account credentials are only required to retrieve the list of operators.

  • Domain — specify the domain where the Webim service is being deployed. E.g., for https://examplecom.webim.ru the domain is examplecom.
  • Whether to send /start at the start of a conversation  — when enabled, the bot starts a conversation without waiting for a message from the client.
  • Branch — specify the project branch to be rolled out in the channel. The default setting is master.
  • Deploy — select Automatic (each time any change made to the project is saved) or Manual (using the Publish button in the channel description line).

Please note the Deploy radio button. You have to deploy a script before starting the chat bot. At this stage, the system builds the chat bot, checks scenario and script syntax and performs tests.

Click Create. Wait for a pop-up window with the deploy result to appear.

API Endpoint is generated after the channel is created. Open the channel for editing and copy the API Endpoint value. Then return to Webim and open the bot for editing. Replace the value of the External API reference with the API Endpoint you have copied.


Testing a bot

Open the bot dialog window in the connected messenger and send a welcome/activating phrase to it according to your script. Then a dialogue with your bot should start.