twilio-ruby 4.3.0 → 4.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b89103d98fe5a0cc274231f662de67e7a3b33c35
-  data.tar.gz: 23519a4229477cd81a3d0a03023c3c0d0032eb28
+  metadata.gz: ecb07fd26a80b320199741a2ce2c188331969654
+  data.tar.gz: 1dbdea6628f1a8f9f7bda6fd25d28b7ec30a4884
 SHA512:
-  metadata.gz: 22efb989dd0661f6e15f2357faff19b67cb9ee0314d38024ea5a399b46fb8dd1d44f30975bc1b744ef3f75854d97df17d71992c528b9ee231cd75d5d685399f1
-  data.tar.gz: e3b6739ff15ef1c1ab643f85923776e8831213412c8a1ddc3d36c23cc2331324976f6357aabd098f667ebaf651e97abab5883d26595c03e90714e86fa4e58a55
+  metadata.gz: 624f9abd8990248bea0fdbb3fc7a235cddd6ff0edbe197237dc6b048dea14a052a3200f237acaea47754b72f7d8b4e95dfafc274a48c7dc5bc145ded3b071726
+  data.tar.gz: 5fb8fe1662af3af16b1efc90eb746ca78aa6a96d7eff2568574ffc23725e51518913367e2858ae9c028479845eec5332db3ccdaee6eb180493ea0f0306b5e2c7

data/CHANGES.md

@@ -1,6 +1,14 @@
 twilio-ruby changelog
 =====================
 
+Version 4.4.0
+-------------
+
+Release September 23, 2015
+
+- Add fetching a list of worker reservations
+- Add TaskRouter Workflow builder
+
 Version 4.3.0
 -------------
 

data/README.md

@@ -118,7 +118,30 @@ end
 @client.incoming_phone_numbers.create(phone_number: @number)
 ```
 
-## Getting Started With Client Capability Tokens
+## Create a Task with TaskRouter
+
+If you need to create a Task to TaskRouter, you can do so by using the TaskRouterClient.
+
+Additional resources had off of the workspace object (task_queues, workers, workflows, activities, tasks, statistics, events).
+
+``` ruby
+require 'rubygems'
+require 'twilio-ruby'
+
+# put your own account credentials here:
+account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+auth_token  = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
+workspace_sid = 'WSzzzzzzzzzzzzzzzzzzzzzzzzzzz'
+
+# set up a client
+client = Twilio::REST::TaskRouterClient.new account_sid, auth_token, workspace_sid
+
+# create a task
+workflow_sid = 'WWffffffffffffffffffffffffffff'
+client.workspace.tasks.create(attributes: '{"foo": "bar"}', workflow_sid: "WWfffffffffffffffffffffffffffffff")
+```
+
+## Create a Twilio Client Capability Token
 
 If you just need to generate a Capability Token for use with Twilio Client, you
 can do this:
@@ -128,8 +151,8 @@ require 'rubygems' # not necessary with ruby 1.9 but included for completeness
 require 'twilio-ruby'
 
 # put your own account credentials here:
-account_sid = 'AC043dcf9844e13758bc3a36a84c29761'
-auth_token = '62ea81de3a5b413254eb263595357c69'
+account_sid = 'ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+auth_token = 'yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy'
 
 # set up
 capability = Twilio::Util::Capability.new account_sid, auth_token

data/docs/getting-started.rst

@@ -87,6 +87,27 @@ to easily create such responses.
         <Play loop="5">https://api.twilio.com/cowbell.mp3</Play>
     <Response>
 
+Create a Task with TaskRouter
+=================
+
+If you need to create a Task to TaskRouter, you can do so by using the TaskRouterClient.
+
+Additional resources had off of the workspace object (task_queues, workers, workflows, activities, tasks, statistics, events).
+
+.. code-block:: ruby
+
+    require 'twilio-ruby'
+
+    # To find these visit https://www.twilio.com/user/account
+    account_sid = "ACXXXXXXXXXXXXXXXXX"
+    auth_token = "YYYYYYYYYYYYYYYYYY"
+    workspace_sid = "WSzzzzzzzzzzzzzzzzzzzzzzzzzzz"
+
+    client = Twilio::REST::TaskRouterClient.new account_sid, auth_token, workspace_sid
+
+    workflow_sid = "WFzzzzzzzzzzzzz"
+    task = client.workspace.tasks.create(attributes: '{"foo":"bar"}', workflow_sid: workflow_sid)
+
 
 Digging Deeper
 ========================

data/docs/usage/taskrouter.rst

@@ -11,17 +11,15 @@ can best handle them.
 For more information, see the `TaskRouter documentation
 <https://www.twilio.com/docs/taskrouter>_`.
 
