Lita Zendesk Handler
lita-zendesk
is an handler for Lita that allows you to use the robot with Zendesk ticket queries.
Installation
Add lita-zendesk
to your Lita instance's Gemfile:
gem "lita-zendesk"
Configuration
Both Token and Password authentication are supported using the config.handlers.zendesk.auth_type
property which can be set to token
or password
.
Lita.configure do |config|
# Zendesk user info
config.handlers.zendesk.subdomain = 'my_zendesk_subdomain'
config.handlers.zendesk.auth_type = 'password' # set to 'password' or 'token'
config.handlers.zendesk.user = 'my_zendesk_user' # required for both 'password' and 'token'
config.handlers.zendesk.password = 'my_zendesk_password'
config.handlers.zendesk.token = 'my_zendesk_token'
end
Usage
zd
or zendesk
both work for signaling the handler.
Lita > @lita help
Lita: zd connection - returns information on the Zendesk connection
Lita: zd search tickets <QUERY> - returns search results
Lita: zd tickets - returns the total count of all unsolved tickets
Lita: zd all tickets - returns the count of all tickets
Lita: zd pending tickets - returns a count of tickets that are pending
Lita: zd new tickets - returns the count of all new (unassigned) tickets
Lita: zd escalated tickets - returns a count of tickets with escalated tag that are open or pending
Lita: zd open tickets - returns the count of all open tickets
Lita: zd on hold tickets - returns the count of all on hold tickets
Lita: zd list tickets - returns a list of unsolved tickets
Lita: zd list all tickets - returns a list of all tickets
Lita: zd list pending tickets - returns a list of pending tickets
Lita: zd list new tickets - returns a list of new tickets
Lita: zd list esclated tickets - returns a list of escalated tickets
Lita: zd list open tickets - returns a list of open tickets
Lita: zd list onhold tickets - returns a list of on hold tickets
Lita: zd ticket <ID> - returns information about the specified ticket
Change Log
See CHANGELOG.md
Links
Project Repo
Lita
Zendesk Search API
Ported and enhanced from hubot-scripts/zendesk.coffee
:
Contributing
- Fork it ( http://github.com/grokify/lita-zendesk/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
License
Lita Zendesk Handler is available under the MIT license. See LICENSE.txt for details.
Lita Zendesk Handler © 2016 by John Wang