Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Client and models for communicating with Zendesk

branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

GDS Zendesk

What is it?

gds_zendesk is a Ruby gem which (partially) wraps the Zendesk REST API v2.

The zendesk_api gem is used under the covers.

Why does it exist?

This gem has certain advantages over the zendesk_api gem:

  • Rails integration
  • A dummy Zendesk client implementation, since Zendesk doesn't provide a staging environment
  • Ability to simulate error conditions

Rails integration

Installation

Simply add the gem to your Gemfile and bundle it up:

gem 'gds_zendesk'

Run the installation generator:

$ rails generate gds_zendesk:install

This generates an initializer at config/initializers/gds_zendesk.rb.

Configuration

Mandatory settings

This gem needs to be configured with a Zendesk username and password before it can be used. These are set in config/initializers/gds_zendesk.rb

Enabling development mode

Because Zendesk doesn't provide a staging environment, it is advised to use the development mode during development and testing. When this mode is enabled:

  • the real Zendesk client is replaced by an interface-equivalent dummy implementation (which makes no network calls)
  • ticket creation failures can be simulated by including break_zendesk anywhere in the ticket description

Development mode can be enabled by configuring development_mode: true. It is off by default.

Usage

Invoke

GDSZendesk::Client.new(config_options)

to create a new client.

Something went wrong with that request. Please try again.