+Note: Passed in Form/Query Parameters are based on their json equivalent attribute.
 
-Creating a Workspace
+Workspaces
 --------------------
 
 A Workspace is a container for your Tasks, Workers, TaskQueues, Workflows and
 Activities. Each of these items exists within a single Workspace and will not
 be shared across Workspaces.
 
-The following code will create a new :class:`Workspace` resource and print
-its unique ID.
-
 .. code-block:: ruby
 
     require 'twilio-ruby'
@@ -35,12 +33,29 @@ its unique ID.
 
     @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
 
+    # creating a workspace
     @workspace = @client.workspaces.create(
         friendly_name: "Customer Support",
         template: "FIFO",  # Sets up default activities and a FIFO TaskQueue
     )
     puts @workspace.sid
 
+    # fetching a workspace
+    @workspace = @client.workspace
+    puts @workspace.sid
+    puts @workspace.friendly_name
+
+    # fetching a list of workspaces
+    @client.workspaces.list.each do |workspace|
+      puts workspace.friendly_name
+    end
+
+    # updating a workspace
+    @client.workspace.update(friendly_name: 'MyWorkspace2')
+
+    # deleting a workspace
+    @client.workspace.delete
+
 
 Workflows
 ---------
@@ -50,6 +65,9 @@ how Tasks should escalate in priority or move across queues over time.
 Workflows are described in a simple JSON format and can be modified through the
 REST API or through the account portal.
 
+Creating a Workflow
+--------------------
+
 The following code will create a new :class:`Workflow` resource and print its
 unique ID:
 
@@ -75,14 +93,14 @@ unique ID:
                 "expression":"customer_value == 'Gold' AND type == 'ticket'",
                 "targets":[
                    {
-                      "task_queue_sid":"WQ0123456789abcdef0123456789abcdef",
+                      "queue":"YourGoldTicketQueueSid",
                       "priority":"2"
                    }
                 ]
              }
           ],
           "default_filter":{
-             "task_queue_sid":"WQabcdef01234567890123456789abcdef"
+             "queue":"YourDefaultQueueSid"
           }
        }
     }
@@ -90,14 +108,75 @@ unique ID:
 
     @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
 
