A Hubot script handling webhooks and retrieving info from esa:
Last updated 3 years ago by hmsk .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install hubot-esa 
SYNC missed versions from official npm registry.


npm CircleCI

A Hubot script handling webhooks and retrieving info from esa:


  • Handle received webhooks
    • Post created
    • Post update
    • Post archived
    • Comment created
    • Member joined
  • Retrieve info when someone talking about URL of esa
    • Post
    • Comment
  • Retrieve stats of your team by hubot esa stats


Add to your Hubot project

$ npm install hubot-esa --save

Then add hubot-esa to your external-scripts.json.

Also you need some variables to environment your Hubot runs. See below.

Base Settings

export HUBOT_ESA_ACCESS_TOKEN='access_token'    # Required, your personal access token
export HUBOT_ESA_TEAM_NAME='gingypurrs'         # Required, your team name
export HUBOT_ESA_WEBHOOK_DEFAULT_ROOM='random'  # Required, room name you get notification by webhook
export HUBOT_ESA_WEBHOOK_ENDPOINT='/ginger/esa' # Optional, Default: "/hubot/esa"
export HUBOT_ESA_WEBHOOK_SECRET_TOKEN='stoken'  # Optional


  • Generate and set your "Personal access token" from https://[your-team]


  • Set your team name


  • Set channel/room.for webhook notification from esa as default e.g. general

HUBOT_ESA_WEBHOOK_ENDPOINT Optional (Default: /hubot/esa)

  • Set the path for endopoint receives webhook from esa.
  • Configure your completed uri at https://[your-team] for Generic webhook


  • If some text is set, hubot-esa verifies signature of HTTPS request by
  • Same to secret you configured in https://[your-team] for Generic webhook

HUBOT_ESA_JUST_EMIT Optional (Default: false)

  • If true is set, disables messaging
  • hubot-esa always triggers below custom events. so you can make customized behavior when receive webhooks

HUBOT_ESA_SLACK_DECORATOR Optional (Default: false)

  • If true is set, decorates message for Slack

HUBOT_ESA_DEBUG Optional (Default: false)

  • If true, then log receiving/emitting events

Use Built-in Slack Decorator

If you're using Hubot for Slack with hubot-slack, you can use built-in Slack decorator implemented for slack.attachment event.

Set env values like below.

export HUBOT_ESA_WEBHOOK_JUST_EMIT='true'       # Optional, Default: "false"
export HUBOT_ESA_SLACK_DECORATOR='true'         # Optional, Default: "false"

Enable Channel Selector for Slack

Select notified channel(room) dynamically by title of post on esa.

export HUBOT_ESA_SLACK_ROOM_SELECTOR='true'     # Optional, Default: "false"

If title includes tags like #dev #programming and channel which corresponds with that tag exist, notifications will be posted to each channels.

When not exist, try to find deepest directory name which corresponds with channel.

e.g. There are 3 channels in Slack: #dev, #programming, web (private)

Title of post on esa Notified Channel
awesome article default room
awesome article #dev #programming #dev #programming
awesome article #dev #programming #ruby #web #dev #programming web
dev/awesome article #dev
dev/programming/awesome article #programming

hubot must exist in each channels which is be notified.

Handle event listener manually

You can implement your script handles above events. For example your can build original message on your own :)

By below setting, disable posting by hubot-esa. Then you can get just emitted event.

export HUBOT_ESA_WEBHOOK_JUST_EMIT='true'       # Optional, Default: "false"


robot.on 'esa.hear.stats', (res, stats) ->

robot.on '', (res, post) ->


robot.on 'esa.hear.comment', (res, comment, post) ->


robot.on 'esa.webhook', (kind, data) ->
  team: 'team name'
  user: 'user object by webhook'
  post: 'post object by webhook'
  comment: 'comment object by webhook'


  • @hmsk who is an esa lover (\( ⁰⊖⁰)/)


Current Tags

  • 0.5.1                                ...           latest (3 years ago)

16 Versions

  • 0.5.1                                ...           3 years ago
  • 0.5.0                                ...           3 years ago
  • 0.5.0-pre                                ...           3 years ago
  • 0.4.0                                ...           3 years ago
  • 0.3.2                                ...           4 years ago
  • 0.3.1                                ...           4 years ago
  • 0.3.0                                ...           4 years ago
  • 0.2.3                                ...           4 years ago
  • 0.2.2                                ...           4 years ago
  • 0.2.1                                ...           4 years ago
  • 0.2.0                                ...           4 years ago
  • 0.1.1                                ...           4 years ago
  • 0.1.0                                ...           4 years ago
  • 0.0.3                                ...           4 years ago
  • 0.0.2                                ...           4 years ago
  • 0.0.1                                ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (1)
Dev Dependencies (14)
Dependents (0)

Copyright 2014 - 2016 © |