telerivet 1.4.5 → 1.6.1

data/lib/telerivet/scheduledmessage.rb

@@ -135,6 +135,13 @@ module Telerivet
 #           temporary and may not be valid for more than 1 day.
 #       * Read-only
 #   
+#   - route_params (Hash)
+#       * Route-specific parameters to use when sending the message. The parameters object may
+#           have keys matching the `phone_type` field of a phone (basic route) that may be used to
+#           send the message. The corresponding value is an object with route-specific parameters
+#           to use when sending a message with that type of route.
+#       * Read-only
+#   
 #   - vars (Hash)
 #       * Custom variables stored for this scheduled message (copied to Message when sent)
 #       * Updatable via API
@@ -258,6 +265,10 @@ class ScheduledMessage < Entity
         get('media')
     end
 
+    def route_params
+        get('route_params')
+    end
+
     def label_ids
         get('label_ids')
     end

data/lib/telerivet/service.rb

@@ -97,7 +97,7 @@ class Service < Entity
     #     
     #     - context
     #         * The name of the context in which this service is invoked
-    #         * Allowed values: message, call, contact, project
+    #         * Allowed values: message, call, ussd_session, row, contact, project
     #         * Required
     #     
     #     - event
@@ -109,11 +109,49 @@ class Service < Entity
     #         * Required if context is 'message'
     #     
     #     - contact_id
-    #         * The ID of the contact this service is triggered for
-    #         * Required if context is 'contact'
+    #         * The ID of the contact this service is triggered for (either `contact_id` or
+    #             `phone_number` is required if `context` is 'contact')
+    #     
+    #     - phone_number
+    #         * The phone number of the contact this service is triggered for (either `contact_id`
+    #             or `phone_number` is required if `context` is 'contact'). If no  contact exists with
+    #             this phone number, a new contact will be created.
+    #     
+    #     - variables (Hash)
+    #         * Object containing up to 25 temporary variable names and their corresponding values
+    #             to set when invoking the service. Values may be strings, numbers, or boolean
+    #             (true/false). String values may be up to 4096 bytes in length. Arrays and objects
+    #             are not supported. Within Custom Actions, each variable can be used like `[[$name]]`
+    #             (with a leading `$` character and surrounded by double square brackets). Within a
+    #             Cloud Script API service or JavaScript action, each variable will be available as a
+    #             global JavaScript variable like `$name` (with a leading `$` character).
+    #     
+    #     - route_id
+    #         * The ID of the phone or route that the service will use for sending messages by
+    #             default
+    #     
+    #     - async (bool)
+    #         * If set to true, the service will be invoked asynchronously. By default, queued
+    #             services will be invoked one at a time for each project.
     #   
     # Returns:
-    #     object
+    #     (associative array)
+    #       - return_value (any)
+    #           * Return value of the service. May be any JSON type (boolean, number, string,
+    #               array, object, or null). (Undefined if async=true.)
+    #       
+    #       - log_entries (array)
+    #           * Array of log entry strings generated by the service. (Undefined if async=true.)
+    #       
+    #       - errors (array)
+    #           * Array of error message strings generated by the service. (Undefined if
+    #               async=true.)
+    #       
+    #       - sent_messages (array of objects)
+    #           * Array of messages sent by the service (Undefined if async=true.)
+    #       
+    #       - airtime_transactions (array of objects)
+    #           * Array of airtime transactions sent by the service (Undefined if async=true.)
     #
     def invoke(options)        
         invoke_result = @api.do_request('POST', get_base_api_path() + '/invoke', options)
@@ -210,9 +248,9 @@ class Service < Entity
     #     
     #     - vars (Hash)
     #         * Filter states by value of a custom variable (e.g. vars[email], vars[foo], etc.)
-    #         * Allowed modifiers: vars[foo][exists], vars[foo][ne], vars[foo][prefix],
-    #             vars[foo][not_prefix], vars[foo][gte], vars[foo][gt], vars[foo][lt], vars[foo][lte],
-    #             vars[foo][min], vars[foo][max]
+    #         * Allowed modifiers: vars[foo][ne], vars[foo][prefix], vars[foo][not_prefix],
+    #             vars[foo][gte], vars[foo][gt], vars[foo][lt], vars[foo][lte], vars[foo][min],
+    #             vars[foo][max], vars[foo][exists]
     #     
     #     - sort
     #         * Sort the results based on a field

data/lib/telerivet/task.rb

