Close

This a ruby gem that provides a robust way to interact with the Close CRM API.

It will have many features.

• Request Caching
• Request Throttling / Queueing for rate limits
• Full Documentation
• Full Test Coverage
• Full API Coverage
• Full Child Object Instances

Add this line to your application's Gemfile:

gem 'close'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install close

The gem can be configures in the following ways:

Block Configuration

# Block configuration
Close.configure do |config|
    config.api_key = 'YOUR_API_KEY'
end
# One off settings
Close.configuration.api_key = 'YOUR_API_KEY'

This gem works by creating resource objects that represent resources on the Close API. These objects can be used to make requests to the API.

# Example Using Leads:

# Get a list of leads
leads = Close::Lead.list

# Get a single lead
lead = Close::Lead.retrieve('lead_id')

# Update the name (and other attributes) of a lead. These are not persisted to the API until you call save.
lead.name = 'New Name'

# Save the changes
lead.save

Close API Docs

Advanced Filters are a clever way to open up search to the API, with the caveat that they are very dense and appear to be written in search DSL (Elastic, Solr, etc).

I have tried to encapsulate the complexity of the DSL into a simple interface that is easy to use. This is mostly by defining queries before they are run and then running them with parameters when they are needed.

An example of an advanced filter query:

# Run a prebuilt query
Close::AdvancedFilter.run('find_leads_by_email', {email: 'buster.bluth@gmail.com'})

# Add a new query
Close::AdvancedFilter.add('find_leads_by_phone_number', {phone_number: '%PHONE_NUMBER%'})

# Run the new query
Close::AdvancedFilter.run('find_leads_by_phone_number', {phone_number: '555-555-5555'})

If you think you have a common query or one that would be useful to others, please open an issue with a new query and I will add it to the gem. Or you can submit a PR with the JSON for the query added to the repo.

Close API Docs

Close API Docs

Close::CustomActivityType.list # => Array of [CustomActivityType]

Close::CustomActivityType.retrieve('custom_activity_type_id') # => CustomActivityType

Close::CustomActivityType.create({name: 'Custom Activity Type Name'}) # => CustomActivityType

custom_activity_type = Close::CustomActivityType.retrieve('custom_activity_type_id')
custom_activity_type.name = 'New Name'
custom_activity_type.update # => Boolean

Aside from this README, you can find the documentation for this gem at rubydoc.info.

You can also generate the documentation locally by running:

$ bundle exec rake yard

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Tests are setup using RSpec. They do require a live API key on first run to generate a VCR cassette. After that, the cassette will be used for all tests.

CLOSE_API_KEY=YOUR_API_KEY bundle exec rspec

Bug reports and pull requests are welcome on GitHub at https://github.com/JoyNerd/close. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

The gem is available as open source under the terms of the MIT License.

Everyone interacting in the Close project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.