Difference between revisions of "LingoBot Slack Setup"

From Lingoport Wiki
Jump to: navigation, search
(Created page with "This portion of the installation guide only applies if the collaboration environment you will be using is Slack. If you will be using either Flowdock or Cisco Spark, please sk...")
 
Line 9: Line 9:
 
* On this page, you can set a custom icon for the bot under the "'''Customize Icon'''" section. You can download the following icon [[File:Lingoport logo small.jpeg|30px]] and upload it, upload your own custom icon, or simply leave it blank.
 
* On this page, you can set a custom icon for the bot under the "'''Customize Icon'''" section. You can download the following icon [[File:Lingoport logo small.jpeg|30px]] and upload it, upload your own custom icon, or simply leave it blank.
 
* Once this is done, scroll down to the bottom of the page and click "'''Save Integration'''"
 
* Once this is done, scroll down to the bottom of the page and click "'''Save Integration'''"
* Finally, copy the API Token that is provided near the top of the page and paste it into the LingoBot configuration file next to the HUBOT_SLACK_TOKEN variable declaration.
+
* Finally, copy the API Token that is provided near the top of the page and paste it into the LingoBot configuration file ('''/var/lib/jenkins/lingoport/lingobot-2.1/config/lingobot_config.sh''') next to the '''HUBOT_SLACK_TOKEN''' variable declaration.
   
 
Example:
 
Example:

Revision as of 17:49, 9 August 2018

This portion of the installation guide only applies if the collaboration environment you will be using is Slack. If you will be using either Flowdock or Cisco Spark, please skip to the corresponding setup instructions.

  • Navigate to the Slack Custom Bot Creation page, and log in as an account that is a part of your company's Slack organization.
  • In the new bot username field, enter the name that you would like LingoBot to respond to.
    • By default, we recommend simply calling it "lingobot", however you're welcome to name it whatever you would like.
    • If you do choose to call it something other than "lingobot", make sure that you set the LINGOBOT_NAME variable in the configuration file to whatever name you chose.
      • Example: export LINGOBOT_NAME=lingobot-123
  • Once you have decided on a name, click "Add Bot Integration" to continue to the next page.
  • On this page, you can set a custom icon for the bot under the "Customize Icon" section. You can download the following icon Lingoport logo small.jpeg and upload it, upload your own custom icon, or simply leave it blank.
  • Once this is done, scroll down to the bottom of the page and click "Save Integration"
  • Finally, copy the API Token that is provided near the top of the page and paste it into the LingoBot configuration file (/var/lib/jenkins/lingoport/lingobot-2.1/config/lingobot_config.sh) next to the HUBOT_SLACK_TOKEN variable declaration.

Example:

export HUBOT_SLACK_TOKEN=xoxb-1234567890000-aAbBcCdDeEfFgGtTfF

Furthermore, make sure the LINGOBOT_ADAPTER variable is set to "slack".

Example:

export LINGOBOT_ADAPTER=slack

Once this is complete, the bot is now configured and ready to be installed! Follow the instructions below on running the installation script to finish the installation process.

Skip to the next step: Running The Installation Script