twilio-taskrouter-routing

Route tasks to agents using Twilio TaskRouter workspaces, queues, and workflows.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill twilio-taskrouter-routing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: twilio-taskrouter-routing
Source: https://github.com/openai/plugins/tree/main/plugins/twilio-developer-kit/skills/twilio-taskrouter-routing
Command: npx skills add https://github.com/openai/plugins --skill twilio-taskrouter-routing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires twilio.

What problem does it solve?

Building skills-based routing, queue management, and agent assignment logic from scratch is error-prone and unnecessary. This Skill guides you through Twilio TaskRouter so incoming tasks (calls, support tickets, AI escalations) are matched to the best available worker without custom queuing code.

Core Features & Use Cases

  • Workspace and Resource Setup: Create Workspaces, Activities, Workers, Task Queues, and Workflows via the Twilio SDK in Python or Node.js.
  • Skills-Based and Priority Routing: Match tasks to workers using expressions like skills HAS "billing", priority ordering, and timeout-based overflow between queues.
  • AI Agent Escalation: Create TaskRouter tasks from AI escalation webhooks so human agents receive conversation summaries and customer profiles.
  • Gotcha Prevention: Avoid silent failures such as hyphenated attribute names, HAS on non-array attributes, and reservation timeout cascades.
  • Use Case: A support center receives a billing call; a Workflow filter routes it to the billing Task Queue, which matches an available Spanish-speaking agent, and the assignment callback dequeues the call to that agent's phone.

Quick Start

Ask the assistant to set up a Twilio TaskRouter workspace with billing and technical queues, a routing workflow, and an assignment callback endpoint.

Frequently Asked Questions about twilio-taskrouter-routing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up skills-based routing with Twilio TaskRouter?

Create a Workspace, define Activities, create Workers with JSON skill attributes, build Task Queues with target_workers expressions like skills HAS "billing", then create a Workflow with routing filters. Incoming tasks are matched to queues and reserved to available workers.

How do I route an incoming Twilio call to an agent?

Create a TaskRouter task with the caller's attributes and a workflow_sid, then respond to the assignment callback with a dequeue or conference instruction. TaskRouter POSTs the reservation details to your assignment_callback_url when a worker matches.

Why is my TaskRouter task stuck in queue with no matching workers?

Common causes are using the HAS operator on a string attribute instead of an array, or hyphens in attribute names that break expression evaluation. Queue creation validates syntax only, not worker matching, so semantically wrong expressions create successfully but match nothing.

Can TaskRouter escalate from an AI voice agent to a human?

Yes. From your escalation webhook handler, create a TaskRouter task containing the AI's conversation summary, conversation ID, and customer profile as attributes. The matched human agent receives this context along with the reservation.

What are the limits of Twilio TaskRouter workspaces?

A Workspace supports up to 50,000 Workers and 250 Task Queues. Tasks auto-cancel after 1,000 reservation rejections, assignment callbacks must respond within 5 seconds, and multiTaskEnabled cannot be reverted once enabled.