에이전트 - 전역

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • 에이전트 API는 에이전트 현재 상태 및 채널 가용성을 가져오거나 설정하는 메서드를 제공합니다.

    에이전트 API는 sn_awa 네임스페이스 내에서 제공됩니다.

    다음이 필요합니다.
    • 고급 작업 할당 플러그인(com.glide.awa)
    • 역할: awa_integration_user 또는 admin

    에이전트 - get(String user_sys_id)

    sys_id로 에이전트를 가져옵니다.

    표 1. 매개변수
    이름 유형 설명
    user_sys_id 문자열 테이블에 나열된 사용자의 sys_id sys_user.
    표 2. 반환
    유형 설명
    부울 사용자가 있으면 True, 그렇지 않으면 False입니다.
    var agent = sn_awa.Agent.get("<user_sys_id>");
    var presence  = agent.getPresence();

    에이전트 – getPresence()

    제공된 에이전트의 현재 현재 상태와 채널 가용성을 가져옵니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    객체 현재 상태 sys_id, 현재 상태 이름 및 채널 정보입니다. 그렇지 않으면 오류 메시지가 표시됩니다.
    var agent = sn_awa.Agent.get("<user_sys_id>");
            var presence  = agent.getPresence();

    에이전트 – setPresence(객체, setRequest)

    제공된 에이전트의 현재 상태를 설정하고 해당 상태에 대한 에이전트의 채널 가용성을 설정합니다.

    표 5. 매개변수
    이름 유형 설명
    setRequest 객체 setRequest.sys_id 및 setRequest.channels
    setRequest.sys_id 문자열 AWA 현재 상태 [awa_presence_state] 테이블의 presence_sys_id입니다.
    setRequest.channels 이름/값 쌍 옵션입니다.
    • sys_id: awa_service_channel 테이블에서 Channel_sys_id.
    • 사용 가능: 이 채널에 대한 작업을 받을 수 있는 에이전트 가용성입니다(true 또는 false).
    표 6. 반환
    유형 설명
    부울 성공하면 True, 그렇지 않으면 False입니다.
    var agent = sn_awa.Agent.get("<user_sys_id>");
    var presence = agent.setPresence({
        sys_id: <presence_sys_id>,
        channels: [{
            sys_id: "<channel_sys_id>",
            available: true // or false
        }]
    });