Jump to: navigation, search

Terminating a Hoteling Guest/Host Association

The BroadWorks Connector performs the following actions when it terminates a hoteling association:

  1. Sends a request to the BroadWorks XSP server to set the guest subscriber’s agent status to signed out;
  2. Sends a request to the BroadWorks XSP server to cancel unconditional call-forward on the host’s subscriber id;
  3. Sends a request to the BroadWorks XSP server to end the hoteling guest/host association.

The following diagram and table shows the sequence of requests and events that are passed between BroadWorks Connector and the BroadWorks XSP server:

Terminating the Hoteling Association Call Flow.

Requests and Events Passed Between BroadWorks Connector and BroadWorks XSP Server During Termination

CSTA BroadWorks CTI Comments

SetAgentState request:

  • device: host subscriber id
  • agent state: logged out
  • agent ID: guest subscriber id
  • group: n/a

SetAgentState request:

  • subscriberId: guest subscriber id
  • state: signed out

ModifyCallForwardingAlways request:

  • subscriberId: host subscriber id
  • address: guest subscriber address
  • active: false

ModifyHotelingGuest request

  • subscriberId: guest subscriber id
  • hotelingGuest: see notes
  • hotelingGuest.isActive: false
  • hotelingGuest.hostSubscriberId:
  • The ModifyHotelingGuest request is sent by BroadWorks Connector to the XSP server in response to receving a SetAgentState request from Connector’s client application.
  • The HotelingGuest information is provided in the Hoteling Guest event(s).

AgentState event:

  • device: guest subscriber id
  • agent ID: guest subscriber id
  • logged on state: false
  • acd group: n/a
  • agent state: logged out

HotelingGuest event

  • subscriberId: guest subscriber id
  • hotelingGuest: from event
  • hotelingGuest.isActive: false
  • hotelingGuest.hostSubscriberId:
  • BroadWorks Connector may also receive a HotelGuest event when an external application modifies the hoteling guest association of a monitored subscriber id.
  • BroadWorks Connector sends the AgentState event to the Connector client to indicate that the hoteling guest/host association has ended.

Note: The CSTA AgentState event uses the guest subscriber id as it has no information about the former host subscriber.

AgentState event:

  • device: subscriber id
  • agent ID: subscriber id
  • logged on state: true
  • acd group: n/a
  • agent state: logged in

AgentStateChanged event:

  • subscriberId: guest subscriber id
  • agentACDState: agent_state
  • BroadWorks Connector’s handling of AgentStateChanged events is independent of whether the request was sent as part of the terminating hoteling sequence, or in response to any subsequent CSTA SetAgentState requests.
  • BroadWorks Connector sends the AgentState event to the T-Server in response to receiving the AgentStateChanged event.

SetForwarding event

  • device: host subscriber id
  • type: immediate
  • activate: false
  • forwardDN: guest subscriber id

CallForwardingAlways event

  • subscriberId: host subscriber id
  • address: guest subscriber address
  • active: true
  • BroadWorks Connector’s handling of CallForwardingAlways events is independent of whether the request was sent as part of the initial hoteling sequence, or in response to any other CSTA SetForwarding request.
  • BroadWorks Connector sends the SetForwarding event to the Connector client in response to receiving the CallForwardingAlways event.
This page was last edited on July 23, 2013, at 15:53.
Comments or questions about this documentation? Contact us for support!