UsersApi.putUserRoutingstatus() "Bad Request"

[james]

The JS SDK documentation indicates how to call the UsersApi.putUserRoutingstatus(userId, body) function, but no detail on the "body" object payload.

The API documentation explains that valid values for "status" are COMMUNICATING, IDLE, INTERACTING, NOT_RESPONDING, OFF_QUEUE.

However, attempts to set routing status to anything but IDLE from anything but NOT_RESPONDING returns a Bad Request error, and the message varies between "Can only transition an agent's status to IDLE" and "Can only change status from NOT RESPONDING to IDLE".

a.) this seems like it could use some clearer explanation
b.) how can I programmatically set a user not to be "On Queue"?

[james]

b.) oic - probably using PresenceApi.

But I'm still confused about what is going on with putUserRoutingstatus()

[tim.smith]

Please see the dev center article Understanding Presence. There's a section about routing status at the bottom.

[james]

Thanks very much, Tim; that clears things up. It seems to me it would be excellent information to include with the API doc I linked in my first post.