0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
This library provides Ruby calls to interact with the Contactology email marketing API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.2
~> 2.0
~> 2.0
~> 1.6

Runtime

< 3.0, >= 1.1
<= 0.10.2, >= 0.7.8
 Project Readme

Contactology Build status

This library provides a Ruby interface to the Contactology email marketing API.

Quick start

require 'contactology'

Contactology.key = 'aBcDeFg12345'

list = Contactology::List.find(4)
# => #<Contactology::List:0x000... @list_id="4" @name="test list" ...>

list.subscribe('joe@example.local')
# => true

contact = Contactology::Contact.find('joe@example.local')
# => #<Contactology::Contact:0x000... @email="joe@example.local" ...>

contact.lists
# => [#<Contactology::List:0x000... @list_id="4" ...>]

campaign = Contactology::Campaign.find_by_name('test campaign')
# => #<Contactology::Campaign:0x000... @name="test campaign" ...>

result = campaign.send_campaign
# => #<Contactology::SendResult:0x000... @success=true @issues=[]>

result.successful?
# => true

result.issues
# => []

API support

This library supports the Contactology V2, or "REST," API.

Intentions

This library is not currently intended to fully implement all of the API methods which Contactology makes available. Instead, it will focus on those methods which are of immediate practical use in production applications. This should ensure that the interface is well exercised and continuously updated.

Feel free to fork and submit pull requests to expand the feature set to meet your needs.

Ruby compatibility

This library uses Travis CI to continuously test and remain compatible with the following Rubies:

  • MRI Ruby 1.9.2,
  • MRI Ruby 1.9.3

Currently, the library should also work with MRI 1.8.7 and REE, but the development dependencies (factory_girl) are no longer compatible and therefore have been removed from continuous integration.