-    @workspace = @client.workflows.create(
+    @workflow = @client.workspace.workflows.create(
         friendly_name: "Incoming Call Flow",
         assignment_callback_url: "https://example.com/callback",
         fallback_assignment_callback_url: "https://example.com/callback2",
         configuration: CONFIG
     )
-    puts @workspace.sid
+    puts @workflow.sid
+
+You can also utilize our Workflow Builder to make this process a bit easier utilizing objects:
+
+.. code-block:: ruby
+
+    require twilio-ruby
+
+    # To find these visit https://www.twilio.com/user/account
+    ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXX"
+    AUTH_TOKEN = "YYYYYYYYYYYYYYYYYY"
+
+    # See previous examples to create a Workspace
+    WORKSPACE_SID = "WSZZZZZZZZZZZZZZ"
+
+    @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
+
+    gold_ticket_queue_sid = 'YourGoldTicketQueueSid'
+    default_queue_sid = 'YourDefaultQueueSid'
+
+    gold_ticket_targets = [Twilio::TaskRouter::WorkflowRuleTarget.new(gold_ticket_queue_sid)]
+    gold_ticket_rule = Twilio::TaskRouter::WorkflowRule.new 'customer_value == "Gold" AND type == "ticket"', gold_ticket_targets, 'Gold Tickets'
+
+    @rules = [gold_ticket_rule]
+    @default_target = Twilio::TaskRouter::WorkflowRuleTarget.new default_queue_sid
 
+    @config = Twilio::TaskRouter::WorkflowConfiguration.new @rules, @default_target
+    puts @config.to_json
+
+    @workflow = @client.workspace.workflows.create(configuration: @config.to_json, friendly_name: 'Incoming Call Flow', assignment_callback_url: 'https://example.com/callback', fallback_assignment_callback_url: 'https://example.com/callback2')
+    puts @workflow.sid
+
+Fetching, Updating, Deleting Workflows
+--------------------
+
+.. code-block:: ruby
+
+    require twilio-ruby
+
+    # To find these visit https://www.twilio.com/user/account
+    ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXX"
+    AUTH_TOKEN = "YYYYYYYYYYYYYYYYYY"
+
+    # See previous examples to create a Workspace
+    WORKSPACE_SID = "WSZZZZZZZZZZZZZZ"
+    WORKFLOW_SID = "WFZZZZZZZZZZZZZZZ"
+
+    # fetching a workflow
+    @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
+    @workflow = @client.workspace.workflows.get(WORKFLOW_SID)
+    puts @workflow.sid
+    puts @workflow.friendly_name
+
+    # fetching a list of workflows
+    @client.workspace.workflows.list.each do |workflow|
+      puts workflow.friendly_name
+    end
+
+    # updating a workflow
+    @workflow.update(friendly_name: 'NewWorkflowName')
+
+    # deleting a workflow
+    @workflow.delete
 
 Activities
 ----------
@@ -106,8 +185,6 @@ Activities describe the current status of your Workers, which determines
 whether they are eligible to receive task assignments. Workers are always set
 to a single Activity.
 
-To create a new :class:`Activity`:
-
 .. code-block:: ruby
 
     require 'twilio-ruby'
@@ -121,12 +198,27 @@ To create a new :class:`Activity`:
 
     @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
 
-    @activity = @client.activities.create(
+    # creating an activity
+    @activity = @client.workspace.activities.create(
         friendly_name: "Coffee Break",
         available: false  # Whether workers are available to handle tasks during this activity
     )
     puts @activity.sid
 
+    # fetching a list of activities
+    @client.workspace.activities.list.each do |activity|
+      puts activity.friendly_name
+    end
+
+    # fetching an activity
+    ACTIVITY_SID = "WAZZZZZZZZZZZZZZZZZ"
+    @activity = @client.workspace.activities.get(ACTIVITY_SID)
+
+    # updating an activity
+    @activity.update(friendly_name: 'NewFriendlyName')
+
+    # deleting an activity
+    @activity.delete
 
 Workers
 -------
@@ -134,8 +226,6 @@ Workers
 Workers represent an entity that is able to perform tasks, such as an agent
 working in a call center, or a salesperson handling leads.
 
-To create a new :class:`Worker`:
-
 .. code-block:: ruby
 
     require 'twilio-ruby'
@@ -149,12 +239,33 @@ To create a new :class:`Worker`:
 
     @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
 
-    @worker = @client.workers.create(
+    # creating a worker
+    @worker = @client.workspace.workers.create(
         friendly_name:"Jamie",
         attributes:'{"phone": "+14155551234", "languages": ["EN", "ES"]}'
     )
     puts @worker.sid
 
+    # fetching a list of workers
+    @client.workspace.workers.list.each do |worker|
+      puts worker.friendly_name
+    end
+
+    # fetching a list of workers based on activity
+    @client.workspace.workers.list(activity_name: 'Offline').each do |worker|
+      puts worker.friendly_name + ' is offline'
+    end
+
+    # fetching an worker
+    WORKER_SID = "WKZZZZZZZZZZZZZZZZZ"
+    @worker = @client.workspace.workers.get(WORKER_SID)
+
+    # updating an worker
+    @worker.update(friendly_name: 'NewFriendlyName')
+
+    # deleting an worker
+    @worker.delete
+
 
 TaskQueues
 ----------
@@ -164,8 +275,6 @@ Workers are eligible to handle those Tasks. As your Workflows process Tasks,
 those Tasks will pass through one or more TaskQueues until the Task is assigned
 and accepted by an eligible Worker.
 
-To create a new :class:`TaskQueue`:
-
 .. code-block:: ruby
 
     require 'twilio-ruby'
@@ -179,14 +288,30 @@ To create a new :class:`TaskQueue`:
 
     @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
 
-    @queue = @client.task_queues.create(
+    # creating a task_queue
+    @taskqueue = @client.workspace.task_queues.create(
         friendly_name: "Sales",
         # The Activity to assign workers when a task is reserved for them
         reservation_activity_sid: "WA11111111111",
         # The Activity to assign workers when a task is assigned to them
         assignment_activity_sid: "WA222222222222",
     )
-    puts @queue.sid
+    puts @taskqueue.sid
+
+     # fetching a list of task_queues
+    @client.workspace.task_queues.list.each do |task_queue|
+      puts task_queue.friendly_name
+    end
+
+    # fetching an taskqueue
+    TASK_QUEUE_SID = "WQZZZZZZZZZZZZZZZZZ"
+    @taskqueue = @client.workspace.task_queues.get(TASK_QUEUE_SID)
+
+    # updating an taskqueue
+    @taskqueue.update(friendly_name: 'NewFriendlyName')
+
+    # deleting an taskqueue
+    @taskqueue.delete
 
 
 Tasks
@@ -195,8 +320,6 @@ Tasks
 A Task instance resource represents a single item of work waiting to be
 processed.
 
-To create a new :class:`Task` via the REST API:
-
 .. code-block:: ruby
 
     # To find these visit https://www.twilio.com/user/account
@@ -219,8 +342,99 @@ To create a new :class:`Task` via the REST API:
     }
     EOS
 
-    @task = @client.create(
+    # creating a task
+    @task = @client.workspace.tasks.create(
         attributes: TASK_ATTRIBUTES,
         assignment_status: 'pending',
     )
     puts @task.sid
+
+    # fetching a list of tasks
+    @client.workspace.tasks.list.each do |task|
+      puts task.sid
+    end
+
+    # fetching a list of tasks that are pending
+    @client.workspace.tasks.list(assignment_status: 'pending').each do |task|
+      puts task.sid
+    end
+
+    # fetching an task
+    TASK_SID = "WTZZZZZZZZZZZZZZZZZ"
+    @task = @client.workspace.tasks.get(TASK_SID)
+
+    # updating an task
+    @task.update(friendly_name: 'NewFriendlyName')
+
+    # deleting an task
+    @task.delete
+
+Reservations
+-----
+
+A Reservation instance resource represents a single matching item of work from a task to a worker.
+
+.. code-block:: ruby
+
+    # To find these visit https://www.twilio.com/user/account
+    ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXX"
+    AUTH_TOKEN = "YYYYYYYYYYYYYYYYYY"
+
+    # See previous examples to create a Workspace
+    WORKSPACE_SID = "WSZZZZZZZZZZZZZZ"
+
+    @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
+
+    # fetching an task
+    TASK_SID = "WTZZZZZZZZZZZZZZZZZ"
+    @task = @client.workspace.tasks.get(TASK_SID)
+
+    # fetching reservations for said task
+    @task.reservations.list.each do |reservation|
+        puts reservation.sid
+    end
+
+Statistics
+-----
+
+A Statistics resource represents the statistics over a time period for a particular resource
+
+.. code-block:: ruby
+
+    # To find these visit https://www.twilio.com/user/account
+    ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXX"
+    AUTH_TOKEN = "YYYYYYYYYYYYYYYYYY"
+
+    # See previous examples to create a Workspace
+    WORKSPACE_SID = "WSZZZZZZZZZZZZZZ"
+
+    @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
+
+    # fetching statistics based on the last 4 hours
+    @workspace_stats = @client.workspace.statistics(minutes: '240')
+    @cumulative = @workspace_stats.cumulative
+    puts 'Avg Task Acceptance Time: ' + @cumulative['avg_task_acceptance_time'].to_s \
+         + ' with ' + @cumulative['tasks_created'].to_s + ' tasks created'
+
+Events
+-----
+
+A Event represents an internal TaskRouter event that occurred and has been logged.
+You can query based on time the event occurred, a certain resource or combination.
+
+.. code-block:: ruby
+
+    # To find these visit https://www.twilio.com/user/account
+    ACCOUNT_SID = "ACXXXXXXXXXXXXXXXXX"
+    AUTH_TOKEN = "YYYYYYYYYYYYYYYYYY"
+
+    # See previous examples to create a Workspace
+    WORKSPACE_SID = "WSZZZZZZZZZZZZZZ"
+
+    @client = Twilio::REST::TaskRouterClient.new ACCOUNT_SID, AUTH_TOKEN, WORKSPACE_SID
+
+    # fetching events for a workspace for the last 15 minutes
+    @events = @client.workspace.events.list(minutes: '15')
+    @events.each do |event|
+      puts event.event_type + ' at ' + event.event_date
+    end

data/docs/usage/token-generation.rst

@@ -75,6 +75,25 @@ for outputting valid TwiML to control phone calls and messages.
     # Twilio Application Sid
     application_sid = "APabe7650f654fc34655fc81ae71caa3ff"
     @capability.allow_client_outgoing(application_sid)
+    
+Add Parameters to an Outgoing Scope
+===================================
+
+You can send parameters to your Twilio Application's :attr:`VoiceUrl` by passing
+a hash to :attr:`#allow_client_outgoing`. Here we pass along a hypothetical user
+id.
+
+.. code-block:: ruby
+
+    application_sid = "APabe7650f654fc34655fc81ae71caa3ff"
+    params = {'user_id' => @user.id}
+
+    # Allow outgoing calls to an application and pass the user id to your server.
+    @capability.allow_client_outgoing(application_sid, params)
+
+The :attr:`user_id` parameter and its value will be sent to your Application's
+:attr:`VoiceUrl` along with the other parameters that Twilio usually sends, like
+:attr:`From`, :attr:`To` and :attr:`CallSid`.
 
 
 Generate a Token

data/examples/taskrouter.examples.rb

@@ -0,0 +1,86 @@
+require 'rubygems'
+require 'twilio-ruby'
+
+# taskrouter examples version 1
+account_sid = 'YourAccountSid'
+auth_token  = 'YourAuthToken'
+workspace_sid = 'YourWorkspaceSid'
+
+# set up a client
+client = Twilio::REST::TaskRouterClient.new account_sid, auth_token, workspace_sid
+puts client.workspace.sid + ' with ' + client.workspace.friendly_name
+
+client.workspace.update(friendly_name: 'MyWorkspace2')
+
+# fetch the list of workers and their status
+client.workspace.workers.list.each do |worker|
+  puts worker.friendly_name + ' is available ' + worker.available.to_s
+end
+
+# fetch the list of workers and their status
+client.workspace.workers.list(activity_name: 'Offline').each do |worker|
+  puts worker.friendly_name + ' is available ' + worker.available.to_s
+end
+
+# create a task
+workflow_sid = 'YourWorkflowSid'
+task = client.workspace.tasks.create(attributes: '{"foo":"bar"}', workflow_sid: workflow_sid)
+
+# list all the tasks created
+client.workspace.tasks.list.each do |task|
+  attributes = JSON.parse(task.attributes)
+  puts attributes['foo'] + ' with age ' + task.age.to_s
+  task.reservations.list.each do |reservation|
+    puts reservation.sid
+  end
+end
+
+# fetching a list of tasks that are pending
+client.workspace.tasks.list(assignment_status: 'pending').each do |task|
+  puts 'pending task ' + task.sid
+end
+
+# delete all tasks
+client.workspace.tasks.list.each do |task|
+  puts 'deleting task ' + task.sid
+  task.delete
+end
+
+# get all the statistics for a workspace
+workspace_stats = client.workspace.statistics(minutes: '240')
+cumulative = workspace_stats.cumulative
+puts 'Avg Task Acceptance Time: ' + cumulative['avg_task_acceptance_time'].to_s \
+      + ' with ' + cumulative['tasks_created'].to_s + ' tasks created'
+
+# get events for a workspace
+events = client.workspace.events.list(minutes: '15')
+events.each do |event|
+  puts event.event_type + ' at ' + event.event_date
+end
+
+# build a workflow
+support_queue_sid = 'YourSupportQueueSid'
+marketing_queue_sid = 'YourMarketingQueueSid'
+default_queue_sid = 'YourDefaultQueue'
+
+support_targets = [Twilio::TaskRouter::WorkflowRuleTarget.new support_queue_sid]
+support_rule = Twilio::TaskRouter::WorkflowRule.new 'type == "support"', support_targets
+
+marketing_targets = [Twilio::TaskRouter::WorkflowRuleTarget.new marketing_queue_sid]
+marketing_rule = Twilio::TaskRouter::WorkflowRule.new 'type == "marketing"', marketing_targets
+
+rules = [support_rule, marketing_rule]
+default_target = Twilio::TaskRouter::WorkflowRuleTarget.new default_queue_sid
+
+config = Twilio::TaskRouter::WorkflowConfiguration.new rules, default_target
+puts config.to_json
+
+workflowCreated = client.workspace.workflows.create(configuration: config.to_json, friendly_name: 'MyWorkflow2', assignment_callback_url: 'http://example.com')
+workflowFetched = client.workspace.workflows.get(workflowCreated.sid)
+
+config_string = workflowFetched.configuration
+config_obj = Twilio::TaskRouter::WorkflowConfiguration.parse_json(config_string)
+
+puts config_string
+puts config_obj.rules[0].expression
+puts config_obj.default_target.queue

data/lib/twilio-ruby.rb

@@ -17,6 +17,7 @@ require 'twilio-ruby/util/capability'
 require 'twilio-ruby/twiml/response'
 require 'twilio-ruby/task_router'
 require 'twilio-ruby/task_router/capability'
+require 'twilio-ruby/task_router/workflow_builder'
 require 'twilio-ruby/rest/errors'
 require 'twilio-ruby/rest/utils'
 require 'twilio-ruby/rest/list_resource'

data/lib/twilio-ruby/rest/task_router/workers.rb

@@ -7,6 +7,12 @@ module Twilio
 
       class Worker < InstanceResource
         include Twilio::REST::TaskRouter::Statistics
+
+        def initialize(path, client, params={})
+          super path, client, params
+          @submodule = :TaskRouter
+          resource :reservations
+        end
       end
     end
   end

data/lib/twilio-ruby/task_router/workflow_builder.rb

@@ -0,0 +1,129 @@
+require 'json'
+
+module Twilio
+  module TaskRouter
+    class WorkflowConfiguration
+
+      def initialize(rules, default_target)
+        @rules = rules
+        @default_target = default_target
+      end
+
+      def rules
+        @rules
+      end
+
+      def default_target
+        @default_target
+      end
+
+      def to_json
+        filters = Array.new
+        @rules.each do |rule|
+          filters.push(rule.to_json)
+        end
+        
+        task_routing = {filters: filters, default_filter: @default_target.to_json}
+        config = {task_routing: task_routing}
+        config.to_json
+      end
+
+      def self.parse_json(json_data)
+        task_routing = JSON.parse(json_data)['task_routing']
+
+        filters = task_routing['filters']
+        rules = Array.new
+        filters.each do |rule|
+          rules.push(Twilio::TaskRouter::WorkflowRule.parse_json(rule))
+        end
+
+        default_filter = Twilio::TaskRouter::WorkflowRuleTarget.parse_json(task_routing['default_filter'])
+        Twilio::TaskRouter::WorkflowConfiguration.new rules, default_filter
+      end
+    end
+    class WorkflowRule
+
+      def initialize(expression, targets, friendly_name=nil)
+        @expression = expression
+        @targets = targets
+        @friendly_name = friendly_name
+      end
+
+      def expression
+        @expression
+      end
+
+      def targets
+        @targets
+      end
+
+      def friendly_name
+        @friendly_name
+      end
+
+      def to_json
+        rule = {expression: @expression}
+        ruleTargets = Array.new
+        @targets.each do |target|
+          ruleTargets.push(target.to_json)
+        end
+        rule['targets'] = ruleTargets
+        unless @friendly_name.nil?
+          rule['friendly_name'] = @friendly_name
+        end
+        rule
+      end
+
+      def self.parse_json(rule)
+        targets = Array.new
+        rule['targets'].each do |target|
+          targets.push(Twilio::TaskRouter::WorkflowRuleTarget.parse_json(target))
+        end
+        Twilio::TaskRouter::WorkflowRule.new rule['expression'], targets, rule['friendly_name']
+      end
+    end
+    class WorkflowRuleTarget
+
+      def initialize(queue, priority=nil, timeout=nil, expression=nil)
+        @queue = queue
+        @priority = priority
+        @timeout = timeout
+        @expression = expression
+      end
+
+      def queue
+        @queue
+      end
+
+      def priority
+        @priority
+      end
+
+      def timeout
+        @timeout
+      end
+
+      def expression
+        @expression
+      end
+
+      def to_json
+        target = {queue: @queue}
+        unless @priority.nil?
+          target['priority'] = @priority
+        end
+        unless @timeout.nil?
+          target['timeout'] = @timeout
+        end
+        unless @expression.nil?
+          target['expression'] = @expression
+        end
+        target
+      end
+
+      def self.parse_json(target)
+        Twilio::TaskRouter::WorkflowRuleTarget.new target['queue'], target['priority'], target['timeout'], target['expression']
+      end
+    end
+  end
+end

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-  VERSION = '4.3.0'
+  VERSION = '4.4.0'
 end

data/spec/rest/task_router/reservation_spec.rb

@@ -6,4 +6,9 @@ describe Twilio::REST::TaskRouter::Reservations do
     expect(task).to respond_to(:reservations)
     expect(task.reservations.instance_variable_get('@path')).to eq('someUri/Reservations')
   end
+  it 'gets a reservation object' do
+    worker = Twilio::REST::TaskRouter::Worker.new('someUri', 'someClient')
+    expect(worker).to respond_to(:reservations)
+    expect(worker.reservations.instance_variable_get('@path')).to eq('someUri/Reservations')
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 4.3.0
+  version: 4.4.0
 platform: ruby
 authors:
 - Andrew Benton
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-11 00:00:00.000000000 Z
+date: 2015-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -129,6 +129,7 @@ files:
 - docs/usage/validation.rst
 - examples/examples.rb
 - examples/print-call-log.rb
+- examples/taskrouter.examples.rb
 - lib/rack/twilio_webhook_authentication.rb
 - lib/twilio-ruby.rb
 - lib/twilio-ruby/rest/accounts.rb
@@ -209,6 +210,7 @@ files:
 - lib/twilio-ruby/rest/utils.rb
 - lib/twilio-ruby/task_router.rb
 - lib/twilio-ruby/task_router/capability.rb
+- lib/twilio-ruby/task_router/workflow_builder.rb
 - lib/twilio-ruby/twiml/response.rb
 - lib/twilio-ruby/util.rb
 - lib/twilio-ruby/util/capability.rb