https://github.com/twilio/twilio-taskrouter.js
JS SDK v2 for Twilio's TaskRouter skills based routing system.
https://github.com/twilio/twilio-taskrouter.js
javascript sdk taskrouter twilio twilio-api twilio-flex
Last synced: 6 months ago
JSON representation
JS SDK v2 for Twilio's TaskRouter skills based routing system.
- Host: GitHub
- URL: https://github.com/twilio/twilio-taskrouter.js
- Owner: twilio
- License: other
- Created: 2018-04-16T03:10:11.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2025-05-15T11:44:58.000Z (8 months ago)
- Last Synced: 2025-07-17T14:23:55.875Z (6 months ago)
- Topics: javascript, sdk, taskrouter, twilio, twilio-api, twilio-flex
- Language: JavaScript
- Homepage: https://www.twilio.com/docs/taskrouter
- Size: 5.27 MB
- Stars: 27
- Watchers: 19
- Forks: 37
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/twilio/twilio-taskrouter.js/actions/workflows/build.yml)
[](https://github.com/twilio/twilio-taskrouter.js/actions/workflows/release.yml)
[](https://badge.fury.io/js/twilio-taskrouter)
# twilio-taskrouter.js
[](https://badge.fury.io/js/twilio-taskrouter)
TaskRouter is Twilio's skills based routing system. With this library, you can manage your Workers in the browser or view the state of your Workspace.
This version of TaskRouter SDK can be used with Twilio Flex and TaskRouter standalone instances.
## Installation
### NPM
```
npm install twilio-taskrouter
```
## Usage
The following is a simple example showing a Worker waiting for Reservations.
For more information, refer to the
[API Docs](//twilio.github.io/twilio-taskrouter.js/index.html).
```js
const TaskRouter = require("twilio-taskrouter");
const Twilio = require("twilio");
const AccessToken = Twilio.jwt.AccessToken;
const TaskRouterGrant = AccessToken.TaskRouterGrant;
const accountSid = "";
const signingKeySid = "";
const signingKeySecret = "";
const workspaceSid = "";
const workerSid = "";
const token = createAccessToken(
accountSid,
signingKeySid,
signingKeySecret,
workspaceSid,
workerSid
);
const alice = new TaskRouter.Worker(token);
alice.on("ready", (readyAlice) => {
console.log(`Worker ${readyAlice.sid} is now ready for work`);
});
alice.on("reservationCreated", (reservation) => {
console.log(
`Reservation ${reservation.sid} has been created for ${alice.sid}`
);
console.log(`Task attributes are: ${reservation.task.attributes}`);
reservation.on("accepted", (acceptedReservation) => {
console.log(`Reservation ${acceptedReservation.sid} was accepted.`);
});
reservation
.accept()
.then((acceptedReservation) => {
console.log(`Reservation status is ${acceptedReservation.status}`);
})
.catch((err) => {
console.log(`Error: ${err}`);
});
});
function createAccessToken(
accountSid,
signingKeySid,
signingKeySecret,
workspaceSid,
workerSid
) {
const taskRouterGrant = new TaskRouterGrant({
workerSid: workerSid,
workspaceSid: workspaceSid,
role: "worker",
});
const accessToken = new AccessToken(
accountSid,
signingKeySid,
signingKeySecret
);
accessToken.addGrant(taskRouterGrant);
accessToken.identity = "alice";
return accessToken.toJwt();
}
```
## Changelog
See [CHANGELOG.md](https://github.com/twilio/twilio-taskrouter.js/blob/main/CHANGELOG.md).
## License
See [LICENSE.md](https://github.com/twilio/twilio-taskrouter.js/blob/main/LICENSE.md).
## Building
Fork and clone the repository. Use npm to install node 8 (other versions may run into problems).
Then, install dependencies with:
```
yarn install
```
Then run the `build` script:
```
yarn build
```
The builds and docs will be placed in the `dist/` directory.
Before commits, be sure to validate by running:
```
make lint
```
## Testing
- Create a twilio account
- copy ./test/integration_test_setup/.env.example to ./test/integration_test_setup/.env
- set ACCOUNT_SID, AUTH_TOKEN, SIGNING_KEY_SID, SIGNING_KEY_SECRET
- Run ./test/integration_test_setup/RunIntegrationTestLocal.sh this will create everything needed for running E2E tests and run the tests
## Test with Sample App
- See [README.md](sample-app/README.md)
## Contributing
Bug fixes welcome! If you're not familiar with the GitHub pull
request/contribution process, [this is a nice tutorial](https://gun.io/blog/how-to-github-fork-branch-and-pull-request/).