Slides and assets for the Shazbot workshop [first presented at Toronto Ruby Hack Night, May 11, 2016]
Workshop for learning Chatbots and Slack
Created by David Andrews and Jason Schweier
Slides for the workshop are here:
https://gnab.github.io/remark/remarkise?url=https://raw.githubusercontent.com/k00ka/shazbot/master/SLIDES.md
###Introduction
This project is a simple Ruby + Slack project. If you follow the instructions below, you can test your machine in advance of the workshop.
We have provided a repository which mimics the setup we used last time, so it should be familiar. The code to be created is found in the lib/ directory.
###Setup
Here are the steps to get you started with the repo.
- For this workshop, you will need a laptop with the following:
- Ruby 2.x
- A Github account
Note: We have included a .ruby-version file locked to 2.2.3, which you can change to any Ruby 2.x version if you don't have 2.2.3 installed
More detailed instructions for each platform are included in the footer. Refer there if you are having issues.
-
Fork the repo (optional, recommended): From the page https://github.com/k00ka/shazbot, click the Fork button in the top-right corner. Copy the new repo address (in a box just below the thick red line) into your clipboard. Detailed instructions on forking a repo can be found here: https://help.github.com/articles/fork-a-repo/
-
At Ryatta Group we use rbenv, and so we've included some optional elements - just skip them if you're using rvm or are not versioning your Ruby. If you forked the repo above, your repo_address will be in your clipboard. If not, you should use my repo_address
git@github.com:k00ka/shazbot.git
% git clone <repo_address>
% cd shazbot
% gem install bundler
Fetching: bundler-1.7.4.gem (100%)
Successfully installed bundler-1.7.4
1 gem installed
% bundle
Fetching gem metadata from https://rubygems.org/.........
Resolving dependencies...
Installing rake 10.3.2
...
Using bundler 1.7.4
Your bundle is complete!
Use `bundle show [gemname]` to see where a bundled gem is installed.Note: if you use rbenv...
% rbenv rehashYou are (almost) there!
- In a web browser, go to slack.com and log in,
- Click on Your teams in the top right corner, and choose TorontoRB,
- If TorontoRB is not there, surf to slack(dot)rubytoronto(dot)com and sign up,
- Choose Apps & Integrations from the side menu,
- Choose Build you own in the top right corner,
- Choose Make a Custom Integration on the right side,
- Choose Bots under Build a Custom Integration,
- Under bots, choose a username for your bot - make it unique and end with “bot”, and click Add bot integration,
- Copy the API token, finish the form and click Save integration,
- Back in slack, in the TorontoRB group, choose Open a Direct Message “+”,
- Type in the name of your bot, and click Go,
- Create and export a shell variable with your token and run your bot.
- You are now able to direct message “DM” your bot!
- Try setting a breakpoint in the Behaviour::Handlers#say_hi method and triggering it by typing "hi" into your chat.
