Have ideas to improve npm?Join in the discussion! »

    twilio-taskrouter
    TypeScript icon, indicating that this package has built-in type declarations

    0.5.4 • Public • Published

    Build Status npm version

    twilio-taskrouter.js

    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.

    NOTE: This SDK is in a Developer Preview Release. This version of TaskRouter is intended for Twilio Flex. If you are using it outside of Twilio Flex, you may encounter bugs and instability, and the underlying APIs available in this release may change in subsequent releases.

    We want your feedback! Email Tyler Cole at tcole@twilio.com with suggested improvements, feature requests and general feedback. If you need technical support, contact help@twilio.com.

    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.

    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.

    License

    See LICENSE.md.

    Building

    Fork and clone the repository. 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
    

    Contributing

    Bug fixes welcome! If you're not familiar with the GitHub pull request/contribution process, this is a nice tutorial.

    Install

    npm i twilio-taskrouter

    DownloadsWeekly Downloads

    2,714

    Version

    0.5.4

    License

    MIT

    Unpacked Size

    4.73 MB

    Total Files

    58

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar