===========
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.
Creating a Worker
==============================
.. code-block:: php
require 'Services/Twilio.php';
$accountSid = 'YOUR_ACCOUNT_SID';
$authToken = 'YOUR_AUTH_TOKEN';
$workspaceSid = 'YOUR_WORKSPACE_SID';
// instantiate a Twilio TaskRouter Client
$taskrouterClient = new TaskRouter_Services_Twilio($accountSid, $authToken, $workspaceSid);
// set worker parameters
$friendlyName = 'Bob';
$activitySid = 'YOUR_ACTIVITY_SID';
$workerAttributes = '{"languages":"fr"}';
$worker = $taskrouterClient->workspace->workers->create(
$friendlyName,
array(
'Attributes' => $workerAttributes,
'ActivitySid' => $idleActivitySid
)
);
// confirm worker created
echo "Created Worker: ".$worker.sid;
Updating a Worker
==============================
This update changes the worker above to now be able to handle additional tasks, specfically, tasks that have a language attribute = "sv".
.. code-block:: php
$workerSid = 'YOUR_WORKER_SID';
// set updated worker parameters
$updatedWorkerAttributes = '{"language": ["fr", "sv"]}';
// update worker
$taskrouterClient->workspace->workers->get($workerSid)->update(
array(
'Attributes' => $updatedWorkerAttributes
)
);
echo 'Updated Worker: '.$workerSid;
Deleting a Worker
==============================
.. code-block:: php
$workerSid = 'YOUR_WORKER_SID';
$taskrouterClient->workspace->workers->delete($workerSid);
echo 'Deleted Worker: '.$workerSid;
Get a List of all Workers
==============================
.. code-block:: php
foreach($taskrouterClient->workspace->workers as $worker)
{
echo $worker->sid;
}