@@ -0,0 +1,151 @@
+
+module Telerivet
+
+#
+# Represents an asynchronous task that is applied to all entities matching a filter.
+# 
+# Tasks include services applied to contacts, messages, or data rows; adding
+# or removing contacts from a group; blocking or unblocking sending messages to a contact;
+# updating a custom variable; deleting contacts, messages, or data rows; or
+# exporting data to CSV.
+# 
+# Fields:
+# 
+#   - id (string, max 34 characters)
+#       * ID of the task
+#       * Read-only
+#   
+#   - task_type (string)
+#       * The task type
+#       * Read-only
+#   
+#   - task_params (Hash)
+#       * Parameters applied to all matching rows (specific to `task_type`). See
+#           [project.createTask](#Project.createTask).
+#       * Read-only
+#   
+#   - filter_type
+#       * Type of filter defining the rows that the task is applied to
+#       * Read-only
+#   
+#   - filter_params (Hash)
+#       * Parameters defining the rows that the task is applied to (specific to
+#           `filter_type`). See [project.createTask](#Project.createTask).
+#       * Read-only
+#   
+#   - time_created (UNIX timestamp)
+#       * Time the task was created in Telerivet
+#       * Read-only
+#   
+#   - time_active (UNIX timestamp)
+#       * Time Telerivet started executing the task
+#       * Read-only
+#   
+#   - time_complete (UNIX timestamp)
+#       * Time Telerivet finished executing the task
+#       * Read-only
+#   
+#   - total_rows (int)
+#       * The total number of rows matching the filter (null if not known)
+#       * Read-only
+#   
+#   - current_row (int)
+#       * The number of rows that have been processed so far
+#       * Read-only
+#   
+#   - status (string)
+#       * The current status of the task
+#       * Allowed values: created, queued, active, complete, failed, cancelled
+#       * Read-only
+#   
+#   - vars (Hash)
+#       * Custom variables stored for this task
+#       * Read-only
+#   
+#   - table_id (string, max 34 characters)
+#       * ID of the data table this task is applied to (if applicable)
+#       * Read-only
+#   
+#   - user_id (string, max 34 characters)
+#       * ID of the Telerivet user who created the task (if applicable)
+#       * Read-only
+#   
+#   - project_id
+#       * ID of the project this task belongs to
+#       * Read-only
+#
+class Task < Entity
+    #
+    # Cancels a task that is not yet complete.
+    # 
+    # Returns:
+    #     Telerivet::Task
+    #
+    def cancel()
+        require_relative 'task'
+        Task.new(@api, @api.do_request("POST", get_base_api_path() + "/cancel"))
+    end
+
+    def id
+        get('id')
+    end
+
+    def task_type
+        get('task_type')
+    end
+
+    def task_params
+        get('task_params')
+    end
+
+    def filter_type
+        get('filter_type')
+    end
+
+    def filter_params
+        get('filter_params')
+    end
+
+    def time_created
+        get('time_created')
+    end
+
+    def time_active
+        get('time_active')
+    end
+
+    def time_complete
+        get('time_complete')
+    end
+
+    def total_rows
+        get('total_rows')
+    end
+
+    def current_row
+        get('current_row')
+    end
+
+    def status
+        get('status')
+    end
+
+    def table_id
+        get('table_id')
+    end
+
+    def user_id
+        get('user_id')
+    end
+
+    def project_id
+        get('project_id')
+    end
+
+    def get_base_api_path()
+        "/projects/#{get('project_id')}/tasks/#{get('id')}"
+    end
+ 
+end
+
+end

data/lib/telerivet.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telerivet
 version: !ruby/object:Gem::Version
-  version: 1.4.5
+  version: 1.6.1
 platform: ruby
 authors:
 - Jesse Young
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-15 00:00:00.000000000 Z
+date: 2022-07-18 00:00:00.000000000 Z
 dependencies: []
 description: Ruby client library for Telerivet REST API
 email: support@telerivet.com
@@ -18,6 +18,7 @@ extra_rdoc_files: []
 files:
 - lib/cacert.pem
 - lib/telerivet.rb
+- lib/telerivet/airtimetransaction.rb
 - lib/telerivet/apicursor.rb
 - lib/telerivet/broadcast.rb
 - lib/telerivet/contact.rb
@@ -34,6 +35,7 @@ files:
 - lib/telerivet/route.rb
 - lib/telerivet/scheduledmessage.rb
 - lib/telerivet/service.rb
+- lib/telerivet/task.rb
 homepage: http://telerivet.com
 licenses:
 - MIT