Skip to main content

Updating A Queue Member

This scenario covers updating a queue member/agent through the API. The user is already logged in and is monitoring the event stream.

On queue with local number 400, the queue member settings on the agent with local number 200 are updated, using a SetQueueMember request:

Request
<SetQueueMember>
  <device>400</device>
  <activateAgent>true</activateAgent>
  <activateMobile>true</activateMobile>
  <activateSip>true</activateSip>
  <activateSkype>true</activateSkype>
  <agentDN>200</agentDN>
  <agentPosition>1</agentPosition>
  <privateData>
    <requestID>116-d1f7590f-aa6a-4ff7-92c7-b6c3f59eccd1</requestID>
  </privateData>
</SetQueueMember>

The system responds with a SetQueueMemberResponse, indicating that the request has been registered:

Response
<SetQueueMemberResponse xmlns="http://www.ecma.ch/standards/ecma-323/csta/ed6">
  <privateData>
    <requestID>116-d1f7590f-aa6a-4ff7-92c7-b6c3f59eccd1</requestID>
  </privateData>
</SetQueueMemberResponse>

When the system has updated the setting, a QueueMemberEvent is fired. The customers system can monitor the events on the monitorCrossRefID 'q-12345678-400'

Event
<QueueMemberEvent xmlns="http://www.ecma.ch/standards/ecma-323/csta/ed6">
  <monitorCrossRefID>q-12345678-400</monitorCrossRefID>
  <memberList>
    <memberListItem>
      <active>true</active>
      <activeSip>true</activeSip>
      <activeMobile>true</activeMobile>
      <activeSkype>true</activeSkype>
      <agentDN>200</agentDN>
    </memberListItem>
  </memberList>
</QueueMemberEvent>