User/Queue Notification

Finesse sends a User/Queues notification when a queue is added or removed from the user's list of queues or if a queue assigned to that user is removed from the system.

Note

Finesse sends notifications for this node only for a stand-alone Finesse deployment with Unified CCE. Notifications for this node are not sent for a coresident Finesse deployment with Unified CCX.

Format:

XML

Node:

/finesse/api/User/{id}/Queues

Source:

/finesse/api/User/{id}/Queues

Data:

User/Queues object

Payload (POST):

Code Snippet
Copy<Update>
    <event>{post}</event>
    <source>/finesse/api/User/{id}/Queues</source>
    <requestId></requestId>
    <data>
       <Queues>
          <Queue>
             <uri>/finesse/api/Queue/{id}</uri>
             <name>Sales</name>
             <statistics>
                 <callsInQueue>3</callsInQueue>
                 <startTimeOfLongestCallInQueue>2012-02-15T17:58:21Z</startTimeOfLongestCallInQueue>
                 <agentsReady>1</agentsReady>
                 <agentsNotReady>2</agentsNotReady>
                 <agentsTalkingInbound>3</agentsTalkingInbound>
                 <agentsTalkingOutbound>4</agentsTalkingOutbound>
                 <agentsTalkingInternal>5</agentsTalkingInternal>
                 <agentsWrapUpNotReady>6</agentsWrapUpNotReady>
                 <agentsWrapUpReady>7</agentsWrapUpReady>
             </statistics>
           </Queue>
          ... more queues ...
      </Queues>
    </data>
</Update>

Payload (DELETE):

Code Snippet
Copy<Update>
    <event>{delete}</event>
    <source>/finesse/api/User/{id}/Queues</source>
    <requestId></requestId>
    <data>
       <Queues>
          <Queue>
             <uri>/finesse/api/Queue/{id}</uri>
          </Queue>
          <Queue>
             <uri>/finesse/api/Queue/{id}</uri>
          </Queue>
          <Queue>
             <uri>/finesse/api/Queue/{id}</uri>
          </Queue>
          ... more queues ...
      </Queues>
    </data>
</Update>

Sample Notification Payload (POST):

Code Snippet
CopyUpdate>
    <event>post</event>
    <source>/finesse/api/User/1001001/Queues</source>
    <requestId></requestId>
    <data>
       <Queues>
          <Queue>
             <uri>/finesse/api/Queue/1215</uri>
             <name>Sales</name>
             <statistics>
                 <callsInQueue>3</callsInQueue>
                 <startTimeOfLongestCallInQueue>2012-02-15T17:58:21Z</startTimeOfLongestCallInQueue>
                 <agentsReady>1</agentsReady>
                 <agentsNotReady>2</agentsNotReady>
                 <agentsTalkingInbound>3</agentsTalkingInbound>
                 <agentsTalkingOutbound>4</agentsTalkingOutbound>
                 <agentsTalkingInternal>5</agentsTalkingInternal>
                 <agentsWrapUpNotReady>6</agentsWrapUpNotReady>
                 <agentsWrapUpReady>7</agentsWrapUpReady>
             </statistics>
           </Queue>
          ... more queues ...
      </Queues>
    </data>
</Update>

Sample Notification Payload (DELETE):

Code Snippet
Copy<Update>
    <event>delete</event>
    <source>/finesse/api/User/1001001/Queues</source>
    <requestId></requestId>
    <data>
       <Queues>
          <Queue>
             <uri>/finesse/api/Queue/1326</uri>
          </Queue>
          <Queue>
             <uri>/finesse/api/Queue/1364</uri>
          </Queue>
          <Queue>
             <uri>/finesse/api/Queue/1389</uri>
          </Queue>
          ... more queues ...
      </Queues>
    </data>
</Update>

Notification Triggers:

  • A queue is added or removed from the user's list of queues.

  • A queue assigned to the user is removed from the system.