A Do adapter for hubot
Do Chat joins the power of Tasks, Projects, and Notifications with simple real-time discussions, so your team can Do and plan practically anything. Do Chat is in Private Beta. If you're interested in testing Chat before it's launched, send an e-mail to firstname.lastname@example.org.
Create a new Do account for your robot to use. To simplify things,
you might invite a user to your group from the sidebar.
Tip: You can use
email@example.com to create a new
account without a seperate email address.
You'll need to apply for Do OAuth v2 credentials. This typically takes less than a day, and will be automated in the next few weeks.
Download the latest Hubot package.
.tar.gz file somewhere convenient, perhaps in
hubot/package.json and add
hubot-do to the dependencies
section. It'll look something like...
"dependencies":"hubot-do": "latest""hubot": ">= 2.3.2"
Procfile and either add or replace the existing process to
enable Hubot for Do. You can also use the
-n option to name your
robot. We call ours 'Cylon'.
web: bin/hubot -a do -n Cylon
Initialize a git repository in your hubot directory.
cd hubotgit initgit add .git commit -m "Initial Commit"
Install the Heroku Toolbelt if you haven't already.
Create a Heroku application, and give it a cool name.
heroku create mysterious-robot
We recommend adding the free Redis To Go add-on so your robot can remember things. Memory is nice.
heroku addons:add redistogo:nano
Setup the Do Hubot Adapter by adding your OAuth v2 credentials and your Hubot user's username and password.
heroku config:add HUBOT_DO_CLIENT_ID=130f5290f86737a8a387ec335db5ea18f1db2160 \HUBOT_DO_CLIENT_SECRET=a4db718b998b87ff2e090c69c4918083a3834dfe \HUBOT_DO_USERNAMEfirstname.lastname@example.org \HUBOT_DO_PASSWORD=mariposa
Security Advisory: The user you created in step one will have access to your group just like any other. Additionally, anyone you add as a collaborator to your Hubot app on Heroku will be able to extract the password from the application's runtime. Don't use the same password as your personal account.
If you're developing applications atop the Do platform, or wish to
hubot-do, you can have
hubot-do log activity on
heroku config:add HUBOT_DO_DEBUG=true
HUBOT_DO_DEBUG_VERBOSITY variable allows you
to specify the granularity of log messages you wish to receive.
Currently, events and errors are visible at level
2 and the full
text of our push payloads are visible at level
With your fingers crossed, and heart set, deploy and start your Hubot instance!
git push heroku masterheroku ps:scale web=1
Login to [Do] with your Hubot's e-mail address and password. Then join any chat rooms you'd like it to participate in. Future releases of hubot-do will automagically join all available rooms.
To run your Hubot for Do locally, you should
touch .env in your hubot
directory and define your enviroment variables there. Learn more about
Foreman and .env files.
The use of the Do API is subject to the terms and conditions found at do.com/legal. Take care to note Section 8.4:
Any Non-GA Services will be clearly designated as beta, pilot, limited release, developer preview, non-production or by a description of similar import. Non-GA Services are provided for evaluation purposes and not for production use, are not supported, may contain bugs or errors, and may be subject to additional terms. NON-GA SERVICES ARE NOT CONSIDERED "SERVICES" HEREUNDER AND ARE PROVIDED "AS IS" WITH NO EXPRESS OR IMPLIED WARRANTY. We may discontinue Non-GA Services at any time in Our sole discretion and may never make them generally available.