Jump to: navigation, search

How to deploy Bot Gateway Server

Prerequisites

Compatibility matrix

Bot Gateway Server (BGS) version Digital Messaging Server (DMS) version
9.0.004.08 9.0.001.10

Deployment

  1. Install the Bot Gateway Server either by manual installation of the IP or via the GAX deployment procedure. During the installation, you'll need to select the previously installed dedicated instance of DMS. The content of the IP will be installed in the folder media-channel-drivers\channel-chatbot.
  2. In Interaction Server application, add DMS application to connections tab.
  3. Using GAX, do the following in the DMS Application object:
    1. Add connection to the following applications:
      1. Interaction Server (required for core functionality)
      2. Universal Contact Server (required for API methods for file attachments and structured messages only).
        Note: If you decide not to use these methods and not connect DMS to Universal Contact Server, you must set ucs-in-use to false.
    2. In the Application Options tab:
      1. Remove the following sections: [channel-any_name], [channel-any_name-monitor-any_name], and [endpoints:tenant_dbid].
      2. Import options from the file BotGatewayServer.cfg (located in the media-channel-drivers\channel-chatbot\options subfolder in the DMS installation folder). You must de-select the check box Overwrite existing options. This step adds sections [channel-chatbot], [channel-chatbot-monitor-addp], and [channel-chatbot-monitor-tls].
      3. In section [channel-chatbot], set the correct value for option tenant-dbid (for example, tenant-dbid=1).
    3. Start DMS and observe logs. The following log message indicates success: Std 42111 (ChannelConnectors).(configure): channel initialized - channel-chatbot.
    4. Important
      Please note that while some configuration options which are applicable to new chat session can be updated during runtime, it is generally recommended to restart DMS upon application configuration changes.

How to uninstall or upgrade BGS

To uninstall or upgrade BGS, do the following:

  1. Backup the content of the folder “media-channel-drivers\channel-chatbot\bots-repo”.
  2. Stop the DMS/BGS application. This can be done via GAX (on Windows it can be done via Services).
  3. Uninstall the BGS application:
    • On Windows through Control Panel > Programs and Features.
    • On Linux by running the ./uninstall.sh, script from the "media-channel-drivers\channel-chatbot\uninstall" folder.
  4. Verify that the folder “media-channel-drivers\channel-chatbot" was removed.
  5. Install the new version of BGS and populate the folder “media-channel-drivers\channel-chatbot\bots-repo” from your backup.
  6. Start the DMS/BGS application.

How to test BGS

To test BGS, complete the following steps:

  1. Activate the preinstalled EchoBot:
    1. In the Application Options tab of the DMS Application object, add the section [channel-chatbot-monitor-bots] and option EchoBot.jar={}.
    2. Restart the DMS application.
      Note: Several other bot samples are provided. You can find out how to deploy and use these other sample bots by reading the "readme.txt" file located in "media-channel-drivers\channel-chatbot\samples\demo" of the DMS installation folder.
  2. Deploy the sample workflow (located in the subfolder media-channel-drivers\channel-chatbot\workflow in the DMS installation folder):
    1. Import the business process:
      • either from ChatBotsGoBP.wie (require IRD and URS). Activate strategies.
      • or from ChatBotsGo.zip (requires Composer and ORS). Run Generate All (ignore the error against "RESTProxy.jsp").
    2. If you have more than one DMS instance running (and configured in connections of Interaction Server application), you need to select your Bot Gateway Server application in the External Service block which starts the bot (located in Start strategy).
  1. Launch the Chat Widget with the following userdata:
    { ChatBotID: "EchoBot"
    , ChatBotName: "EchoBot"
    , ChatBotHoldup: "false"
    , StopBotOnAgentArrival: "false"
    , StopBotOnCustomerLeft : "false"
    , Visibility : "ALL"
    , Nickname : "Demo Echo Bot"
    , _umsChannel : "channel-chatbot"
    }
    
  2. As soon as the chat session starts in the Chat Widget, EchoBot connects and it echos every posted message into the chat session. You can stop EchoBot by sending one of the following texts in the chat session:
    stop:keep_alive
    stop:force_close
    stop:close_if_no_agents
    stop
    
  3. Note: In waiting mode (in other words, when ChatBotHoldup=true), with default configuration of holdup-attribute-name (which is “ScheduledAt”) Bot Gateway Server relies on the scheduled interactions functionality of Interaction Server. If this conflicts with your workflow logic, you can set holdup-attribute-name to another value. In this case you will need:

  • To modify Interaction Server database schema and create correspondeing interaction custom property of type “timestamp” (refer to Custom Properties in the eServices Interaction Properties Reference Manual).
  • To specify view condition in “Waiting” queue instead of using “Scheduling” (which then must be set to “Ignore Scheduling”).

Configure secure and ADDP connections

You can configure the following secure and ADDP connections:

Connection Configuration
  • DMS to Configuration Server
  • DMS to Message Server
  • DMS to Interaction Server
  • DMS to Universal Contact Server
  • Interaction Server to DMS
Use standard Genesys approach to provide TLS configuration on hosts, applications, ports, and ADDP parameters in connections
DMS/BGS to Chat Server Use a special approach described below.

Secure connection to Chat server

When connecting a bot instance to a chat session, Bot Gateway Server connects to the host/port which is specified in the userdata of the interaction as ChatServerHost/ChatServerPort. If a port is configured as secure, Chat Server also attaches ChatServerConnType=tls. When Bot Gateway Server detects this property in the userdata, it tries to establish a secure connection. To configure these secure connections, you need to use section [channel-chatbot-monitor-tls] of the DMS application:

  1. Set option provider to a desired security provider (see description of options for more information). By default, a provider is set to ANY, which will allow you to establish a secure connection without using any certificate. This mode is recommended for testing purposes only.
  2. Configure option trusted-ca with corresponding certificate.
  3. Review and configure (if needed) all other options in this section.
    Note:

ADDP connection to Chat server

Use section [channel-chatbot-monitor-addp] in order to configure ADDP connection to Chat Server.

Enable Reporting for BGS

Genesys Historical Reporting Solution provides reports about chat bots that are run by BGS. The reporting solution consumes reporting data from BGS via Kafka integration. For full information, see Integrating BGS with Genesys Historical Reporting.

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on December 12, 2018, at 10:06.