telerivet 1.4.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2d2fced513f7484cd8ea41bc16c1e95a20dbe18d
-  data.tar.gz: e4fc99c1924272a9872262ece7f291c6f92060b4
+  metadata.gz: 697a171fa7f4dd7705e613d73bf33fd107c928c4
+  data.tar.gz: 62ef06d6e833150e6e0a46973b69367928e91aa3
 SHA512:
-  metadata.gz: f027ddecadb6e32b3dded7c0ee27b4d7afeede434d02848bc2a23f69186765e2bc77ec0dac6cc4bde926d0959b889e29bf76490037bb24ce19cb772874c21c82
-  data.tar.gz: 82ccab2d76a1b30183d39945d958901fe85ab575003fa1341aca0d5087d3b3a277cd19d0f96126d9a4ad1e01e9de8252556c20e3b0ab8d48b504005d6f869790
+  metadata.gz: 241260c22dec5140842dcd15dcf92aa0d0db1d53bcf12e3868e32460f655e33e81a2512b5d4dac31191c9e42e28333cb316d4aea7681fdb1afcd08818e122415
+  data.tar.gz: fabe4e4197badab25b4de98449b50ef6ae2c64c3f14d56c6d1f5cb0ea490ebaacffe7dec528399017f13468be5a037593e82127c6a46ca0d1dce57dcf13eab95

data/lib/telerivet.rb

@@ -9,7 +9,7 @@ module Telerivet
 class API
     attr_reader :num_requests
 
-    @@client_version = '1.4.0'
+    @@client_version = '1.4.1'
 
     #
     # Initializes a client handle to the Telerivet REST API.

data/lib/telerivet/project.rb

@@ -512,6 +512,57 @@ class Project < Entity
         Contact.new(@api, @api.do_request("POST", get_base_api_path() + "/contacts", options))
     end
 
+    #
+    # Creates and/or updates up to 200 contacts in a single API call. When creating or updating a
+    # large number of contacts, this method is significantly faster than sending a separate API
+    # request for each contact.
+    # 
+    # By default, if the phone number for any contact matches an existing
+    # contact, the existing contact will be updated with any information provided. This behavior
+    # can be modified by setting the `lookup_key` parameter to look up contacts by another field,
+    # including a custom variable.
+    # 
+    # If any contact was not found matching the provided `lookup_key`, a
+    # new contact will be created.
+    # 
+    # Arguments:
+    #   - options (Hash)
+    #       * Required
+    #     
+    #     - contacts (array)
+    #         * Array of up to 200 objects which may contain the properties `name` (string),
+    #             `phone_number` (string), `vars` (object), and `send_blocked` (boolean). All
+    #             properties are optional, unless used as a lookup key; however, either a `name` or
+    #             `phone_number` property must be provided for new contacts.
+    #         * Required
+    #     
+    #     - lookup_key
+    #         * The field used to search for a matching contact, or 'none' to always create a new
+    #             contact. To search by a custom variable, precede the variable name with 'vars.'.
+    #         * Allowed values: phone_number, id, vars.variable_name, none
+    #         * Default: phone_number
+    #     
+    #     - add_group_ids (array)
+    #         * ID of one or more groups to add these contacts as members (max 5)
+    #     
+    #     - remove_group_ids (array)
+    #         * ID of one or more groups to remove these contacts as members (max 5)
+    #     
+    #     - default_route_id
+    #         * ID of the route to use by default to send messages to these contacts
+    #   
+    # Returns:
+    #     (associative array)
+    #       - contacts (array)
+    #           * List of objects representing each contact, with the same length and order as
+    #               provided in the `contacts` parameter in the API request. Each object has a string
+    #               `id` property.
+    #
+    def import_contacts(options)
+        data = @api.do_request("POST", get_base_api_path() + "/import_contacts", options)
+        return data
+    end
+
     #
     # Queries contacts within the given project.
     # 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telerivet
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Jesse Young
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-12 00:00:00.000000000 Z
+date: 2018-07-19 00:00:00.000000000 Z
 dependencies: []
 description: Ruby client library for Telerivet REST API
 email: support@telerivet.com