[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-twilio-taskrouter-routing":3,"mdc-d7ihmn-key":33,"related-repo-openai-twilio-taskrouter-routing":2803,"related-org-openai-twilio-taskrouter-routing":2925},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":28,"sourceUrl":31,"mdContent":32},"twilio-taskrouter-routing","route tasks using Twilio TaskRouter","Route tasks to agents using Twilio TaskRouter. Covers Workers, Task Queues, Workflows, Reservations, skills-based routing, and common gotchas (hyphen attributes, HAS operator, reservation cascade). Use this skill for any multi-agent contact center, support queue, or AI agent escalation routing.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"openai","OpenAI","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenai.png",[12,16,19],{"name":13,"slug":14,"type":15},"Automation","automation","tag",{"name":17,"slug":18,"type":15},"Routing","routing",{"name":20,"slug":21,"type":15},"Twilio","twilio",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-06-30T19:00:57.102",null,465,[],{"repoUrl":23,"stars":22,"forks":26,"topics":29,"description":30},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Ftwilio-developer-kit\u002Fskills\u002Ftwilio-taskrouter-routing","---\nname: twilio-taskrouter-routing\ndescription: >\n Route tasks to agents using Twilio TaskRouter. Covers Workers, Task\n Queues, Workflows, Reservations, skills-based routing, and common\n gotchas (hyphen attributes, HAS operator, reservation cascade). Use this\n skill for any multi-agent contact center, support queue, or AI agent\n escalation routing.\n---\n\n## Overview\n\nTaskRouter is Twilio's skills-based routing engine. Instead of building custom queuing logic, you define Workers (agents), Task Queues (groups), and Workflows (routing rules). TaskRouter matches incoming tasks to the best available worker.\n\n```\nIncoming Task → Workflow (routing rules) → Task Queue (skill match) → Worker (agent)\n ↓\n Reservation\n (accept\u002Freject)\n```\n\n**Common mistake:** Developers reinvent TaskRouter in custom Node.js — don't. If you're building skills-based routing, queue management, or agent assignment, use TaskRouter.\n\n---\n\n## Prerequisites\n\n- Twilio account — see `twilio-account-setup`\n- `TWILIO_ACCOUNT_SID` and `TWILIO_AUTH_TOKEN` — see `twilio-iam-auth-setup`\n- SDK: `pip install twilio` \u002F `npm install twilio`\n- For voice routing: a Twilio phone number with webhook configured — see `twilio-voice-twiml`\n- For AI escalation: ConversationRelay with escalation tools — see `twilio-voice-conversation-relay`\n\n---\n\n## Quickstart\n\n**Step 1 — Create a Workspace**\n\nA Workspace is the top-level container for all TaskRouter resources.\n\n**Python**\n```python\nimport os\nfrom twilio.rest import Client\n\nclient = Client(os.environ[\"TWILIO_ACCOUNT_SID\"], os.environ[\"TWILIO_AUTH_TOKEN\"])\n\nworkspace = client.taskrouter.v1.workspaces.create(\n friendly_name=\"Support Center\",\n event_callback_url=\"https:\u002F\u002Fyourapp.com\u002Ftaskrouter-events\"\n)\n\nworkspace_sid = workspace.sid # WSxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nprint(workspace_sid)\n```\n\n**Node.js**\n```node\nconst twilio = require(\"twilio\");\nconst client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);\n\nconst workspace = await client.taskrouter.v1.workspaces.create({\n friendlyName: \"Support Center\",\n eventCallbackUrl: \"https:\u002F\u002Fyourapp.com\u002Ftaskrouter-events\",\n});\n\nconst workspaceSid = workspace.sid;\n```\n\n**Step 2 — Create Activities (agent states)**\n\n**Python**\n```python\n# Available — worker can receive tasks\navailable = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n friendly_name=\"Available\", available=True\n)\n\n# Offline — worker cannot receive tasks\noffline = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n friendly_name=\"Offline\", available=False\n)\n\n# On a task — worker is busy\non_task = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n friendly_name=\"On Task\", available=False\n)\n```\n\n**Step 3 — Create Workers (agents)**\n\n> **Security:** Always use `json.dumps()` (Python) or `JSON.stringify()` (Node.js) to construct attribute payloads. String interpolation is vulnerable to JSON injection.\n\n**Python**\n```python\nworker = client.taskrouter.v1.workspaces(workspace_sid).workers.create(\n friendly_name=\"Alice\",\n attributes='{\"skills\": [\"billing\", \"technical\"], \"languages\": [\"en\", \"es\"], \"department\": \"support\"}'\n)\n```\n\n**Node.js**\n```node\nconst worker = await client.taskrouter.v1.workspaces(workspaceSid).workers.create({\n friendlyName: \"Alice\",\n attributes: JSON.stringify({\n skills: [\"billing\", \"technical\"],\n languages: [\"en\", \"es\"],\n department: \"support\",\n }),\n});\n```\n\n**Step 4 — Create Task Queues**\n\n**Python**\n```python\n# Billing queue — matches workers with \"billing\" skill\nbilling_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n friendly_name=\"Billing\",\n target_workers='skills HAS \"billing\"'\n)\n\n# Technical queue\ntech_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n friendly_name=\"Technical\",\n target_workers='skills HAS \"technical\"'\n)\n\n# Catch-all queue\ndefault_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n friendly_name=\"Default\",\n target_workers='1==1' # matches all workers\n)\n```\n\n**Step 5 — Create a Workflow (routing rules)**\n\n**Python**\n```python\nimport json\n\nworkflow_config = {\n \"task_routing\": {\n \"filters\": [\n {\n \"filter_friendly_name\": \"Billing\",\n \"expression\": \"department == 'billing'\",\n \"targets\": [\n {\"queue\": billing_queue.sid, \"timeout\": 120}\n ]\n },\n {\n \"filter_friendly_name\": \"Technical\",\n \"expression\": \"department == 'technical'\",\n \"targets\": [\n {\"queue\": tech_queue.sid, \"timeout\": 120}\n ]\n }\n ],\n \"default_filter\": {\n \"queue\": default_queue.sid\n }\n }\n}\n\nworkflow = client.taskrouter.v1.workspaces(workspace_sid).workflows.create(\n friendly_name=\"Support Routing\",\n configuration=json.dumps(workflow_config),\n assignment_callback_url=\"https:\u002F\u002Fyourapp.com\u002Fassignment\"\n)\n```\n\n**Step 6 — Create a Task (from an incoming call)**\n\n**Python**\n```python\ntask = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n attributes='{\"department\": \"billing\", \"caller\": \"+15558675310\", \"priority\": 1}',\n workflow_sid=workflow.sid\n)\n```\n\n**Step 7 — Handle the Assignment Callback**\n\nWhen TaskRouter finds a matching worker, it POSTs to your `assignment_callback_url`:\n\n**Python (Flask)**\n```python\n@app.route(\"\u002Fassignment\", methods=[\"POST\"])\ndef assignment():\n task_sid = request.form[\"TaskSid\"]\n worker_sid = request.form[\"WorkerSid\"]\n reservation_sid = request.form[\"ReservationSid\"]\n\n # Option A: Dequeue to the worker's phone\n return jsonify({\n \"instruction\": \"dequeue\",\n \"from\": \"+15551234567\", # your Twilio number\n \"post_work_activity_sid\": available_activity_sid\n })\n\n # Option B: Conference the caller and agent\n # return jsonify({\n # \"instruction\": \"conference\",\n # \"from\": \"+15551234567\",\n # \"post_work_activity_sid\": available_activity_sid\n # })\n```\n\n**Node.js (Express)**\n```node\napp.post(\"\u002Fassignment\", (req, res) => {\n res.json({\n instruction: \"dequeue\",\n from: \"+15551234567\",\n post_work_activity_sid: availableActivitySid,\n });\n});\n```\n\n---\n\n## Key Patterns\n\n### Skills-Based Routing\n\nMatch tasks to workers based on attributes:\n\n| Worker expression | Matches |\n|-------------------|---------|\n| `skills HAS \"billing\"` | Workers whose `skills` array contains \"billing\" |\n| `languages HAS \"es\"` | Spanish-speaking workers |\n| `department == \"support\"` | Workers in support department |\n| `experience > 5` | Workers with 5+ years experience |\n| `skills HAS \"billing\" AND languages HAS \"es\"` | Spanish-speaking billing agents |\n\n### Priority Routing\n\nTasks with higher priority are assigned first:\n\n```python\n# VIP customer — priority 10 (higher = first)\ntask = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n attributes='{\"department\": \"billing\", \"priority\": 10, \"vip\": true}',\n workflow_sid=workflow.sid,\n priority=10\n)\n```\n\n### AI Agent Escalation\n\nWhen an AI agent (via TAC) escalates to a human, create a TaskRouter task with the AI's context:\n\n```python\n# From your escalation webhook handler\ndef handle_escalation(escalation_data):\n task = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n attributes=json.dumps({\n \"department\": escalation_data[\"reason_code\"],\n \"conversation_id\": escalation_data[\"conversation_id\"],\n \"profile_id\": escalation_data[\"profile_id\"],\n \"ai_summary\": escalation_data[\"summary\"],\n \"priority\": 5\n }),\n workflow_sid=workflow.sid\n )\n```\n\nThe human agent receives the AI's conversation summary and customer profile.\n\n### Workflow with Timeout Escalation\n\nRoute to specialized queue first, then overflow to general:\n\n```python\nworkflow_config = {\n \"task_routing\": {\n \"filters\": [\n {\n \"filter_friendly_name\": \"Billing Specialist First\",\n \"expression\": \"department == 'billing'\",\n \"targets\": [\n {\"queue\": billing_queue.sid, \"timeout\": 60}, # Try billing queue for 60s\n {\"queue\": default_queue.sid, \"timeout\": 120} # Overflow to general\n ]\n }\n ],\n \"default_filter\": {\n \"queue\": default_queue.sid\n }\n }\n}\n```\n\n### Worker Activity Management\n\n```python\n# Set worker to available\nclient.taskrouter.v1.workspaces(workspace_sid) \\\n .workers(worker_sid) \\\n .update(activity_sid=available_activity_sid)\n\n# Get real-time worker statistics\nstats = client.taskrouter.v1.workspaces(workspace_sid) \\\n .workers \\\n .statistics() \\\n .fetch()\n\nprint(f\"Available: {stats.realtime['total_available_workers']}\")\n```\n\n---\n\n## Scale Guidance\n\n| Agents | Architecture | Notes |\n|--------|-------------|-------|\n| \u003C 10 | Single workflow, one queue per skill | No Flex needed — agents use phone |\n| 10-50 | Multi-queue workflows, skills-based routing | Flex recommended for desktop |\n| 50+ | Multi-tier workflows, priority routing, real-time monitoring | Full Flex + supervisor tools |\n\n---\n\n## Gotchas\n\n### 1. Hyphens in Attribute Names Break Silently\n\n```python\n# WRONG — hyphens in attribute keys break workflow expressions\nworker = client.taskrouter.v1.workspaces(workspace_sid).workers.create(\n friendly_name=\"Alice\",\n attributes='{\"skill-level\": 5}' # hyphen breaks expression evaluation\n)\n\n# RIGHT — use underscores or camelCase\nworker = client.taskrouter.v1.workspaces(workspace_sid).workers.create(\n friendly_name=\"Alice\",\n attributes='{\"skill_level\": 5}'\n)\n```\n\nNo error — the expression silently fails to match.\n\n### 2. HAS Operator on Non-Array Attributes\n\n```python\n# WRONG — \"billing\" is a string, not an array. HAS silently matches nothing.\ntarget_workers = 'department HAS \"billing\"'\n\n# RIGHT — use == for string attributes\ntarget_workers = 'department == \"billing\"'\n\n# RIGHT — use HAS only for arrays\ntarget_workers = 'skills HAS \"billing\"' # skills: [\"billing\", \"technical\"]\n```\n\nTasks sit in queue forever with no error.\n\n### 3. Reservation Timeout Cascade\n\nWhen a reservation times out:\n1. Worker moves to the timeout Activity (often \"Offline\")\n2. Fewer workers available → other reservations also time out\n3. Positive feedback loop → entire queue backs up\n\n**Fix:** Set the timeout Activity to a short-duration state, not \"Offline\". Or implement a reservation timeout handler that keeps the worker available:\n\n```python\n@app.route(\"\u002Ftaskrouter-events\", methods=[\"POST\"])\ndef taskrouter_event():\n event_type = request.form[\"EventType\"]\n if event_type == \"reservation.timeout\":\n worker_sid = request.form[\"WorkerSid\"]\n # Keep worker available instead of moving to offline\n client.taskrouter.v1.workspaces(workspace_sid) \\\n .workers(worker_sid) \\\n .update(activity_sid=available_activity_sid)\n return \"\", 200\n```\n\n### 4. Activity Available Flag\n\nUpdating an Activity's `available` flag returns 200 OK but may not change the value if workers are currently in that activity. Create new activities instead of modifying existing ones.\n\n---\n\n## CANNOT\n\n- **Hyphens in attribute names break expressions** — `skill-level` is treated as subtraction (`skill` minus `level`). Error 20001. Always use underscores: `skill_level`.\n- **`HAS` on non-array silently matches nothing** — `department HAS \"billing\"` on a string attribute is accepted at creation but never matches. Tasks sit in queue forever with no error.\n- **Expression validation is syntactic only** — Queue creation validates parse but NOT worker matching. Semantically wrong expressions create successfully with zero matching workers.\n- **Activity `available` flag is silently immutable** — Updating returns 200 OK but does not change the value. Must delete and recreate the Activity.\n- **`multiTaskEnabled` cannot be reverted to false** — Once enabled on a Workspace, cannot be disabled. One-way door.\n- **Reservation timeout moves worker to timeout Activity** — Worker automatically moved to Offline. Must manually set back. This cascades: fewer available workers → more timeouts → queue collapse. See Gotcha #3.\n- **Workflow target timeout auto-cancels tasks** — When all targets exhaust timeouts, task is canceled. Always include a `default_filter` as catch-all.\n- **Worker `friendlyName` is case-insensitive unique** — \"alice\" collides with \"Alice\".\n- **`workflowSid` is required for task creation** — API does not auto-select a default Workflow.\n- **Cannot update task status and attributes in same request** — Must be two separate API calls.\n- **Assignment callback must respond in 5 seconds** — If both primary and fallback URLs fail, reservation is canceled.\n- **Tasks auto-cancel after 1,000 rejections** — If a task cycles through 1,000 reservation rejections, it is automatically canceled.\n- **`page` query param not supported** — Use `PageToken` for pagination. `page` returns error 40153.\n- **Cannot use malformed JSON in worker attributes** — Silently breaks matching with no error\n- **Cannot use regex in workflow expressions** — Only supports ==, !=, \u003C, >, HAS, IN, CONTAINS, AND, OR, NOT\n- **Cannot exceed 50,000 Workers per Workspace** — Hard limit\n- **Cannot exceed 250 Task Queues per Workspace** — Hard limit\n- **Cannot delay reservation callback response beyond 15 seconds** — Timeout results in reservation failure\n\n---\n\n## Next Steps\n\n- **Conference for transfers:** `twilio-conference-calls`\n- **Call recording:** `twilio-call-recordings`\n- **AI agent voice integration:** `twilio-voice-conversation-relay`\n- **Voice IVR before routing:** `twilio-voice-twiml`\n",{"data":34,"body":35},{"name":4,"description":6},{"type":36,"children":37},"root",[38,47,53,66,77,81,87,169,172,178,186,191,199,317,325,404,412,419,535,543,573,580,618,625,695,703,710,851,859,866,1129,1137,1144,1182,1190,1203,1211,1368,1376,1438,1441,1447,1454,1459,1580,1586,1591,1644,1650,1655,1758,1763,1769,1774,1903,1909,2010,2013,2019,2100,2103,2109,2115,2203,2208,2214,2283,2288,2294,2299,2318,2328,2415,2421,2434,2437,2443,2726,2729,2735,2797],{"type":39,"tag":40,"props":41,"children":43},"element","h2",{"id":42},"overview",[44],{"type":45,"value":46},"text","Overview",{"type":39,"tag":48,"props":49,"children":50},"p",{},[51],{"type":45,"value":52},"TaskRouter is Twilio's skills-based routing engine. Instead of building custom queuing logic, you define Workers (agents), Task Queues (groups), and Workflows (routing rules). TaskRouter matches incoming tasks to the best available worker.",{"type":39,"tag":54,"props":55,"children":59},"pre",{"className":56,"code":58,"language":45},[57],"language-text","Incoming Task → Workflow (routing rules) → Task Queue (skill match) → Worker (agent)\n ↓\n Reservation\n (accept\u002Freject)\n",[60],{"type":39,"tag":61,"props":62,"children":64},"code",{"__ignoreMap":63},"",[65],{"type":45,"value":58},{"type":39,"tag":48,"props":67,"children":68},{},[69,75],{"type":39,"tag":70,"props":71,"children":72},"strong",{},[73],{"type":45,"value":74},"Common mistake:",{"type":45,"value":76}," Developers reinvent TaskRouter in custom Node.js — don't. If you're building skills-based routing, queue management, or agent assignment, use TaskRouter.",{"type":39,"tag":78,"props":79,"children":80},"hr",{},[],{"type":39,"tag":40,"props":82,"children":84},{"id":83},"prerequisites",[85],{"type":45,"value":86},"Prerequisites",{"type":39,"tag":88,"props":89,"children":90},"ul",{},[91,103,128,147,158],{"type":39,"tag":92,"props":93,"children":94},"li",{},[95,97],{"type":45,"value":96},"Twilio account — see ",{"type":39,"tag":61,"props":98,"children":100},{"className":99},[],[101],{"type":45,"value":102},"twilio-account-setup",{"type":39,"tag":92,"props":104,"children":105},{},[106,112,114,120,122],{"type":39,"tag":61,"props":107,"children":109},{"className":108},[],[110],{"type":45,"value":111},"TWILIO_ACCOUNT_SID",{"type":45,"value":113}," and ",{"type":39,"tag":61,"props":115,"children":117},{"className":116},[],[118],{"type":45,"value":119},"TWILIO_AUTH_TOKEN",{"type":45,"value":121}," — see ",{"type":39,"tag":61,"props":123,"children":125},{"className":124},[],[126],{"type":45,"value":127},"twilio-iam-auth-setup",{"type":39,"tag":92,"props":129,"children":130},{},[131,133,139,141],{"type":45,"value":132},"SDK: ",{"type":39,"tag":61,"props":134,"children":136},{"className":135},[],[137],{"type":45,"value":138},"pip install twilio",{"type":45,"value":140}," \u002F ",{"type":39,"tag":61,"props":142,"children":144},{"className":143},[],[145],{"type":45,"value":146},"npm install twilio",{"type":39,"tag":92,"props":148,"children":149},{},[150,152],{"type":45,"value":151},"For voice routing: a Twilio phone number with webhook configured — see ",{"type":39,"tag":61,"props":153,"children":155},{"className":154},[],[156],{"type":45,"value":157},"twilio-voice-twiml",{"type":39,"tag":92,"props":159,"children":160},{},[161,163],{"type":45,"value":162},"For AI escalation: ConversationRelay with escalation tools — see ",{"type":39,"tag":61,"props":164,"children":166},{"className":165},[],[167],{"type":45,"value":168},"twilio-voice-conversation-relay",{"type":39,"tag":78,"props":170,"children":171},{},[],{"type":39,"tag":40,"props":173,"children":175},{"id":174},"quickstart",[176],{"type":45,"value":177},"Quickstart",{"type":39,"tag":48,"props":179,"children":180},{},[181],{"type":39,"tag":70,"props":182,"children":183},{},[184],{"type":45,"value":185},"Step 1 — Create a Workspace",{"type":39,"tag":48,"props":187,"children":188},{},[189],{"type":45,"value":190},"A Workspace is the top-level container for all TaskRouter resources.",{"type":39,"tag":48,"props":192,"children":193},{},[194],{"type":39,"tag":70,"props":195,"children":196},{},[197],{"type":45,"value":198},"Python",{"type":39,"tag":54,"props":200,"children":204},{"className":201,"code":202,"language":203,"meta":63,"style":63},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import os\nfrom twilio.rest import Client\n\nclient = Client(os.environ[\"TWILIO_ACCOUNT_SID\"], os.environ[\"TWILIO_AUTH_TOKEN\"])\n\nworkspace = client.taskrouter.v1.workspaces.create(\n friendly_name=\"Support Center\",\n event_callback_url=\"https:\u002F\u002Fyourapp.com\u002Ftaskrouter-events\"\n)\n\nworkspace_sid = workspace.sid # WSxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nprint(workspace_sid)\n","python",[205],{"type":39,"tag":61,"props":206,"children":207},{"__ignoreMap":63},[208,219,228,238,247,255,264,273,282,291,299,308],{"type":39,"tag":209,"props":210,"children":213},"span",{"class":211,"line":212},"line",1,[214],{"type":39,"tag":209,"props":215,"children":216},{},[217],{"type":45,"value":218},"import os\n",{"type":39,"tag":209,"props":220,"children":222},{"class":211,"line":221},2,[223],{"type":39,"tag":209,"props":224,"children":225},{},[226],{"type":45,"value":227},"from twilio.rest import Client\n",{"type":39,"tag":209,"props":229,"children":231},{"class":211,"line":230},3,[232],{"type":39,"tag":209,"props":233,"children":235},{"emptyLinePlaceholder":234},true,[236],{"type":45,"value":237},"\n",{"type":39,"tag":209,"props":239,"children":241},{"class":211,"line":240},4,[242],{"type":39,"tag":209,"props":243,"children":244},{},[245],{"type":45,"value":246},"client = Client(os.environ[\"TWILIO_ACCOUNT_SID\"], os.environ[\"TWILIO_AUTH_TOKEN\"])\n",{"type":39,"tag":209,"props":248,"children":250},{"class":211,"line":249},5,[251],{"type":39,"tag":209,"props":252,"children":253},{"emptyLinePlaceholder":234},[254],{"type":45,"value":237},{"type":39,"tag":209,"props":256,"children":258},{"class":211,"line":257},6,[259],{"type":39,"tag":209,"props":260,"children":261},{},[262],{"type":45,"value":263},"workspace = client.taskrouter.v1.workspaces.create(\n",{"type":39,"tag":209,"props":265,"children":267},{"class":211,"line":266},7,[268],{"type":39,"tag":209,"props":269,"children":270},{},[271],{"type":45,"value":272}," friendly_name=\"Support Center\",\n",{"type":39,"tag":209,"props":274,"children":276},{"class":211,"line":275},8,[277],{"type":39,"tag":209,"props":278,"children":279},{},[280],{"type":45,"value":281}," event_callback_url=\"https:\u002F\u002Fyourapp.com\u002Ftaskrouter-events\"\n",{"type":39,"tag":209,"props":283,"children":285},{"class":211,"line":284},9,[286],{"type":39,"tag":209,"props":287,"children":288},{},[289],{"type":45,"value":290},")\n",{"type":39,"tag":209,"props":292,"children":294},{"class":211,"line":293},10,[295],{"type":39,"tag":209,"props":296,"children":297},{"emptyLinePlaceholder":234},[298],{"type":45,"value":237},{"type":39,"tag":209,"props":300,"children":302},{"class":211,"line":301},11,[303],{"type":39,"tag":209,"props":304,"children":305},{},[306],{"type":45,"value":307},"workspace_sid = workspace.sid # WSxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n",{"type":39,"tag":209,"props":309,"children":311},{"class":211,"line":310},12,[312],{"type":39,"tag":209,"props":313,"children":314},{},[315],{"type":45,"value":316},"print(workspace_sid)\n",{"type":39,"tag":48,"props":318,"children":319},{},[320],{"type":39,"tag":70,"props":321,"children":322},{},[323],{"type":45,"value":324},"Node.js",{"type":39,"tag":54,"props":326,"children":330},{"className":327,"code":328,"language":329,"meta":63,"style":63},"language-node shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const twilio = require(\"twilio\");\nconst client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);\n\nconst workspace = await client.taskrouter.v1.workspaces.create({\n friendlyName: \"Support Center\",\n eventCallbackUrl: \"https:\u002F\u002Fyourapp.com\u002Ftaskrouter-events\",\n});\n\nconst workspaceSid = workspace.sid;\n","node",[331],{"type":39,"tag":61,"props":332,"children":333},{"__ignoreMap":63},[334,342,350,357,365,373,381,389,396],{"type":39,"tag":209,"props":335,"children":336},{"class":211,"line":212},[337],{"type":39,"tag":209,"props":338,"children":339},{},[340],{"type":45,"value":341},"const twilio = require(\"twilio\");\n",{"type":39,"tag":209,"props":343,"children":344},{"class":211,"line":221},[345],{"type":39,"tag":209,"props":346,"children":347},{},[348],{"type":45,"value":349},"const client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);\n",{"type":39,"tag":209,"props":351,"children":352},{"class":211,"line":230},[353],{"type":39,"tag":209,"props":354,"children":355},{"emptyLinePlaceholder":234},[356],{"type":45,"value":237},{"type":39,"tag":209,"props":358,"children":359},{"class":211,"line":240},[360],{"type":39,"tag":209,"props":361,"children":362},{},[363],{"type":45,"value":364},"const workspace = await client.taskrouter.v1.workspaces.create({\n",{"type":39,"tag":209,"props":366,"children":367},{"class":211,"line":249},[368],{"type":39,"tag":209,"props":369,"children":370},{},[371],{"type":45,"value":372}," friendlyName: \"Support Center\",\n",{"type":39,"tag":209,"props":374,"children":375},{"class":211,"line":257},[376],{"type":39,"tag":209,"props":377,"children":378},{},[379],{"type":45,"value":380}," eventCallbackUrl: \"https:\u002F\u002Fyourapp.com\u002Ftaskrouter-events\",\n",{"type":39,"tag":209,"props":382,"children":383},{"class":211,"line":266},[384],{"type":39,"tag":209,"props":385,"children":386},{},[387],{"type":45,"value":388},"});\n",{"type":39,"tag":209,"props":390,"children":391},{"class":211,"line":275},[392],{"type":39,"tag":209,"props":393,"children":394},{"emptyLinePlaceholder":234},[395],{"type":45,"value":237},{"type":39,"tag":209,"props":397,"children":398},{"class":211,"line":284},[399],{"type":39,"tag":209,"props":400,"children":401},{},[402],{"type":45,"value":403},"const workspaceSid = workspace.sid;\n",{"type":39,"tag":48,"props":405,"children":406},{},[407],{"type":39,"tag":70,"props":408,"children":409},{},[410],{"type":45,"value":411},"Step 2 — Create Activities (agent states)",{"type":39,"tag":48,"props":413,"children":414},{},[415],{"type":39,"tag":70,"props":416,"children":417},{},[418],{"type":45,"value":198},{"type":39,"tag":54,"props":420,"children":422},{"className":201,"code":421,"language":203,"meta":63,"style":63},"# Available — worker can receive tasks\navailable = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n friendly_name=\"Available\", available=True\n)\n\n# Offline — worker cannot receive tasks\noffline = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n friendly_name=\"Offline\", available=False\n)\n\n# On a task — worker is busy\non_task = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n friendly_name=\"On Task\", available=False\n)\n",[423],{"type":39,"tag":61,"props":424,"children":425},{"__ignoreMap":63},[426,434,442,450,457,464,472,480,488,495,502,510,518,527],{"type":39,"tag":209,"props":427,"children":428},{"class":211,"line":212},[429],{"type":39,"tag":209,"props":430,"children":431},{},[432],{"type":45,"value":433},"# Available — worker can receive tasks\n",{"type":39,"tag":209,"props":435,"children":436},{"class":211,"line":221},[437],{"type":39,"tag":209,"props":438,"children":439},{},[440],{"type":45,"value":441},"available = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n",{"type":39,"tag":209,"props":443,"children":444},{"class":211,"line":230},[445],{"type":39,"tag":209,"props":446,"children":447},{},[448],{"type":45,"value":449}," friendly_name=\"Available\", available=True\n",{"type":39,"tag":209,"props":451,"children":452},{"class":211,"line":240},[453],{"type":39,"tag":209,"props":454,"children":455},{},[456],{"type":45,"value":290},{"type":39,"tag":209,"props":458,"children":459},{"class":211,"line":249},[460],{"type":39,"tag":209,"props":461,"children":462},{"emptyLinePlaceholder":234},[463],{"type":45,"value":237},{"type":39,"tag":209,"props":465,"children":466},{"class":211,"line":257},[467],{"type":39,"tag":209,"props":468,"children":469},{},[470],{"type":45,"value":471},"# Offline — worker cannot receive tasks\n",{"type":39,"tag":209,"props":473,"children":474},{"class":211,"line":266},[475],{"type":39,"tag":209,"props":476,"children":477},{},[478],{"type":45,"value":479},"offline = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n",{"type":39,"tag":209,"props":481,"children":482},{"class":211,"line":275},[483],{"type":39,"tag":209,"props":484,"children":485},{},[486],{"type":45,"value":487}," friendly_name=\"Offline\", available=False\n",{"type":39,"tag":209,"props":489,"children":490},{"class":211,"line":284},[491],{"type":39,"tag":209,"props":492,"children":493},{},[494],{"type":45,"value":290},{"type":39,"tag":209,"props":496,"children":497},{"class":211,"line":293},[498],{"type":39,"tag":209,"props":499,"children":500},{"emptyLinePlaceholder":234},[501],{"type":45,"value":237},{"type":39,"tag":209,"props":503,"children":504},{"class":211,"line":301},[505],{"type":39,"tag":209,"props":506,"children":507},{},[508],{"type":45,"value":509},"# On a task — worker is busy\n",{"type":39,"tag":209,"props":511,"children":512},{"class":211,"line":310},[513],{"type":39,"tag":209,"props":514,"children":515},{},[516],{"type":45,"value":517},"on_task = client.taskrouter.v1.workspaces(workspace_sid).activities.create(\n",{"type":39,"tag":209,"props":519,"children":521},{"class":211,"line":520},13,[522],{"type":39,"tag":209,"props":523,"children":524},{},[525],{"type":45,"value":526}," friendly_name=\"On Task\", available=False\n",{"type":39,"tag":209,"props":528,"children":530},{"class":211,"line":529},14,[531],{"type":39,"tag":209,"props":532,"children":533},{},[534],{"type":45,"value":290},{"type":39,"tag":48,"props":536,"children":537},{},[538],{"type":39,"tag":70,"props":539,"children":540},{},[541],{"type":45,"value":542},"Step 3 — Create Workers (agents)",{"type":39,"tag":544,"props":545,"children":546},"blockquote",{},[547],{"type":39,"tag":48,"props":548,"children":549},{},[550,555,557,563,565,571],{"type":39,"tag":70,"props":551,"children":552},{},[553],{"type":45,"value":554},"Security:",{"type":45,"value":556}," Always use ",{"type":39,"tag":61,"props":558,"children":560},{"className":559},[],[561],{"type":45,"value":562},"json.dumps()",{"type":45,"value":564}," (Python) or ",{"type":39,"tag":61,"props":566,"children":568},{"className":567},[],[569],{"type":45,"value":570},"JSON.stringify()",{"type":45,"value":572}," (Node.js) to construct attribute payloads. String interpolation is vulnerable to JSON injection.",{"type":39,"tag":48,"props":574,"children":575},{},[576],{"type":39,"tag":70,"props":577,"children":578},{},[579],{"type":45,"value":198},{"type":39,"tag":54,"props":581,"children":583},{"className":201,"code":582,"language":203,"meta":63,"style":63},"worker = client.taskrouter.v1.workspaces(workspace_sid).workers.create(\n friendly_name=\"Alice\",\n attributes='{\"skills\": [\"billing\", \"technical\"], \"languages\": [\"en\", \"es\"], \"department\": \"support\"}'\n)\n",[584],{"type":39,"tag":61,"props":585,"children":586},{"__ignoreMap":63},[587,595,603,611],{"type":39,"tag":209,"props":588,"children":589},{"class":211,"line":212},[590],{"type":39,"tag":209,"props":591,"children":592},{},[593],{"type":45,"value":594},"worker = client.taskrouter.v1.workspaces(workspace_sid).workers.create(\n",{"type":39,"tag":209,"props":596,"children":597},{"class":211,"line":221},[598],{"type":39,"tag":209,"props":599,"children":600},{},[601],{"type":45,"value":602}," friendly_name=\"Alice\",\n",{"type":39,"tag":209,"props":604,"children":605},{"class":211,"line":230},[606],{"type":39,"tag":209,"props":607,"children":608},{},[609],{"type":45,"value":610}," attributes='{\"skills\": [\"billing\", \"technical\"], \"languages\": [\"en\", \"es\"], \"department\": \"support\"}'\n",{"type":39,"tag":209,"props":612,"children":613},{"class":211,"line":240},[614],{"type":39,"tag":209,"props":615,"children":616},{},[617],{"type":45,"value":290},{"type":39,"tag":48,"props":619,"children":620},{},[621],{"type":39,"tag":70,"props":622,"children":623},{},[624],{"type":45,"value":324},{"type":39,"tag":54,"props":626,"children":628},{"className":327,"code":627,"language":329,"meta":63,"style":63},"const worker = await client.taskrouter.v1.workspaces(workspaceSid).workers.create({\n friendlyName: \"Alice\",\n attributes: JSON.stringify({\n skills: [\"billing\", \"technical\"],\n languages: [\"en\", \"es\"],\n department: \"support\",\n }),\n});\n",[629],{"type":39,"tag":61,"props":630,"children":631},{"__ignoreMap":63},[632,640,648,656,664,672,680,688],{"type":39,"tag":209,"props":633,"children":634},{"class":211,"line":212},[635],{"type":39,"tag":209,"props":636,"children":637},{},[638],{"type":45,"value":639},"const worker = await client.taskrouter.v1.workspaces(workspaceSid).workers.create({\n",{"type":39,"tag":209,"props":641,"children":642},{"class":211,"line":221},[643],{"type":39,"tag":209,"props":644,"children":645},{},[646],{"type":45,"value":647}," friendlyName: \"Alice\",\n",{"type":39,"tag":209,"props":649,"children":650},{"class":211,"line":230},[651],{"type":39,"tag":209,"props":652,"children":653},{},[654],{"type":45,"value":655}," attributes: JSON.stringify({\n",{"type":39,"tag":209,"props":657,"children":658},{"class":211,"line":240},[659],{"type":39,"tag":209,"props":660,"children":661},{},[662],{"type":45,"value":663}," skills: [\"billing\", \"technical\"],\n",{"type":39,"tag":209,"props":665,"children":666},{"class":211,"line":249},[667],{"type":39,"tag":209,"props":668,"children":669},{},[670],{"type":45,"value":671}," languages: [\"en\", \"es\"],\n",{"type":39,"tag":209,"props":673,"children":674},{"class":211,"line":257},[675],{"type":39,"tag":209,"props":676,"children":677},{},[678],{"type":45,"value":679}," department: \"support\",\n",{"type":39,"tag":209,"props":681,"children":682},{"class":211,"line":266},[683],{"type":39,"tag":209,"props":684,"children":685},{},[686],{"type":45,"value":687}," }),\n",{"type":39,"tag":209,"props":689,"children":690},{"class":211,"line":275},[691],{"type":39,"tag":209,"props":692,"children":693},{},[694],{"type":45,"value":388},{"type":39,"tag":48,"props":696,"children":697},{},[698],{"type":39,"tag":70,"props":699,"children":700},{},[701],{"type":45,"value":702},"Step 4 — Create Task Queues",{"type":39,"tag":48,"props":704,"children":705},{},[706],{"type":39,"tag":70,"props":707,"children":708},{},[709],{"type":45,"value":198},{"type":39,"tag":54,"props":711,"children":713},{"className":201,"code":712,"language":203,"meta":63,"style":63},"# Billing queue — matches workers with \"billing\" skill\nbilling_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n friendly_name=\"Billing\",\n target_workers='skills HAS \"billing\"'\n)\n\n# Technical queue\ntech_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n friendly_name=\"Technical\",\n target_workers='skills HAS \"technical\"'\n)\n\n# Catch-all queue\ndefault_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n friendly_name=\"Default\",\n target_workers='1==1' # matches all workers\n)\n",[714],{"type":39,"tag":61,"props":715,"children":716},{"__ignoreMap":63},[717,725,733,741,749,756,763,771,779,787,795,802,809,817,825,834,843],{"type":39,"tag":209,"props":718,"children":719},{"class":211,"line":212},[720],{"type":39,"tag":209,"props":721,"children":722},{},[723],{"type":45,"value":724},"# Billing queue — matches workers with \"billing\" skill\n",{"type":39,"tag":209,"props":726,"children":727},{"class":211,"line":221},[728],{"type":39,"tag":209,"props":729,"children":730},{},[731],{"type":45,"value":732},"billing_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n",{"type":39,"tag":209,"props":734,"children":735},{"class":211,"line":230},[736],{"type":39,"tag":209,"props":737,"children":738},{},[739],{"type":45,"value":740}," friendly_name=\"Billing\",\n",{"type":39,"tag":209,"props":742,"children":743},{"class":211,"line":240},[744],{"type":39,"tag":209,"props":745,"children":746},{},[747],{"type":45,"value":748}," target_workers='skills HAS \"billing\"'\n",{"type":39,"tag":209,"props":750,"children":751},{"class":211,"line":249},[752],{"type":39,"tag":209,"props":753,"children":754},{},[755],{"type":45,"value":290},{"type":39,"tag":209,"props":757,"children":758},{"class":211,"line":257},[759],{"type":39,"tag":209,"props":760,"children":761},{"emptyLinePlaceholder":234},[762],{"type":45,"value":237},{"type":39,"tag":209,"props":764,"children":765},{"class":211,"line":266},[766],{"type":39,"tag":209,"props":767,"children":768},{},[769],{"type":45,"value":770},"# Technical queue\n",{"type":39,"tag":209,"props":772,"children":773},{"class":211,"line":275},[774],{"type":39,"tag":209,"props":775,"children":776},{},[777],{"type":45,"value":778},"tech_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n",{"type":39,"tag":209,"props":780,"children":781},{"class":211,"line":284},[782],{"type":39,"tag":209,"props":783,"children":784},{},[785],{"type":45,"value":786}," friendly_name=\"Technical\",\n",{"type":39,"tag":209,"props":788,"children":789},{"class":211,"line":293},[790],{"type":39,"tag":209,"props":791,"children":792},{},[793],{"type":45,"value":794}," target_workers='skills HAS \"technical\"'\n",{"type":39,"tag":209,"props":796,"children":797},{"class":211,"line":301},[798],{"type":39,"tag":209,"props":799,"children":800},{},[801],{"type":45,"value":290},{"type":39,"tag":209,"props":803,"children":804},{"class":211,"line":310},[805],{"type":39,"tag":209,"props":806,"children":807},{"emptyLinePlaceholder":234},[808],{"type":45,"value":237},{"type":39,"tag":209,"props":810,"children":811},{"class":211,"line":520},[812],{"type":39,"tag":209,"props":813,"children":814},{},[815],{"type":45,"value":816},"# Catch-all queue\n",{"type":39,"tag":209,"props":818,"children":819},{"class":211,"line":529},[820],{"type":39,"tag":209,"props":821,"children":822},{},[823],{"type":45,"value":824},"default_queue = client.taskrouter.v1.workspaces(workspace_sid).task_queues.create(\n",{"type":39,"tag":209,"props":826,"children":828},{"class":211,"line":827},15,[829],{"type":39,"tag":209,"props":830,"children":831},{},[832],{"type":45,"value":833}," friendly_name=\"Default\",\n",{"type":39,"tag":209,"props":835,"children":837},{"class":211,"line":836},16,[838],{"type":39,"tag":209,"props":839,"children":840},{},[841],{"type":45,"value":842}," target_workers='1==1' # matches all workers\n",{"type":39,"tag":209,"props":844,"children":846},{"class":211,"line":845},17,[847],{"type":39,"tag":209,"props":848,"children":849},{},[850],{"type":45,"value":290},{"type":39,"tag":48,"props":852,"children":853},{},[854],{"type":39,"tag":70,"props":855,"children":856},{},[857],{"type":45,"value":858},"Step 5 — Create a Workflow (routing rules)",{"type":39,"tag":48,"props":860,"children":861},{},[862],{"type":39,"tag":70,"props":863,"children":864},{},[865],{"type":45,"value":198},{"type":39,"tag":54,"props":867,"children":869},{"className":201,"code":868,"language":203,"meta":63,"style":63},"import json\n\nworkflow_config = {\n \"task_routing\": {\n \"filters\": [\n {\n \"filter_friendly_name\": \"Billing\",\n \"expression\": \"department == 'billing'\",\n \"targets\": [\n {\"queue\": billing_queue.sid, \"timeout\": 120}\n ]\n },\n {\n \"filter_friendly_name\": \"Technical\",\n \"expression\": \"department == 'technical'\",\n \"targets\": [\n {\"queue\": tech_queue.sid, \"timeout\": 120}\n ]\n }\n ],\n \"default_filter\": {\n \"queue\": default_queue.sid\n }\n }\n}\n\nworkflow = client.taskrouter.v1.workspaces(workspace_sid).workflows.create(\n friendly_name=\"Support Routing\",\n configuration=json.dumps(workflow_config),\n assignment_callback_url=\"https:\u002F\u002Fyourapp.com\u002Fassignment\"\n)\n",[870],{"type":39,"tag":61,"props":871,"children":872},{"__ignoreMap":63},[873,881,888,896,904,912,920,928,936,944,952,960,968,975,983,991,998,1006,1014,1023,1032,1041,1050,1059,1068,1077,1085,1094,1103,1112,1121],{"type":39,"tag":209,"props":874,"children":875},{"class":211,"line":212},[876],{"type":39,"tag":209,"props":877,"children":878},{},[879],{"type":45,"value":880},"import json\n",{"type":39,"tag":209,"props":882,"children":883},{"class":211,"line":221},[884],{"type":39,"tag":209,"props":885,"children":886},{"emptyLinePlaceholder":234},[887],{"type":45,"value":237},{"type":39,"tag":209,"props":889,"children":890},{"class":211,"line":230},[891],{"type":39,"tag":209,"props":892,"children":893},{},[894],{"type":45,"value":895},"workflow_config = {\n",{"type":39,"tag":209,"props":897,"children":898},{"class":211,"line":240},[899],{"type":39,"tag":209,"props":900,"children":901},{},[902],{"type":45,"value":903}," \"task_routing\": {\n",{"type":39,"tag":209,"props":905,"children":906},{"class":211,"line":249},[907],{"type":39,"tag":209,"props":908,"children":909},{},[910],{"type":45,"value":911}," \"filters\": [\n",{"type":39,"tag":209,"props":913,"children":914},{"class":211,"line":257},[915],{"type":39,"tag":209,"props":916,"children":917},{},[918],{"type":45,"value":919}," {\n",{"type":39,"tag":209,"props":921,"children":922},{"class":211,"line":266},[923],{"type":39,"tag":209,"props":924,"children":925},{},[926],{"type":45,"value":927}," \"filter_friendly_name\": \"Billing\",\n",{"type":39,"tag":209,"props":929,"children":930},{"class":211,"line":275},[931],{"type":39,"tag":209,"props":932,"children":933},{},[934],{"type":45,"value":935}," \"expression\": \"department == 'billing'\",\n",{"type":39,"tag":209,"props":937,"children":938},{"class":211,"line":284},[939],{"type":39,"tag":209,"props":940,"children":941},{},[942],{"type":45,"value":943}," \"targets\": [\n",{"type":39,"tag":209,"props":945,"children":946},{"class":211,"line":293},[947],{"type":39,"tag":209,"props":948,"children":949},{},[950],{"type":45,"value":951}," {\"queue\": billing_queue.sid, \"timeout\": 120}\n",{"type":39,"tag":209,"props":953,"children":954},{"class":211,"line":301},[955],{"type":39,"tag":209,"props":956,"children":957},{},[958],{"type":45,"value":959}," ]\n",{"type":39,"tag":209,"props":961,"children":962},{"class":211,"line":310},[963],{"type":39,"tag":209,"props":964,"children":965},{},[966],{"type":45,"value":967}," },\n",{"type":39,"tag":209,"props":969,"children":970},{"class":211,"line":520},[971],{"type":39,"tag":209,"props":972,"children":973},{},[974],{"type":45,"value":919},{"type":39,"tag":209,"props":976,"children":977},{"class":211,"line":529},[978],{"type":39,"tag":209,"props":979,"children":980},{},[981],{"type":45,"value":982}," \"filter_friendly_name\": \"Technical\",\n",{"type":39,"tag":209,"props":984,"children":985},{"class":211,"line":827},[986],{"type":39,"tag":209,"props":987,"children":988},{},[989],{"type":45,"value":990}," \"expression\": \"department == 'technical'\",\n",{"type":39,"tag":209,"props":992,"children":993},{"class":211,"line":836},[994],{"type":39,"tag":209,"props":995,"children":996},{},[997],{"type":45,"value":943},{"type":39,"tag":209,"props":999,"children":1000},{"class":211,"line":845},[1001],{"type":39,"tag":209,"props":1002,"children":1003},{},[1004],{"type":45,"value":1005}," {\"queue\": tech_queue.sid, \"timeout\": 120}\n",{"type":39,"tag":209,"props":1007,"children":1009},{"class":211,"line":1008},18,[1010],{"type":39,"tag":209,"props":1011,"children":1012},{},[1013],{"type":45,"value":959},{"type":39,"tag":209,"props":1015,"children":1017},{"class":211,"line":1016},19,[1018],{"type":39,"tag":209,"props":1019,"children":1020},{},[1021],{"type":45,"value":1022}," }\n",{"type":39,"tag":209,"props":1024,"children":1026},{"class":211,"line":1025},20,[1027],{"type":39,"tag":209,"props":1028,"children":1029},{},[1030],{"type":45,"value":1031}," ],\n",{"type":39,"tag":209,"props":1033,"children":1035},{"class":211,"line":1034},21,[1036],{"type":39,"tag":209,"props":1037,"children":1038},{},[1039],{"type":45,"value":1040}," \"default_filter\": {\n",{"type":39,"tag":209,"props":1042,"children":1044},{"class":211,"line":1043},22,[1045],{"type":39,"tag":209,"props":1046,"children":1047},{},[1048],{"type":45,"value":1049}," \"queue\": default_queue.sid\n",{"type":39,"tag":209,"props":1051,"children":1053},{"class":211,"line":1052},23,[1054],{"type":39,"tag":209,"props":1055,"children":1056},{},[1057],{"type":45,"value":1058}," }\n",{"type":39,"tag":209,"props":1060,"children":1062},{"class":211,"line":1061},24,[1063],{"type":39,"tag":209,"props":1064,"children":1065},{},[1066],{"type":45,"value":1067}," }\n",{"type":39,"tag":209,"props":1069,"children":1071},{"class":211,"line":1070},25,[1072],{"type":39,"tag":209,"props":1073,"children":1074},{},[1075],{"type":45,"value":1076},"}\n",{"type":39,"tag":209,"props":1078,"children":1080},{"class":211,"line":1079},26,[1081],{"type":39,"tag":209,"props":1082,"children":1083},{"emptyLinePlaceholder":234},[1084],{"type":45,"value":237},{"type":39,"tag":209,"props":1086,"children":1088},{"class":211,"line":1087},27,[1089],{"type":39,"tag":209,"props":1090,"children":1091},{},[1092],{"type":45,"value":1093},"workflow = client.taskrouter.v1.workspaces(workspace_sid).workflows.create(\n",{"type":39,"tag":209,"props":1095,"children":1097},{"class":211,"line":1096},28,[1098],{"type":39,"tag":209,"props":1099,"children":1100},{},[1101],{"type":45,"value":1102}," friendly_name=\"Support Routing\",\n",{"type":39,"tag":209,"props":1104,"children":1106},{"class":211,"line":1105},29,[1107],{"type":39,"tag":209,"props":1108,"children":1109},{},[1110],{"type":45,"value":1111}," configuration=json.dumps(workflow_config),\n",{"type":39,"tag":209,"props":1113,"children":1115},{"class":211,"line":1114},30,[1116],{"type":39,"tag":209,"props":1117,"children":1118},{},[1119],{"type":45,"value":1120}," assignment_callback_url=\"https:\u002F\u002Fyourapp.com\u002Fassignment\"\n",{"type":39,"tag":209,"props":1122,"children":1124},{"class":211,"line":1123},31,[1125],{"type":39,"tag":209,"props":1126,"children":1127},{},[1128],{"type":45,"value":290},{"type":39,"tag":48,"props":1130,"children":1131},{},[1132],{"type":39,"tag":70,"props":1133,"children":1134},{},[1135],{"type":45,"value":1136},"Step 6 — Create a Task (from an incoming call)",{"type":39,"tag":48,"props":1138,"children":1139},{},[1140],{"type":39,"tag":70,"props":1141,"children":1142},{},[1143],{"type":45,"value":198},{"type":39,"tag":54,"props":1145,"children":1147},{"className":201,"code":1146,"language":203,"meta":63,"style":63},"task = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n attributes='{\"department\": \"billing\", \"caller\": \"+15558675310\", \"priority\": 1}',\n workflow_sid=workflow.sid\n)\n",[1148],{"type":39,"tag":61,"props":1149,"children":1150},{"__ignoreMap":63},[1151,1159,1167,1175],{"type":39,"tag":209,"props":1152,"children":1153},{"class":211,"line":212},[1154],{"type":39,"tag":209,"props":1155,"children":1156},{},[1157],{"type":45,"value":1158},"task = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n",{"type":39,"tag":209,"props":1160,"children":1161},{"class":211,"line":221},[1162],{"type":39,"tag":209,"props":1163,"children":1164},{},[1165],{"type":45,"value":1166}," attributes='{\"department\": \"billing\", \"caller\": \"+15558675310\", \"priority\": 1}',\n",{"type":39,"tag":209,"props":1168,"children":1169},{"class":211,"line":230},[1170],{"type":39,"tag":209,"props":1171,"children":1172},{},[1173],{"type":45,"value":1174}," workflow_sid=workflow.sid\n",{"type":39,"tag":209,"props":1176,"children":1177},{"class":211,"line":240},[1178],{"type":39,"tag":209,"props":1179,"children":1180},{},[1181],{"type":45,"value":290},{"type":39,"tag":48,"props":1183,"children":1184},{},[1185],{"type":39,"tag":70,"props":1186,"children":1187},{},[1188],{"type":45,"value":1189},"Step 7 — Handle the Assignment Callback",{"type":39,"tag":48,"props":1191,"children":1192},{},[1193,1195,1201],{"type":45,"value":1194},"When TaskRouter finds a matching worker, it POSTs to your ",{"type":39,"tag":61,"props":1196,"children":1198},{"className":1197},[],[1199],{"type":45,"value":1200},"assignment_callback_url",{"type":45,"value":1202},":",{"type":39,"tag":48,"props":1204,"children":1205},{},[1206],{"type":39,"tag":70,"props":1207,"children":1208},{},[1209],{"type":45,"value":1210},"Python (Flask)",{"type":39,"tag":54,"props":1212,"children":1214},{"className":201,"code":1213,"language":203,"meta":63,"style":63},"@app.route(\"\u002Fassignment\", methods=[\"POST\"])\ndef assignment():\n task_sid = request.form[\"TaskSid\"]\n worker_sid = request.form[\"WorkerSid\"]\n reservation_sid = request.form[\"ReservationSid\"]\n\n # Option A: Dequeue to the worker's phone\n return jsonify({\n \"instruction\": \"dequeue\",\n \"from\": \"+15551234567\", # your Twilio number\n \"post_work_activity_sid\": available_activity_sid\n })\n\n # Option B: Conference the caller and agent\n # return jsonify({\n # \"instruction\": \"conference\",\n # \"from\": \"+15551234567\",\n # \"post_work_activity_sid\": available_activity_sid\n # })\n",[1215],{"type":39,"tag":61,"props":1216,"children":1217},{"__ignoreMap":63},[1218,1226,1234,1242,1250,1258,1265,1273,1281,1289,1297,1305,1313,1320,1328,1336,1344,1352,1360],{"type":39,"tag":209,"props":1219,"children":1220},{"class":211,"line":212},[1221],{"type":39,"tag":209,"props":1222,"children":1223},{},[1224],{"type":45,"value":1225},"@app.route(\"\u002Fassignment\", methods=[\"POST\"])\n",{"type":39,"tag":209,"props":1227,"children":1228},{"class":211,"line":221},[1229],{"type":39,"tag":209,"props":1230,"children":1231},{},[1232],{"type":45,"value":1233},"def assignment():\n",{"type":39,"tag":209,"props":1235,"children":1236},{"class":211,"line":230},[1237],{"type":39,"tag":209,"props":1238,"children":1239},{},[1240],{"type":45,"value":1241}," task_sid = request.form[\"TaskSid\"]\n",{"type":39,"tag":209,"props":1243,"children":1244},{"class":211,"line":240},[1245],{"type":39,"tag":209,"props":1246,"children":1247},{},[1248],{"type":45,"value":1249}," worker_sid = request.form[\"WorkerSid\"]\n",{"type":39,"tag":209,"props":1251,"children":1252},{"class":211,"line":249},[1253],{"type":39,"tag":209,"props":1254,"children":1255},{},[1256],{"type":45,"value":1257}," reservation_sid = request.form[\"ReservationSid\"]\n",{"type":39,"tag":209,"props":1259,"children":1260},{"class":211,"line":257},[1261],{"type":39,"tag":209,"props":1262,"children":1263},{"emptyLinePlaceholder":234},[1264],{"type":45,"value":237},{"type":39,"tag":209,"props":1266,"children":1267},{"class":211,"line":266},[1268],{"type":39,"tag":209,"props":1269,"children":1270},{},[1271],{"type":45,"value":1272}," # Option A: Dequeue to the worker's phone\n",{"type":39,"tag":209,"props":1274,"children":1275},{"class":211,"line":275},[1276],{"type":39,"tag":209,"props":1277,"children":1278},{},[1279],{"type":45,"value":1280}," return jsonify({\n",{"type":39,"tag":209,"props":1282,"children":1283},{"class":211,"line":284},[1284],{"type":39,"tag":209,"props":1285,"children":1286},{},[1287],{"type":45,"value":1288}," \"instruction\": \"dequeue\",\n",{"type":39,"tag":209,"props":1290,"children":1291},{"class":211,"line":293},[1292],{"type":39,"tag":209,"props":1293,"children":1294},{},[1295],{"type":45,"value":1296}," \"from\": \"+15551234567\", # your Twilio number\n",{"type":39,"tag":209,"props":1298,"children":1299},{"class":211,"line":301},[1300],{"type":39,"tag":209,"props":1301,"children":1302},{},[1303],{"type":45,"value":1304}," \"post_work_activity_sid\": available_activity_sid\n",{"type":39,"tag":209,"props":1306,"children":1307},{"class":211,"line":310},[1308],{"type":39,"tag":209,"props":1309,"children":1310},{},[1311],{"type":45,"value":1312}," })\n",{"type":39,"tag":209,"props":1314,"children":1315},{"class":211,"line":520},[1316],{"type":39,"tag":209,"props":1317,"children":1318},{"emptyLinePlaceholder":234},[1319],{"type":45,"value":237},{"type":39,"tag":209,"props":1321,"children":1322},{"class":211,"line":529},[1323],{"type":39,"tag":209,"props":1324,"children":1325},{},[1326],{"type":45,"value":1327}," # Option B: Conference the caller and agent\n",{"type":39,"tag":209,"props":1329,"children":1330},{"class":211,"line":827},[1331],{"type":39,"tag":209,"props":1332,"children":1333},{},[1334],{"type":45,"value":1335}," # return jsonify({\n",{"type":39,"tag":209,"props":1337,"children":1338},{"class":211,"line":836},[1339],{"type":39,"tag":209,"props":1340,"children":1341},{},[1342],{"type":45,"value":1343}," # \"instruction\": \"conference\",\n",{"type":39,"tag":209,"props":1345,"children":1346},{"class":211,"line":845},[1347],{"type":39,"tag":209,"props":1348,"children":1349},{},[1350],{"type":45,"value":1351}," # \"from\": \"+15551234567\",\n",{"type":39,"tag":209,"props":1353,"children":1354},{"class":211,"line":1008},[1355],{"type":39,"tag":209,"props":1356,"children":1357},{},[1358],{"type":45,"value":1359}," # \"post_work_activity_sid\": available_activity_sid\n",{"type":39,"tag":209,"props":1361,"children":1362},{"class":211,"line":1016},[1363],{"type":39,"tag":209,"props":1364,"children":1365},{},[1366],{"type":45,"value":1367}," # })\n",{"type":39,"tag":48,"props":1369,"children":1370},{},[1371],{"type":39,"tag":70,"props":1372,"children":1373},{},[1374],{"type":45,"value":1375},"Node.js (Express)",{"type":39,"tag":54,"props":1377,"children":1379},{"className":327,"code":1378,"language":329,"meta":63,"style":63},"app.post(\"\u002Fassignment\", (req, res) => {\n res.json({\n instruction: \"dequeue\",\n from: \"+15551234567\",\n post_work_activity_sid: availableActivitySid,\n });\n});\n",[1380],{"type":39,"tag":61,"props":1381,"children":1382},{"__ignoreMap":63},[1383,1391,1399,1407,1415,1423,1431],{"type":39,"tag":209,"props":1384,"children":1385},{"class":211,"line":212},[1386],{"type":39,"tag":209,"props":1387,"children":1388},{},[1389],{"type":45,"value":1390},"app.post(\"\u002Fassignment\", (req, res) => {\n",{"type":39,"tag":209,"props":1392,"children":1393},{"class":211,"line":221},[1394],{"type":39,"tag":209,"props":1395,"children":1396},{},[1397],{"type":45,"value":1398}," res.json({\n",{"type":39,"tag":209,"props":1400,"children":1401},{"class":211,"line":230},[1402],{"type":39,"tag":209,"props":1403,"children":1404},{},[1405],{"type":45,"value":1406}," instruction: \"dequeue\",\n",{"type":39,"tag":209,"props":1408,"children":1409},{"class":211,"line":240},[1410],{"type":39,"tag":209,"props":1411,"children":1412},{},[1413],{"type":45,"value":1414}," from: \"+15551234567\",\n",{"type":39,"tag":209,"props":1416,"children":1417},{"class":211,"line":249},[1418],{"type":39,"tag":209,"props":1419,"children":1420},{},[1421],{"type":45,"value":1422}," post_work_activity_sid: availableActivitySid,\n",{"type":39,"tag":209,"props":1424,"children":1425},{"class":211,"line":257},[1426],{"type":39,"tag":209,"props":1427,"children":1428},{},[1429],{"type":45,"value":1430}," });\n",{"type":39,"tag":209,"props":1432,"children":1433},{"class":211,"line":266},[1434],{"type":39,"tag":209,"props":1435,"children":1436},{},[1437],{"type":45,"value":388},{"type":39,"tag":78,"props":1439,"children":1440},{},[],{"type":39,"tag":40,"props":1442,"children":1444},{"id":1443},"key-patterns",[1445],{"type":45,"value":1446},"Key Patterns",{"type":39,"tag":1448,"props":1449,"children":1451},"h3",{"id":1450},"skills-based-routing",[1452],{"type":45,"value":1453},"Skills-Based Routing",{"type":39,"tag":48,"props":1455,"children":1456},{},[1457],{"type":45,"value":1458},"Match tasks to workers based on attributes:",{"type":39,"tag":1460,"props":1461,"children":1462},"table",{},[1463,1482],{"type":39,"tag":1464,"props":1465,"children":1466},"thead",{},[1467],{"type":39,"tag":1468,"props":1469,"children":1470},"tr",{},[1471,1477],{"type":39,"tag":1472,"props":1473,"children":1474},"th",{},[1475],{"type":45,"value":1476},"Worker expression",{"type":39,"tag":1472,"props":1478,"children":1479},{},[1480],{"type":45,"value":1481},"Matches",{"type":39,"tag":1483,"props":1484,"children":1485},"tbody",{},[1486,1512,1529,1546,1563],{"type":39,"tag":1468,"props":1487,"children":1488},{},[1489,1499],{"type":39,"tag":1490,"props":1491,"children":1492},"td",{},[1493],{"type":39,"tag":61,"props":1494,"children":1496},{"className":1495},[],[1497],{"type":45,"value":1498},"skills HAS \"billing\"",{"type":39,"tag":1490,"props":1500,"children":1501},{},[1502,1504,1510],{"type":45,"value":1503},"Workers whose ",{"type":39,"tag":61,"props":1505,"children":1507},{"className":1506},[],[1508],{"type":45,"value":1509},"skills",{"type":45,"value":1511}," array contains \"billing\"",{"type":39,"tag":1468,"props":1513,"children":1514},{},[1515,1524],{"type":39,"tag":1490,"props":1516,"children":1517},{},[1518],{"type":39,"tag":61,"props":1519,"children":1521},{"className":1520},[],[1522],{"type":45,"value":1523},"languages HAS \"es\"",{"type":39,"tag":1490,"props":1525,"children":1526},{},[1527],{"type":45,"value":1528},"Spanish-speaking workers",{"type":39,"tag":1468,"props":1530,"children":1531},{},[1532,1541],{"type":39,"tag":1490,"props":1533,"children":1534},{},[1535],{"type":39,"tag":61,"props":1536,"children":1538},{"className":1537},[],[1539],{"type":45,"value":1540},"department == \"support\"",{"type":39,"tag":1490,"props":1542,"children":1543},{},[1544],{"type":45,"value":1545},"Workers in support department",{"type":39,"tag":1468,"props":1547,"children":1548},{},[1549,1558],{"type":39,"tag":1490,"props":1550,"children":1551},{},[1552],{"type":39,"tag":61,"props":1553,"children":1555},{"className":1554},[],[1556],{"type":45,"value":1557},"experience > 5",{"type":39,"tag":1490,"props":1559,"children":1560},{},[1561],{"type":45,"value":1562},"Workers with 5+ years experience",{"type":39,"tag":1468,"props":1564,"children":1565},{},[1566,1575],{"type":39,"tag":1490,"props":1567,"children":1568},{},[1569],{"type":39,"tag":61,"props":1570,"children":1572},{"className":1571},[],[1573],{"type":45,"value":1574},"skills HAS \"billing\" AND languages HAS \"es\"",{"type":39,"tag":1490,"props":1576,"children":1577},{},[1578],{"type":45,"value":1579},"Spanish-speaking billing agents",{"type":39,"tag":1448,"props":1581,"children":1583},{"id":1582},"priority-routing",[1584],{"type":45,"value":1585},"Priority Routing",{"type":39,"tag":48,"props":1587,"children":1588},{},[1589],{"type":45,"value":1590},"Tasks with higher priority are assigned first:",{"type":39,"tag":54,"props":1592,"children":1594},{"className":201,"code":1593,"language":203,"meta":63,"style":63},"# VIP customer — priority 10 (higher = first)\ntask = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n attributes='{\"department\": \"billing\", \"priority\": 10, \"vip\": true}',\n workflow_sid=workflow.sid,\n priority=10\n)\n",[1595],{"type":39,"tag":61,"props":1596,"children":1597},{"__ignoreMap":63},[1598,1606,1613,1621,1629,1637],{"type":39,"tag":209,"props":1599,"children":1600},{"class":211,"line":212},[1601],{"type":39,"tag":209,"props":1602,"children":1603},{},[1604],{"type":45,"value":1605},"# VIP customer — priority 10 (higher = first)\n",{"type":39,"tag":209,"props":1607,"children":1608},{"class":211,"line":221},[1609],{"type":39,"tag":209,"props":1610,"children":1611},{},[1612],{"type":45,"value":1158},{"type":39,"tag":209,"props":1614,"children":1615},{"class":211,"line":230},[1616],{"type":39,"tag":209,"props":1617,"children":1618},{},[1619],{"type":45,"value":1620}," attributes='{\"department\": \"billing\", \"priority\": 10, \"vip\": true}',\n",{"type":39,"tag":209,"props":1622,"children":1623},{"class":211,"line":240},[1624],{"type":39,"tag":209,"props":1625,"children":1626},{},[1627],{"type":45,"value":1628}," workflow_sid=workflow.sid,\n",{"type":39,"tag":209,"props":1630,"children":1631},{"class":211,"line":249},[1632],{"type":39,"tag":209,"props":1633,"children":1634},{},[1635],{"type":45,"value":1636}," priority=10\n",{"type":39,"tag":209,"props":1638,"children":1639},{"class":211,"line":257},[1640],{"type":39,"tag":209,"props":1641,"children":1642},{},[1643],{"type":45,"value":290},{"type":39,"tag":1448,"props":1645,"children":1647},{"id":1646},"ai-agent-escalation",[1648],{"type":45,"value":1649},"AI Agent Escalation",{"type":39,"tag":48,"props":1651,"children":1652},{},[1653],{"type":45,"value":1654},"When an AI agent (via TAC) escalates to a human, create a TaskRouter task with the AI's context:",{"type":39,"tag":54,"props":1656,"children":1658},{"className":201,"code":1657,"language":203,"meta":63,"style":63},"# From your escalation webhook handler\ndef handle_escalation(escalation_data):\n task = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n attributes=json.dumps({\n \"department\": escalation_data[\"reason_code\"],\n \"conversation_id\": escalation_data[\"conversation_id\"],\n \"profile_id\": escalation_data[\"profile_id\"],\n \"ai_summary\": escalation_data[\"summary\"],\n \"priority\": 5\n }),\n workflow_sid=workflow.sid\n )\n",[1659],{"type":39,"tag":61,"props":1660,"children":1661},{"__ignoreMap":63},[1662,1670,1678,1686,1694,1702,1710,1718,1726,1734,1742,1750],{"type":39,"tag":209,"props":1663,"children":1664},{"class":211,"line":212},[1665],{"type":39,"tag":209,"props":1666,"children":1667},{},[1668],{"type":45,"value":1669},"# From your escalation webhook handler\n",{"type":39,"tag":209,"props":1671,"children":1672},{"class":211,"line":221},[1673],{"type":39,"tag":209,"props":1674,"children":1675},{},[1676],{"type":45,"value":1677},"def handle_escalation(escalation_data):\n",{"type":39,"tag":209,"props":1679,"children":1680},{"class":211,"line":230},[1681],{"type":39,"tag":209,"props":1682,"children":1683},{},[1684],{"type":45,"value":1685}," task = client.taskrouter.v1.workspaces(workspace_sid).tasks.create(\n",{"type":39,"tag":209,"props":1687,"children":1688},{"class":211,"line":240},[1689],{"type":39,"tag":209,"props":1690,"children":1691},{},[1692],{"type":45,"value":1693}," attributes=json.dumps({\n",{"type":39,"tag":209,"props":1695,"children":1696},{"class":211,"line":249},[1697],{"type":39,"tag":209,"props":1698,"children":1699},{},[1700],{"type":45,"value":1701}," \"department\": escalation_data[\"reason_code\"],\n",{"type":39,"tag":209,"props":1703,"children":1704},{"class":211,"line":257},[1705],{"type":39,"tag":209,"props":1706,"children":1707},{},[1708],{"type":45,"value":1709}," \"conversation_id\": escalation_data[\"conversation_id\"],\n",{"type":39,"tag":209,"props":1711,"children":1712},{"class":211,"line":266},[1713],{"type":39,"tag":209,"props":1714,"children":1715},{},[1716],{"type":45,"value":1717}," \"profile_id\": escalation_data[\"profile_id\"],\n",{"type":39,"tag":209,"props":1719,"children":1720},{"class":211,"line":275},[1721],{"type":39,"tag":209,"props":1722,"children":1723},{},[1724],{"type":45,"value":1725}," \"ai_summary\": escalation_data[\"summary\"],\n",{"type":39,"tag":209,"props":1727,"children":1728},{"class":211,"line":284},[1729],{"type":39,"tag":209,"props":1730,"children":1731},{},[1732],{"type":45,"value":1733}," \"priority\": 5\n",{"type":39,"tag":209,"props":1735,"children":1736},{"class":211,"line":293},[1737],{"type":39,"tag":209,"props":1738,"children":1739},{},[1740],{"type":45,"value":1741}," }),\n",{"type":39,"tag":209,"props":1743,"children":1744},{"class":211,"line":301},[1745],{"type":39,"tag":209,"props":1746,"children":1747},{},[1748],{"type":45,"value":1749}," workflow_sid=workflow.sid\n",{"type":39,"tag":209,"props":1751,"children":1752},{"class":211,"line":310},[1753],{"type":39,"tag":209,"props":1754,"children":1755},{},[1756],{"type":45,"value":1757}," )\n",{"type":39,"tag":48,"props":1759,"children":1760},{},[1761],{"type":45,"value":1762},"The human agent receives the AI's conversation summary and customer profile.",{"type":39,"tag":1448,"props":1764,"children":1766},{"id":1765},"workflow-with-timeout-escalation",[1767],{"type":45,"value":1768},"Workflow with Timeout Escalation",{"type":39,"tag":48,"props":1770,"children":1771},{},[1772],{"type":45,"value":1773},"Route to specialized queue first, then overflow to general:",{"type":39,"tag":54,"props":1775,"children":1777},{"className":201,"code":1776,"language":203,"meta":63,"style":63},"workflow_config = {\n \"task_routing\": {\n \"filters\": [\n {\n \"filter_friendly_name\": \"Billing Specialist First\",\n \"expression\": \"department == 'billing'\",\n \"targets\": [\n {\"queue\": billing_queue.sid, \"timeout\": 60}, # Try billing queue for 60s\n {\"queue\": default_queue.sid, \"timeout\": 120} # Overflow to general\n ]\n }\n ],\n \"default_filter\": {\n \"queue\": default_queue.sid\n }\n }\n}\n",[1778],{"type":39,"tag":61,"props":1779,"children":1780},{"__ignoreMap":63},[1781,1788,1795,1802,1809,1817,1824,1831,1839,1847,1854,1861,1868,1875,1882,1889,1896],{"type":39,"tag":209,"props":1782,"children":1783},{"class":211,"line":212},[1784],{"type":39,"tag":209,"props":1785,"children":1786},{},[1787],{"type":45,"value":895},{"type":39,"tag":209,"props":1789,"children":1790},{"class":211,"line":221},[1791],{"type":39,"tag":209,"props":1792,"children":1793},{},[1794],{"type":45,"value":903},{"type":39,"tag":209,"props":1796,"children":1797},{"class":211,"line":230},[1798],{"type":39,"tag":209,"props":1799,"children":1800},{},[1801],{"type":45,"value":911},{"type":39,"tag":209,"props":1803,"children":1804},{"class":211,"line":240},[1805],{"type":39,"tag":209,"props":1806,"children":1807},{},[1808],{"type":45,"value":919},{"type":39,"tag":209,"props":1810,"children":1811},{"class":211,"line":249},[1812],{"type":39,"tag":209,"props":1813,"children":1814},{},[1815],{"type":45,"value":1816}," \"filter_friendly_name\": \"Billing Specialist First\",\n",{"type":39,"tag":209,"props":1818,"children":1819},{"class":211,"line":257},[1820],{"type":39,"tag":209,"props":1821,"children":1822},{},[1823],{"type":45,"value":935},{"type":39,"tag":209,"props":1825,"children":1826},{"class":211,"line":266},[1827],{"type":39,"tag":209,"props":1828,"children":1829},{},[1830],{"type":45,"value":943},{"type":39,"tag":209,"props":1832,"children":1833},{"class":211,"line":275},[1834],{"type":39,"tag":209,"props":1835,"children":1836},{},[1837],{"type":45,"value":1838}," {\"queue\": billing_queue.sid, \"timeout\": 60}, # Try billing queue for 60s\n",{"type":39,"tag":209,"props":1840,"children":1841},{"class":211,"line":284},[1842],{"type":39,"tag":209,"props":1843,"children":1844},{},[1845],{"type":45,"value":1846}," {\"queue\": default_queue.sid, \"timeout\": 120} # Overflow to general\n",{"type":39,"tag":209,"props":1848,"children":1849},{"class":211,"line":293},[1850],{"type":39,"tag":209,"props":1851,"children":1852},{},[1853],{"type":45,"value":959},{"type":39,"tag":209,"props":1855,"children":1856},{"class":211,"line":301},[1857],{"type":39,"tag":209,"props":1858,"children":1859},{},[1860],{"type":45,"value":1022},{"type":39,"tag":209,"props":1862,"children":1863},{"class":211,"line":310},[1864],{"type":39,"tag":209,"props":1865,"children":1866},{},[1867],{"type":45,"value":1031},{"type":39,"tag":209,"props":1869,"children":1870},{"class":211,"line":520},[1871],{"type":39,"tag":209,"props":1872,"children":1873},{},[1874],{"type":45,"value":1040},{"type":39,"tag":209,"props":1876,"children":1877},{"class":211,"line":529},[1878],{"type":39,"tag":209,"props":1879,"children":1880},{},[1881],{"type":45,"value":1049},{"type":39,"tag":209,"props":1883,"children":1884},{"class":211,"line":827},[1885],{"type":39,"tag":209,"props":1886,"children":1887},{},[1888],{"type":45,"value":1058},{"type":39,"tag":209,"props":1890,"children":1891},{"class":211,"line":836},[1892],{"type":39,"tag":209,"props":1893,"children":1894},{},[1895],{"type":45,"value":1067},{"type":39,"tag":209,"props":1897,"children":1898},{"class":211,"line":845},[1899],{"type":39,"tag":209,"props":1900,"children":1901},{},[1902],{"type":45,"value":1076},{"type":39,"tag":1448,"props":1904,"children":1906},{"id":1905},"worker-activity-management",[1907],{"type":45,"value":1908},"Worker Activity Management",{"type":39,"tag":54,"props":1910,"children":1912},{"className":201,"code":1911,"language":203,"meta":63,"style":63},"# Set worker to available\nclient.taskrouter.v1.workspaces(workspace_sid) \\\n .workers(worker_sid) \\\n .update(activity_sid=available_activity_sid)\n\n# Get real-time worker statistics\nstats = client.taskrouter.v1.workspaces(workspace_sid) \\\n .workers \\\n .statistics() \\\n .fetch()\n\nprint(f\"Available: {stats.realtime['total_available_workers']}\")\n",[1913],{"type":39,"tag":61,"props":1914,"children":1915},{"__ignoreMap":63},[1916,1924,1932,1940,1948,1955,1963,1971,1979,1987,1995,2002],{"type":39,"tag":209,"props":1917,"children":1918},{"class":211,"line":212},[1919],{"type":39,"tag":209,"props":1920,"children":1921},{},[1922],{"type":45,"value":1923},"# Set worker to available\n",{"type":39,"tag":209,"props":1925,"children":1926},{"class":211,"line":221},[1927],{"type":39,"tag":209,"props":1928,"children":1929},{},[1930],{"type":45,"value":1931},"client.taskrouter.v1.workspaces(workspace_sid) \\\n",{"type":39,"tag":209,"props":1933,"children":1934},{"class":211,"line":230},[1935],{"type":39,"tag":209,"props":1936,"children":1937},{},[1938],{"type":45,"value":1939}," .workers(worker_sid) \\\n",{"type":39,"tag":209,"props":1941,"children":1942},{"class":211,"line":240},[1943],{"type":39,"tag":209,"props":1944,"children":1945},{},[1946],{"type":45,"value":1947}," .update(activity_sid=available_activity_sid)\n",{"type":39,"tag":209,"props":1949,"children":1950},{"class":211,"line":249},[1951],{"type":39,"tag":209,"props":1952,"children":1953},{"emptyLinePlaceholder":234},[1954],{"type":45,"value":237},{"type":39,"tag":209,"props":1956,"children":1957},{"class":211,"line":257},[1958],{"type":39,"tag":209,"props":1959,"children":1960},{},[1961],{"type":45,"value":1962},"# Get real-time worker statistics\n",{"type":39,"tag":209,"props":1964,"children":1965},{"class":211,"line":266},[1966],{"type":39,"tag":209,"props":1967,"children":1968},{},[1969],{"type":45,"value":1970},"stats = client.taskrouter.v1.workspaces(workspace_sid) \\\n",{"type":39,"tag":209,"props":1972,"children":1973},{"class":211,"line":275},[1974],{"type":39,"tag":209,"props":1975,"children":1976},{},[1977],{"type":45,"value":1978}," .workers \\\n",{"type":39,"tag":209,"props":1980,"children":1981},{"class":211,"line":284},[1982],{"type":39,"tag":209,"props":1983,"children":1984},{},[1985],{"type":45,"value":1986}," .statistics() \\\n",{"type":39,"tag":209,"props":1988,"children":1989},{"class":211,"line":293},[1990],{"type":39,"tag":209,"props":1991,"children":1992},{},[1993],{"type":45,"value":1994}," .fetch()\n",{"type":39,"tag":209,"props":1996,"children":1997},{"class":211,"line":301},[1998],{"type":39,"tag":209,"props":1999,"children":2000},{"emptyLinePlaceholder":234},[2001],{"type":45,"value":237},{"type":39,"tag":209,"props":2003,"children":2004},{"class":211,"line":310},[2005],{"type":39,"tag":209,"props":2006,"children":2007},{},[2008],{"type":45,"value":2009},"print(f\"Available: {stats.realtime['total_available_workers']}\")\n",{"type":39,"tag":78,"props":2011,"children":2012},{},[],{"type":39,"tag":40,"props":2014,"children":2016},{"id":2015},"scale-guidance",[2017],{"type":45,"value":2018},"Scale Guidance",{"type":39,"tag":1460,"props":2020,"children":2021},{},[2022,2043],{"type":39,"tag":1464,"props":2023,"children":2024},{},[2025],{"type":39,"tag":1468,"props":2026,"children":2027},{},[2028,2033,2038],{"type":39,"tag":1472,"props":2029,"children":2030},{},[2031],{"type":45,"value":2032},"Agents",{"type":39,"tag":1472,"props":2034,"children":2035},{},[2036],{"type":45,"value":2037},"Architecture",{"type":39,"tag":1472,"props":2039,"children":2040},{},[2041],{"type":45,"value":2042},"Notes",{"type":39,"tag":1483,"props":2044,"children":2045},{},[2046,2064,2082],{"type":39,"tag":1468,"props":2047,"children":2048},{},[2049,2054,2059],{"type":39,"tag":1490,"props":2050,"children":2051},{},[2052],{"type":45,"value":2053},"\u003C 10",{"type":39,"tag":1490,"props":2055,"children":2056},{},[2057],{"type":45,"value":2058},"Single workflow, one queue per skill",{"type":39,"tag":1490,"props":2060,"children":2061},{},[2062],{"type":45,"value":2063},"No Flex needed — agents use phone",{"type":39,"tag":1468,"props":2065,"children":2066},{},[2067,2072,2077],{"type":39,"tag":1490,"props":2068,"children":2069},{},[2070],{"type":45,"value":2071},"10-50",{"type":39,"tag":1490,"props":2073,"children":2074},{},[2075],{"type":45,"value":2076},"Multi-queue workflows, skills-based routing",{"type":39,"tag":1490,"props":2078,"children":2079},{},[2080],{"type":45,"value":2081},"Flex recommended for desktop",{"type":39,"tag":1468,"props":2083,"children":2084},{},[2085,2090,2095],{"type":39,"tag":1490,"props":2086,"children":2087},{},[2088],{"type":45,"value":2089},"50+",{"type":39,"tag":1490,"props":2091,"children":2092},{},[2093],{"type":45,"value":2094},"Multi-tier workflows, priority routing, real-time monitoring",{"type":39,"tag":1490,"props":2096,"children":2097},{},[2098],{"type":45,"value":2099},"Full Flex + supervisor tools",{"type":39,"tag":78,"props":2101,"children":2102},{},[],{"type":39,"tag":40,"props":2104,"children":2106},{"id":2105},"gotchas",[2107],{"type":45,"value":2108},"Gotchas",{"type":39,"tag":1448,"props":2110,"children":2112},{"id":2111},"_1-hyphens-in-attribute-names-break-silently",[2113],{"type":45,"value":2114},"1. Hyphens in Attribute Names Break Silently",{"type":39,"tag":54,"props":2116,"children":2118},{"className":201,"code":2117,"language":203,"meta":63,"style":63},"# WRONG — hyphens in attribute keys break workflow expressions\nworker = client.taskrouter.v1.workspaces(workspace_sid).workers.create(\n friendly_name=\"Alice\",\n attributes='{\"skill-level\": 5}' # hyphen breaks expression evaluation\n)\n\n# RIGHT — use underscores or camelCase\nworker = client.taskrouter.v1.workspaces(workspace_sid).workers.create(\n friendly_name=\"Alice\",\n attributes='{\"skill_level\": 5}'\n)\n",[2119],{"type":39,"tag":61,"props":2120,"children":2121},{"__ignoreMap":63},[2122,2130,2137,2144,2152,2159,2166,2174,2181,2188,2196],{"type":39,"tag":209,"props":2123,"children":2124},{"class":211,"line":212},[2125],{"type":39,"tag":209,"props":2126,"children":2127},{},[2128],{"type":45,"value":2129},"# WRONG — hyphens in attribute keys break workflow expressions\n",{"type":39,"tag":209,"props":2131,"children":2132},{"class":211,"line":221},[2133],{"type":39,"tag":209,"props":2134,"children":2135},{},[2136],{"type":45,"value":594},{"type":39,"tag":209,"props":2138,"children":2139},{"class":211,"line":230},[2140],{"type":39,"tag":209,"props":2141,"children":2142},{},[2143],{"type":45,"value":602},{"type":39,"tag":209,"props":2145,"children":2146},{"class":211,"line":240},[2147],{"type":39,"tag":209,"props":2148,"children":2149},{},[2150],{"type":45,"value":2151}," attributes='{\"skill-level\": 5}' # hyphen breaks expression evaluation\n",{"type":39,"tag":209,"props":2153,"children":2154},{"class":211,"line":249},[2155],{"type":39,"tag":209,"props":2156,"children":2157},{},[2158],{"type":45,"value":290},{"type":39,"tag":209,"props":2160,"children":2161},{"class":211,"line":257},[2162],{"type":39,"tag":209,"props":2163,"children":2164},{"emptyLinePlaceholder":234},[2165],{"type":45,"value":237},{"type":39,"tag":209,"props":2167,"children":2168},{"class":211,"line":266},[2169],{"type":39,"tag":209,"props":2170,"children":2171},{},[2172],{"type":45,"value":2173},"# RIGHT — use underscores or camelCase\n",{"type":39,"tag":209,"props":2175,"children":2176},{"class":211,"line":275},[2177],{"type":39,"tag":209,"props":2178,"children":2179},{},[2180],{"type":45,"value":594},{"type":39,"tag":209,"props":2182,"children":2183},{"class":211,"line":284},[2184],{"type":39,"tag":209,"props":2185,"children":2186},{},[2187],{"type":45,"value":602},{"type":39,"tag":209,"props":2189,"children":2190},{"class":211,"line":293},[2191],{"type":39,"tag":209,"props":2192,"children":2193},{},[2194],{"type":45,"value":2195}," attributes='{\"skill_level\": 5}'\n",{"type":39,"tag":209,"props":2197,"children":2198},{"class":211,"line":301},[2199],{"type":39,"tag":209,"props":2200,"children":2201},{},[2202],{"type":45,"value":290},{"type":39,"tag":48,"props":2204,"children":2205},{},[2206],{"type":45,"value":2207},"No error — the expression silently fails to match.",{"type":39,"tag":1448,"props":2209,"children":2211},{"id":2210},"_2-has-operator-on-non-array-attributes",[2212],{"type":45,"value":2213},"2. HAS Operator on Non-Array Attributes",{"type":39,"tag":54,"props":2215,"children":2217},{"className":201,"code":2216,"language":203,"meta":63,"style":63},"# WRONG — \"billing\" is a string, not an array. HAS silently matches nothing.\ntarget_workers = 'department HAS \"billing\"'\n\n# RIGHT — use == for string attributes\ntarget_workers = 'department == \"billing\"'\n\n# RIGHT — use HAS only for arrays\ntarget_workers = 'skills HAS \"billing\"' # skills: [\"billing\", \"technical\"]\n",[2218],{"type":39,"tag":61,"props":2219,"children":2220},{"__ignoreMap":63},[2221,2229,2237,2244,2252,2260,2267,2275],{"type":39,"tag":209,"props":2222,"children":2223},{"class":211,"line":212},[2224],{"type":39,"tag":209,"props":2225,"children":2226},{},[2227],{"type":45,"value":2228},"# WRONG — \"billing\" is a string, not an array. HAS silently matches nothing.\n",{"type":39,"tag":209,"props":2230,"children":2231},{"class":211,"line":221},[2232],{"type":39,"tag":209,"props":2233,"children":2234},{},[2235],{"type":45,"value":2236},"target_workers = 'department HAS \"billing\"'\n",{"type":39,"tag":209,"props":2238,"children":2239},{"class":211,"line":230},[2240],{"type":39,"tag":209,"props":2241,"children":2242},{"emptyLinePlaceholder":234},[2243],{"type":45,"value":237},{"type":39,"tag":209,"props":2245,"children":2246},{"class":211,"line":240},[2247],{"type":39,"tag":209,"props":2248,"children":2249},{},[2250],{"type":45,"value":2251},"# RIGHT — use == for string attributes\n",{"type":39,"tag":209,"props":2253,"children":2254},{"class":211,"line":249},[2255],{"type":39,"tag":209,"props":2256,"children":2257},{},[2258],{"type":45,"value":2259},"target_workers = 'department == \"billing\"'\n",{"type":39,"tag":209,"props":2261,"children":2262},{"class":211,"line":257},[2263],{"type":39,"tag":209,"props":2264,"children":2265},{"emptyLinePlaceholder":234},[2266],{"type":45,"value":237},{"type":39,"tag":209,"props":2268,"children":2269},{"class":211,"line":266},[2270],{"type":39,"tag":209,"props":2271,"children":2272},{},[2273],{"type":45,"value":2274},"# RIGHT — use HAS only for arrays\n",{"type":39,"tag":209,"props":2276,"children":2277},{"class":211,"line":275},[2278],{"type":39,"tag":209,"props":2279,"children":2280},{},[2281],{"type":45,"value":2282},"target_workers = 'skills HAS \"billing\"' # skills: [\"billing\", \"technical\"]\n",{"type":39,"tag":48,"props":2284,"children":2285},{},[2286],{"type":45,"value":2287},"Tasks sit in queue forever with no error.",{"type":39,"tag":1448,"props":2289,"children":2291},{"id":2290},"_3-reservation-timeout-cascade",[2292],{"type":45,"value":2293},"3. Reservation Timeout Cascade",{"type":39,"tag":48,"props":2295,"children":2296},{},[2297],{"type":45,"value":2298},"When a reservation times out:",{"type":39,"tag":2300,"props":2301,"children":2302},"ol",{},[2303,2308,2313],{"type":39,"tag":92,"props":2304,"children":2305},{},[2306],{"type":45,"value":2307},"Worker moves to the timeout Activity (often \"Offline\")",{"type":39,"tag":92,"props":2309,"children":2310},{},[2311],{"type":45,"value":2312},"Fewer workers available → other reservations also time out",{"type":39,"tag":92,"props":2314,"children":2315},{},[2316],{"type":45,"value":2317},"Positive feedback loop → entire queue backs up",{"type":39,"tag":48,"props":2319,"children":2320},{},[2321,2326],{"type":39,"tag":70,"props":2322,"children":2323},{},[2324],{"type":45,"value":2325},"Fix:",{"type":45,"value":2327}," Set the timeout Activity to a short-duration state, not \"Offline\". Or implement a reservation timeout handler that keeps the worker available:",{"type":39,"tag":54,"props":2329,"children":2331},{"className":201,"code":2330,"language":203,"meta":63,"style":63},"@app.route(\"\u002Ftaskrouter-events\", methods=[\"POST\"])\ndef taskrouter_event():\n event_type = request.form[\"EventType\"]\n if event_type == \"reservation.timeout\":\n worker_sid = request.form[\"WorkerSid\"]\n # Keep worker available instead of moving to offline\n client.taskrouter.v1.workspaces(workspace_sid) \\\n .workers(worker_sid) \\\n .update(activity_sid=available_activity_sid)\n return \"\", 200\n",[2332],{"type":39,"tag":61,"props":2333,"children":2334},{"__ignoreMap":63},[2335,2343,2351,2359,2367,2375,2383,2391,2399,2407],{"type":39,"tag":209,"props":2336,"children":2337},{"class":211,"line":212},[2338],{"type":39,"tag":209,"props":2339,"children":2340},{},[2341],{"type":45,"value":2342},"@app.route(\"\u002Ftaskrouter-events\", methods=[\"POST\"])\n",{"type":39,"tag":209,"props":2344,"children":2345},{"class":211,"line":221},[2346],{"type":39,"tag":209,"props":2347,"children":2348},{},[2349],{"type":45,"value":2350},"def taskrouter_event():\n",{"type":39,"tag":209,"props":2352,"children":2353},{"class":211,"line":230},[2354],{"type":39,"tag":209,"props":2355,"children":2356},{},[2357],{"type":45,"value":2358}," event_type = request.form[\"EventType\"]\n",{"type":39,"tag":209,"props":2360,"children":2361},{"class":211,"line":240},[2362],{"type":39,"tag":209,"props":2363,"children":2364},{},[2365],{"type":45,"value":2366}," if event_type == \"reservation.timeout\":\n",{"type":39,"tag":209,"props":2368,"children":2369},{"class":211,"line":249},[2370],{"type":39,"tag":209,"props":2371,"children":2372},{},[2373],{"type":45,"value":2374}," worker_sid = request.form[\"WorkerSid\"]\n",{"type":39,"tag":209,"props":2376,"children":2377},{"class":211,"line":257},[2378],{"type":39,"tag":209,"props":2379,"children":2380},{},[2381],{"type":45,"value":2382}," # Keep worker available instead of moving to offline\n",{"type":39,"tag":209,"props":2384,"children":2385},{"class":211,"line":266},[2386],{"type":39,"tag":209,"props":2387,"children":2388},{},[2389],{"type":45,"value":2390}," client.taskrouter.v1.workspaces(workspace_sid) \\\n",{"type":39,"tag":209,"props":2392,"children":2393},{"class":211,"line":275},[2394],{"type":39,"tag":209,"props":2395,"children":2396},{},[2397],{"type":45,"value":2398}," .workers(worker_sid) \\\n",{"type":39,"tag":209,"props":2400,"children":2401},{"class":211,"line":284},[2402],{"type":39,"tag":209,"props":2403,"children":2404},{},[2405],{"type":45,"value":2406}," .update(activity_sid=available_activity_sid)\n",{"type":39,"tag":209,"props":2408,"children":2409},{"class":211,"line":293},[2410],{"type":39,"tag":209,"props":2411,"children":2412},{},[2413],{"type":45,"value":2414}," return \"\", 200\n",{"type":39,"tag":1448,"props":2416,"children":2418},{"id":2417},"_4-activity-available-flag",[2419],{"type":45,"value":2420},"4. Activity Available Flag",{"type":39,"tag":48,"props":2422,"children":2423},{},[2424,2426,2432],{"type":45,"value":2425},"Updating an Activity's ",{"type":39,"tag":61,"props":2427,"children":2429},{"className":2428},[],[2430],{"type":45,"value":2431},"available",{"type":45,"value":2433}," flag returns 200 OK but may not change the value if workers are currently in that activity. Create new activities instead of modifying existing ones.",{"type":39,"tag":78,"props":2435,"children":2436},{},[],{"type":39,"tag":40,"props":2438,"children":2440},{"id":2439},"cannot",[2441],{"type":45,"value":2442},"CANNOT",{"type":39,"tag":88,"props":2444,"children":2445},{},[2446,2488,2511,2521,2538,2554,2564,2582,2600,2616,2626,2636,2646,2677,2687,2697,2707,2716],{"type":39,"tag":92,"props":2447,"children":2448},{},[2449,2454,2456,2462,2464,2470,2472,2478,2480,2486],{"type":39,"tag":70,"props":2450,"children":2451},{},[2452],{"type":45,"value":2453},"Hyphens in attribute names break expressions",{"type":45,"value":2455}," — ",{"type":39,"tag":61,"props":2457,"children":2459},{"className":2458},[],[2460],{"type":45,"value":2461},"skill-level",{"type":45,"value":2463}," is treated as subtraction (",{"type":39,"tag":61,"props":2465,"children":2467},{"className":2466},[],[2468],{"type":45,"value":2469},"skill",{"type":45,"value":2471}," minus ",{"type":39,"tag":61,"props":2473,"children":2475},{"className":2474},[],[2476],{"type":45,"value":2477},"level",{"type":45,"value":2479},"). Error 20001. Always use underscores: ",{"type":39,"tag":61,"props":2481,"children":2483},{"className":2482},[],[2484],{"type":45,"value":2485},"skill_level",{"type":45,"value":2487},".",{"type":39,"tag":92,"props":2489,"children":2490},{},[2491,2502,2503,2509],{"type":39,"tag":70,"props":2492,"children":2493},{},[2494,2500],{"type":39,"tag":61,"props":2495,"children":2497},{"className":2496},[],[2498],{"type":45,"value":2499},"HAS",{"type":45,"value":2501}," on non-array silently matches nothing",{"type":45,"value":2455},{"type":39,"tag":61,"props":2504,"children":2506},{"className":2505},[],[2507],{"type":45,"value":2508},"department HAS \"billing\"",{"type":45,"value":2510}," on a string attribute is accepted at creation but never matches. Tasks sit in queue forever with no error.",{"type":39,"tag":92,"props":2512,"children":2513},{},[2514,2519],{"type":39,"tag":70,"props":2515,"children":2516},{},[2517],{"type":45,"value":2518},"Expression validation is syntactic only",{"type":45,"value":2520}," — Queue creation validates parse but NOT worker matching. Semantically wrong expressions create successfully with zero matching workers.",{"type":39,"tag":92,"props":2522,"children":2523},{},[2524,2536],{"type":39,"tag":70,"props":2525,"children":2526},{},[2527,2529,2534],{"type":45,"value":2528},"Activity ",{"type":39,"tag":61,"props":2530,"children":2532},{"className":2531},[],[2533],{"type":45,"value":2431},{"type":45,"value":2535}," flag is silently immutable",{"type":45,"value":2537}," — Updating returns 200 OK but does not change the value. Must delete and recreate the Activity.",{"type":39,"tag":92,"props":2539,"children":2540},{},[2541,2552],{"type":39,"tag":70,"props":2542,"children":2543},{},[2544,2550],{"type":39,"tag":61,"props":2545,"children":2547},{"className":2546},[],[2548],{"type":45,"value":2549},"multiTaskEnabled",{"type":45,"value":2551}," cannot be reverted to false",{"type":45,"value":2553}," — Once enabled on a Workspace, cannot be disabled. One-way door.",{"type":39,"tag":92,"props":2555,"children":2556},{},[2557,2562],{"type":39,"tag":70,"props":2558,"children":2559},{},[2560],{"type":45,"value":2561},"Reservation timeout moves worker to timeout Activity",{"type":45,"value":2563}," — Worker automatically moved to Offline. Must manually set back. This cascades: fewer available workers → more timeouts → queue collapse. See Gotcha #3.",{"type":39,"tag":92,"props":2565,"children":2566},{},[2567,2572,2574,2580],{"type":39,"tag":70,"props":2568,"children":2569},{},[2570],{"type":45,"value":2571},"Workflow target timeout auto-cancels tasks",{"type":45,"value":2573}," — When all targets exhaust timeouts, task is canceled. Always include a ",{"type":39,"tag":61,"props":2575,"children":2577},{"className":2576},[],[2578],{"type":45,"value":2579},"default_filter",{"type":45,"value":2581}," as catch-all.",{"type":39,"tag":92,"props":2583,"children":2584},{},[2585,2598],{"type":39,"tag":70,"props":2586,"children":2587},{},[2588,2590,2596],{"type":45,"value":2589},"Worker ",{"type":39,"tag":61,"props":2591,"children":2593},{"className":2592},[],[2594],{"type":45,"value":2595},"friendlyName",{"type":45,"value":2597}," is case-insensitive unique",{"type":45,"value":2599}," — \"alice\" collides with \"Alice\".",{"type":39,"tag":92,"props":2601,"children":2602},{},[2603,2614],{"type":39,"tag":70,"props":2604,"children":2605},{},[2606,2612],{"type":39,"tag":61,"props":2607,"children":2609},{"className":2608},[],[2610],{"type":45,"value":2611},"workflowSid",{"type":45,"value":2613}," is required for task creation",{"type":45,"value":2615}," — API does not auto-select a default Workflow.",{"type":39,"tag":92,"props":2617,"children":2618},{},[2619,2624],{"type":39,"tag":70,"props":2620,"children":2621},{},[2622],{"type":45,"value":2623},"Cannot update task status and attributes in same request",{"type":45,"value":2625}," — Must be two separate API calls.",{"type":39,"tag":92,"props":2627,"children":2628},{},[2629,2634],{"type":39,"tag":70,"props":2630,"children":2631},{},[2632],{"type":45,"value":2633},"Assignment callback must respond in 5 seconds",{"type":45,"value":2635}," — If both primary and fallback URLs fail, reservation is canceled.",{"type":39,"tag":92,"props":2637,"children":2638},{},[2639,2644],{"type":39,"tag":70,"props":2640,"children":2641},{},[2642],{"type":45,"value":2643},"Tasks auto-cancel after 1,000 rejections",{"type":45,"value":2645}," — If a task cycles through 1,000 reservation rejections, it is automatically canceled.",{"type":39,"tag":92,"props":2647,"children":2648},{},[2649,2660,2662,2668,2670,2675],{"type":39,"tag":70,"props":2650,"children":2651},{},[2652,2658],{"type":39,"tag":61,"props":2653,"children":2655},{"className":2654},[],[2656],{"type":45,"value":2657},"page",{"type":45,"value":2659}," query param not supported",{"type":45,"value":2661}," — Use ",{"type":39,"tag":61,"props":2663,"children":2665},{"className":2664},[],[2666],{"type":45,"value":2667},"PageToken",{"type":45,"value":2669}," for pagination. ",{"type":39,"tag":61,"props":2671,"children":2673},{"className":2672},[],[2674],{"type":45,"value":2657},{"type":45,"value":2676}," returns error 40153.",{"type":39,"tag":92,"props":2678,"children":2679},{},[2680,2685],{"type":39,"tag":70,"props":2681,"children":2682},{},[2683],{"type":45,"value":2684},"Cannot use malformed JSON in worker attributes",{"type":45,"value":2686}," — Silently breaks matching with no error",{"type":39,"tag":92,"props":2688,"children":2689},{},[2690,2695],{"type":39,"tag":70,"props":2691,"children":2692},{},[2693],{"type":45,"value":2694},"Cannot use regex in workflow expressions",{"type":45,"value":2696}," — Only supports ==, !=, \u003C, >, HAS, IN, CONTAINS, AND, OR, NOT",{"type":39,"tag":92,"props":2698,"children":2699},{},[2700,2705],{"type":39,"tag":70,"props":2701,"children":2702},{},[2703],{"type":45,"value":2704},"Cannot exceed 50,000 Workers per Workspace",{"type":45,"value":2706}," — Hard limit",{"type":39,"tag":92,"props":2708,"children":2709},{},[2710,2715],{"type":39,"tag":70,"props":2711,"children":2712},{},[2713],{"type":45,"value":2714},"Cannot exceed 250 Task Queues per Workspace",{"type":45,"value":2706},{"type":39,"tag":92,"props":2717,"children":2718},{},[2719,2724],{"type":39,"tag":70,"props":2720,"children":2721},{},[2722],{"type":45,"value":2723},"Cannot delay reservation callback response beyond 15 seconds",{"type":45,"value":2725}," — Timeout results in reservation failure",{"type":39,"tag":78,"props":2727,"children":2728},{},[],{"type":39,"tag":40,"props":2730,"children":2732},{"id":2731},"next-steps",[2733],{"type":45,"value":2734},"Next Steps",{"type":39,"tag":88,"props":2736,"children":2737},{},[2738,2754,2769,2783],{"type":39,"tag":92,"props":2739,"children":2740},{},[2741,2746,2748],{"type":39,"tag":70,"props":2742,"children":2743},{},[2744],{"type":45,"value":2745},"Conference for transfers:",{"type":45,"value":2747}," ",{"type":39,"tag":61,"props":2749,"children":2751},{"className":2750},[],[2752],{"type":45,"value":2753},"twilio-conference-calls",{"type":39,"tag":92,"props":2755,"children":2756},{},[2757,2762,2763],{"type":39,"tag":70,"props":2758,"children":2759},{},[2760],{"type":45,"value":2761},"Call recording:",{"type":45,"value":2747},{"type":39,"tag":61,"props":2764,"children":2766},{"className":2765},[],[2767],{"type":45,"value":2768},"twilio-call-recordings",{"type":39,"tag":92,"props":2770,"children":2771},{},[2772,2777,2778],{"type":39,"tag":70,"props":2773,"children":2774},{},[2775],{"type":45,"value":2776},"AI agent voice integration:",{"type":45,"value":2747},{"type":39,"tag":61,"props":2779,"children":2781},{"className":2780},[],[2782],{"type":45,"value":168},{"type":39,"tag":92,"props":2784,"children":2785},{},[2786,2791,2792],{"type":39,"tag":70,"props":2787,"children":2788},{},[2789],{"type":45,"value":2790},"Voice IVR before routing:",{"type":45,"value":2747},{"type":39,"tag":61,"props":2793,"children":2795},{"className":2794},[],[2796],{"type":45,"value":157},{"type":39,"tag":2798,"props":2799,"children":2800},"style",{},[2801],{"type":45,"value":2802},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":2804,"total":2924},[2805,2823,2838,2850,2870,2892,2912],{"slug":2806,"name":2806,"fn":2807,"description":2808,"org":2809,"tags":2810,"stars":22,"repoUrl":23,"updatedAt":24},"accessibility-and-inclusive-visualization","make data visualizations accessible","Make data visualizations accessible and inclusive. Use when the user needs chart or diagram accessibility guidance, text alternatives for complex visuals, color and contrast review, keyboard support, reduced-motion behavior for animation or parallax, or an accessibility QA workflow for exported figures, UML-like diagrams, and dashboards.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2811,2814,2817,2820],{"name":2812,"slug":2813,"type":15},"Accessibility","accessibility",{"name":2815,"slug":2816,"type":15},"Charts","charts",{"name":2818,"slug":2819,"type":15},"Data Visualization","data-visualization",{"name":2821,"slug":2822,"type":15},"Design","design",{"slug":2824,"name":2824,"fn":2825,"description":2826,"org":2827,"tags":2828,"stars":22,"repoUrl":23,"updatedAt":2837},"agent-browser","automate browser interactions for agents","Browser automation CLI for AI agents. Use when the user needs to interact with websites, verify dev server output, test web apps, navigate pages, fill forms, click buttons, take screenshots, extract data, or automate any browser task. Also triggers when a dev server starts so you can verify it visually.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2829,2831,2834],{"name":2032,"slug":2830,"type":15},"agents",{"name":2832,"slug":2833,"type":15},"Browser Automation","browser-automation",{"name":2835,"slug":2836,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":2839,"name":2839,"fn":2840,"description":2841,"org":2842,"tags":2843,"stars":22,"repoUrl":23,"updatedAt":2849},"agent-browser-verify","verify dev server output with automated browser","Automated browser verification for dev servers. Triggers when a dev server starts to run a visual gut-check with agent-browser — verifies the page loads, checks for console errors, validates key UI elements, and reports pass\u002Ffail before continuing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2844,2845,2848],{"name":2832,"slug":2833,"type":15},{"name":2846,"slug":2847,"type":15},"Local Development","local-development",{"name":2835,"slug":2836,"type":15},"2026-04-06T18:41:17.526867",{"slug":2851,"name":2851,"fn":2852,"description":2853,"org":2854,"tags":2855,"stars":22,"repoUrl":23,"updatedAt":2869},"agents-sdk","build AI agents on Cloudflare Workers","Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2856,2857,2860,2863,2866],{"name":2032,"slug":2830,"type":15},{"name":2858,"slug":2859,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":2861,"slug":2862,"type":15},"SDK","sdk",{"name":2864,"slug":2865,"type":15},"Serverless","serverless",{"name":2867,"slug":2868,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":2871,"name":2871,"fn":2872,"description":2873,"org":2874,"tags":2875,"stars":22,"repoUrl":23,"updatedAt":2891},"ai-elements","build chat UIs with AI Elements","AI Elements component library guidance — pre-built React components for AI interfaces built on shadcn\u002Fui. Use when building chat UIs, message displays, tool call rendering, streaming responses, reasoning panels, or any AI-native interface with the AI SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2876,2879,2882,2885,2888],{"name":2877,"slug":2878,"type":15},"Frontend","frontend",{"name":2880,"slug":2881,"type":15},"React","react",{"name":2883,"slug":2884,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":2886,"slug":2887,"type":15},"UI Components","ui-components",{"name":2889,"slug":2890,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":2893,"name":2893,"fn":2894,"description":2895,"org":2896,"tags":2897,"stars":22,"repoUrl":23,"updatedAt":2911},"ai-gateway","configure Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2898,2901,2904,2907,2910],{"name":2899,"slug":2900,"type":15},"AI Infrastructure","ai-infrastructure",{"name":2902,"slug":2903,"type":15},"Cost Optimization","cost-optimization",{"name":2905,"slug":2906,"type":15},"LLM","llm",{"name":2908,"slug":2909,"type":15},"Performance","performance",{"name":2889,"slug":2890,"type":15},"2026-04-06T18:40:44.377464",{"slug":2913,"name":2913,"fn":2914,"description":2915,"org":2916,"tags":2917,"stars":22,"repoUrl":23,"updatedAt":2923},"ai-generation-persistence","implement persistence patterns for AI generations","AI generation persistence patterns — unique IDs, addressable URLs, database storage, and cost tracking for every LLM generation",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2918,2919,2922],{"name":2902,"slug":2903,"type":15},{"name":2920,"slug":2921,"type":15},"Database","database",{"name":2905,"slug":2906,"type":15},"2026-04-06T18:41:08.513425",600,{"items":2926,"total":3123},[2927,2948,2971,2988,3004,3021,3040,3052,3066,3080,3092,3107],{"slug":2928,"name":2928,"fn":2929,"description":2930,"org":2931,"tags":2932,"stars":2945,"repoUrl":2946,"updatedAt":2947},"prior-auth-packet-builder","build healthcare prior authorization packets","Build a concise prior authorization packet from local case files and payer policy docs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2933,2936,2939,2942],{"name":2934,"slug":2935,"type":15},"Documents","documents",{"name":2937,"slug":2938,"type":15},"Healthcare","healthcare",{"name":2940,"slug":2941,"type":15},"Insurance","insurance",{"name":2943,"slug":2944,"type":15},"Regulatory Compliance","regulatory-compliance",28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":2949,"name":2949,"fn":2950,"description":2951,"org":2952,"tags":2953,"stars":2968,"repoUrl":2969,"updatedAt":2970},"aspnet-core","build ASP.NET Core web applications","Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2954,2957,2959,2962,2965],{"name":2955,"slug":2956,"type":15},".NET","dotnet",{"name":2958,"slug":2949,"type":15},"ASP.NET Core",{"name":2960,"slug":2961,"type":15},"Blazor","blazor",{"name":2963,"slug":2964,"type":15},"C#","csharp",{"name":2966,"slug":2967,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":2972,"name":2972,"fn":2973,"description":2974,"org":2975,"tags":2976,"stars":2968,"repoUrl":2969,"updatedAt":2987},"chatgpt-apps","build ChatGPT Apps SDK applications","Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2977,2980,2983,2986],{"name":2978,"slug":2979,"type":15},"Apps SDK","apps-sdk",{"name":2981,"slug":2982,"type":15},"ChatGPT","chatgpt",{"name":2984,"slug":2985,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":2989,"name":2989,"fn":2990,"description":2991,"org":2992,"tags":2993,"stars":2968,"repoUrl":2969,"updatedAt":3003},"cli-creator","build CLIs from API docs","Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read\u002Fwrite commands, return stable JSON, manage auth, and pair with a companion skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[2994,2997,3000],{"name":2995,"slug":2996,"type":15},"API Development","api-development",{"name":2998,"slug":2999,"type":15},"CLI","cli",{"name":3001,"slug":3002,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":3005,"name":3005,"fn":3006,"description":3007,"org":3008,"tags":3009,"stars":2968,"repoUrl":2969,"updatedAt":3020},"cloudflare-deploy","deploy projects to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3010,3013,3016,3017],{"name":3011,"slug":3012,"type":15},"Cloudflare","cloudflare",{"name":3014,"slug":3015,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":2858,"slug":2859,"type":15},{"name":3018,"slug":3019,"type":15},"Deployment","deployment","2026-04-12T05:07:14.275118",{"slug":3022,"name":3022,"fn":3023,"description":3024,"org":3025,"tags":3026,"stars":2968,"repoUrl":2969,"updatedAt":3039},"define-goal","define and set measurable project goals","Help the user define a concrete, measurable goal before starting work, especially when they ask to use the goal tool, create a goal, set an objective, clarify success criteria, or turn a fuzzy intention into a quantitative outcome. Use this skill for goal creation and goal refinement only; it does not manage durable snapshots, decision logs, or long-running execution artifacts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3027,3030,3033,3036],{"name":3028,"slug":3029,"type":15},"Productivity","productivity",{"name":3031,"slug":3032,"type":15},"Project Management","project-management",{"name":3034,"slug":3035,"type":15},"Strategy","strategy",{"name":3037,"slug":3038,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":3041,"name":3041,"fn":3042,"description":3043,"org":3044,"tags":3045,"stars":2968,"repoUrl":2969,"updatedAt":3051},"figma","translate Figma designs into code","Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3046,3047,3049,3050],{"name":2821,"slug":2822,"type":15},{"name":3048,"slug":3041,"type":15},"Figma",{"name":2877,"slug":2878,"type":15},{"name":2984,"slug":2985,"type":15},"2026-04-12T05:06:47.939943",{"slug":3053,"name":3053,"fn":3054,"description":3055,"org":3056,"tags":3057,"stars":2968,"repoUrl":2969,"updatedAt":3065},"figma-code-connect-components","connect Figma designs to code components","Connects Figma design components to code components using Code Connect mapping tools. Use when user says \"code connect\", \"connect this component to code\", \"map this component\", \"link component to code\", \"create code connect mapping\", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3058,3059,3062,3063,3064],{"name":2821,"slug":2822,"type":15},{"name":3060,"slug":3061,"type":15},"Design System","design-system",{"name":3048,"slug":3041,"type":15},{"name":2877,"slug":2878,"type":15},{"name":2886,"slug":2887,"type":15},"2026-05-10T05:59:52.971881",{"slug":3067,"name":3067,"fn":3068,"description":3069,"org":3070,"tags":3071,"stars":2968,"repoUrl":2969,"updatedAt":3079},"figma-create-design-system-rules","generate design system rules from Figma","Generates custom design system rules for the user's codebase. Use when user says \"create design system rules\", \"generate rules for my project\", \"set up design rules\", \"customize design system guidelines\", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3072,3073,3074,3077,3078],{"name":2821,"slug":2822,"type":15},{"name":3060,"slug":3061,"type":15},{"name":3075,"slug":3076,"type":15},"Documentation","documentation",{"name":3048,"slug":3041,"type":15},{"name":2877,"slug":2878,"type":15},"2026-05-16T06:07:47.821474",{"slug":3081,"name":3081,"fn":3082,"description":3083,"org":3084,"tags":3085,"stars":2968,"repoUrl":2969,"updatedAt":3091},"figma-implement-design","translate Figma designs into application code","Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions \"implement design\", \"generate code\", \"implement component\", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3086,3087,3088,3089,3090],{"name":2821,"slug":2822,"type":15},{"name":3048,"slug":3041,"type":15},{"name":2877,"slug":2878,"type":15},{"name":2886,"slug":2887,"type":15},{"name":2966,"slug":2967,"type":15},"2026-05-16T06:07:40.583615",{"slug":3093,"name":3093,"fn":3094,"description":3095,"org":3096,"tags":3097,"stars":2968,"repoUrl":2969,"updatedAt":3106},"hatch-pet","create animated pets for Codex","Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3098,3101,3102,3105],{"name":3099,"slug":3100,"type":15},"Animation","animation",{"name":3001,"slug":3002,"type":15},{"name":3103,"slug":3104,"type":15},"Creative","creative",{"name":2821,"slug":2822,"type":15},"2026-05-02T05:31:48.48485",{"slug":3108,"name":3108,"fn":3109,"description":3110,"org":3111,"tags":3112,"stars":2968,"repoUrl":2969,"updatedAt":3122},"imagegen","generate and edit raster images","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3113,3114,3115,3118,3121],{"name":3103,"slug":3104,"type":15},{"name":2821,"slug":2822,"type":15},{"name":3116,"slug":3117,"type":15},"Image Generation","image-generation",{"name":3119,"slug":3120,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675]