telerivet 1.4.0 → 1.5.0

data/lib/telerivet/scheduledmessage.rb

@@ -87,7 +87,7 @@ module Telerivet
 #   
 #   - message_type
 #       * Type of scheduled message
-#       * Allowed values: sms, ussd, call
+#       * Allowed values: sms, mms, ussd, call, service
 #       * Read-only
 #   
 #   - time_created (UNIX timestamp)
@@ -122,6 +122,19 @@ module Telerivet
 #           content, false otherwise
 #       * Read-only
 #   
+#   - track_clicks (boolean)
+#       * If true, URLs in the message content will automatically be replaced with unique
+#           short URLs
+#       * Read-only
+#   
+#   - media (array)
+#       * For text messages containing media files, this is an array of objects with the
+#           properties `url`, `type` (MIME type), `filename`, and `size` (file size in bytes).
+#           Unknown properties are null. This property is undefined for messages that do not
+#           contain media files. Note: For files uploaded via the Telerivet web app, the URL is
+#           temporary and may not be valid for more than 1 day.
+#       * Read-only
+#   
 #   - vars (Hash)
 #       * Custom variables stored for this scheduled message (copied to Message when sent)
 #       * Updatable via API
@@ -237,6 +250,14 @@ class ScheduledMessage < Entity
         get('is_template')
     end
 
+    def track_clicks
+        get('track_clicks')
+    end
+
+    def media
+        get('media')
+    end
+
     def label_ids
         get('label_ids')
     end

data/lib/telerivet/service.rb

@@ -82,7 +82,9 @@ class Service < Entity
     # 
     # For example, to send a poll to a particular contact (or resend the
     # current question), you can invoke the poll service with context=contact, and `contact_id` as
-    # the ID of the contact to send the poll to.
+    # the ID of the contact to send the poll to. (To trigger a service to multiple contacts, use
+    # [project.sendBroadcast](#Project.sendBroadcast). To schedule a service in the future, use
+    # [project.scheduleMessage](#Project.scheduleMessage).)
     # 
     # Or, to manually apply a service for an incoming message, you can
     # invoke the service with `context`=`message`, `event`=`incoming_message`, and `message_id` as
@@ -95,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
@@ -107,11 +109,40 @@ 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.
+    #     
+    #     - 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)
@@ -208,9 +239,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
@@ -223,7 +254,7 @@ class Service < Entity
     #         * Default: asc
     #     
     #     - page_size (int)
-    #         * Number of results returned per page (max 200)
+    #         * Number of results returned per page (max 500)
     #         * Default: 50
     #     
     #     - offset (int)

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telerivet
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Jesse Young
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-12 00:00:00.000000000 Z
+date: 2021-03-27 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
@@ -53,8 +55,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.7
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Telerivet REST API Client