Connecting MI Chatbot to Metric Insights

This article details how to finish the MI Chatbot configuration by establishing connectivity between MI Chatbot and a Metric Insights server.

PREREQUISITES:

  1. Deploy MI Chatbot
  2. Build a Slack App
  3. Connect the Slack App to the main MI application

1. Configure Chatbot

Access Admin > Distribution > Slack Integration > Chatbot tab

  1. Clear conversation history after N idle minutes: Set the time period of history clearing
  2. Default search command ("search"/"concierge"): Choose whether Concierge will be used for search commands by default or if it will it be a basic search
  3. Display debug messages: Select whether to show debug messages in the chat where the Chatbot is installed
  4. Enable silent search:
    • "true": If Users send any message in the channel where the Chatbot is installed, the user will receive a message only visible to them with the search results based on user input
    • "false": The bot will not send anything to users unless explicitly invoked via @ messages
  5. Part of URL which specified Bot namespace: Set to /chatbot unless corresponding changes were made in the Apache configuration file
  6. Search in tags: Enables the search in tile tags
  7. Send broadcast messages to channels: Enables notification messages that are sent on restarts or sync fails for all channels where the bot is participating
  8. Show Slack image previews in modal popup: Define how the preview images will be shown:
    • "Y": Images will be shown in a modal popup
    • "N": Images will be shown in the chat
  9. Slack bot user token: Bot OAuth Access Token
  10. Slack platform is used: To enable Slack Integration, set it to "True"
  11. Slack Signing Secret: A secret used to verify Slack requests
  12. Slack socket token: App-Level Token
  13. Slack Web API token: OAuth Access Token
  14. URL where the Bot is installed: URL of the server where the bot is installed
  15. Use Data Analyzer for search: Decide whether to use Data Analyzer for search or not
  16. Verify ssl check for mi requests: Select whether to forbid requests from bot to servers without a valid SSL certificate or via an unprotected HTTP protocol
    • "true": Such requests are forbidden
    • "false": Such requests are allowed
  17. [Save]
  18. [Sync Chatbot]

2. Restart MI Chatbot

In order to restart the MI Chatbot, run the following command:

sudo docker restart mi-chatbot

3. What's Next?

Having restarted the MI Chatbot, you can make full use of the available functionality (getting data from Metric Insights and sharing it in a Slack Channel).