작업 단추 사용자 정의

Cisco Desk Phone 9800 시리즈의 작업 단추에 대한 사용자 지정 옵션을 사용하려면 특정 PhoneOS 펌웨어 지원이 필요합니다. 자세한 내용은 다음 표를 참조하십시오.

기능필수 펌웨어 버전
긴급 통화PhoneOS 3.0.1 이상
맞춤형 서비스PhoneOS 3.2.1 이상
여러 트리거PhoneOS 3.3.1 이상
HTTP 포스트PhoneOS 3.3.1 이상
단일 트리거의 여러 이벤트PhoneOS 3.4.1 이상
1

Cisco Unified Communications Manager 관리에 로그인합니다.

2

필요에 따라 다음 작업 중 하나를 수행합니다.

  • 배포된 모든 전화기를 구성하려면 [시스템 > 엔터프라이즈 전화기 구성] 으로이동합니다.
  • 동일한 전화기 프로파일을 공유하는 전화기를 구성하려면 장치 >장치 설정 > 일반 전화기 프로파일 이동합니다.
  • 개별 전화기를 구성하려면 장치 > 전화기 이동합니다. 그런 다음 전화기를 찾아 전화기 구성 페이지를 엽니다.

구성은 계층 구조를 따릅니다.

  • 개별 장치 설정은 일반 전화기 프로파일 및 엔터프라이즈 수준의 설정보다 우선합니다
  • 일반 전화기 프로파일 설정이 엔터프라이즈 수준 설정을 무시합니다

3

사용 사례에 따라 다음 파라미터로 Action(작업) 버튼 설정을 사용자 지정합니다.

동작 단추에는 각각 고유한 트리거가 있는 서비스에 해당하는 세 그룹의 매개 변수가 있습니다. 서비스 트리거가 여러 그룹에 지정된 경우 그룹 1의 설정이 그룹 2 및 3의 설정보다 우선하고 그룹 2가 그룹 3보다 우선합니다.

  • 비상 통화

    다음 매개 변수를 구성합니다.

    • 동작 버튼 기능: 긴급 통화를 선택합니다.

    • 작업 단추 서비스 대상: 긴급 서비스의 전화 번호 또는 URI 입력합니다.

    • 작업 단추 서비스 이름 (선택 사항): 작업 트리거와 연결된 서비스의 이름을 지정합니다. 이 이름은 사용자가 단추를 누를 때 화면 메시지에 표시되어 어떤 이벤트가 시작되는지 알려줍니다. 이름이 지정되지 않은 경우 비상 통화 가 표시 이름으로 사용됩니다.

    • 전화 걸기 지연: 트리거가 감지된 후 전화기가 비상 통화를 시작하는 시간 초과 기간(초)을 설정합니다. 기본값은 5초입니다. 0으로 설정하면 트리거를 감지하는 즉시 통화가 걸립니다.

    • 서비스 트리거 목록에서 트리거 선택: 한 번 누르기, 길게 누르기 또는 3번 누르기.

    • 무성 비상 통화 (선택 사항): 기본적으로 비상 통화는 다른 발신 통화와 마찬가지로 양방향 통화로 작동합니다. 무성 비상 통화를 사용하는 경우 발신자 측에서 소리가 들리지 않아 통화 중에 주의가 끌리지 않도록 합니다. 통화 수신자만 무성 비상 통화를 종료할 수 있습니다.

      무음 비상 통화 중에는 전화기 9841의 화면은 정지되고 전화기 9851, 9861 및 9871의 화면은 꺼집니다. 다른 모든 기능에는 액세스할 수 없습니다. 수신자가 통화를 종료하면 전화기가 정상 작동을 복원합니다.

    • 무성 비상 통화 검색 허용(선택 사항): 비상 통화를 유지한 상태에서 사용자가 아무 키나 눌러 전화기 정상 작동을 복원할 수 있도록 허용하면 이 기능을 활성화합니다. 사용자가 볼륨 키를 사용하여 스피커 볼륨을 높이지 않는 한 통화 오디오는 들리지 않습니다.

  • 맞춤형 서비스

    다음 매개 변수를 구성합니다.

    • 동작 버튼 기능: 사용자 지정 을 선택합니다.

    • 작업 단추 서비스 대상: 사용자 지정 서비스의 URL을 입력합니다. URL은 http:// 또는 https:// (예: https://10.11.20.159/path/service.xml )로시작해야 합니다.

    • 작업 단추 서비스 이름 (선택 사항): 트리거와 연결된 서비스의 이름을 지정합니다. 이 이름은 사용자가 단추를 누를 때 화면 메시지에 표시되어 트리거되는 서비스를 나타냅니다. 이름이 지정되지 않은 경우 사용자 지정 서비스가 표시 이름으로 사용됩니다.

    • 사용자 정의 콘텐츠 필드 (선택 사항): [동작] 단추를 누를 때 전화기에서 HTTP Post 요청을 전송하도록 하려면 메서드, 헤더 및 게시 콘텐츠와 같은 HTTP 데이터를 최대 1024자로 입력합니다.

      POST 스크립트 예제 및 구문은 작업 단추 에 대한 HTTP POST 요청을 참조하세요.

    • 전화 걸기 지연: 트리거를 감지한 후 전화기에서 이벤트를 시작하는 시간 초과 기간(초)을 설정합니다. 기본값은 5초입니다. 0으로 설정하면 트리거 검색 즉시 이벤트가 시작됩니다.

    • 서비스 트리거 목록에서 트리거 선택: 한 번 누르기, 길게 누르기 또는 3번 누르기.

    • 서비스 암호 (선택 사항): 사용자 지정 서비스에서 액세스하기 위해 인증이 필요한 경우 인증 암호, 토큰 또는 암호를 입력합니다. 입력한 비밀은 마스킹된 문자열로 표시되며 사용자 정의 콘텐츠 필드 및 작업 단추 서비스 대상에서 매크로 $SS 를 사용하여 참조할 수 있습니다 .

  • 여러 트리거

    각 그룹의 매개 변수를 각각 설정합니다. 위의 긴급 통화 및 사용자 지정 서비스 섹션을 참조하세요.

  • 여러 이벤트에 대한 단일 트리거

    다음 매개 변수를 구성하여 트리거에 여러 이벤트를 할당합니다.

    • 동작 버튼 기능: 사용자 지정 을 선택합니다.

    • 작업 단추 서비스 대상: 통화할 전화 번호와 XML 서비스 URL을 다음 형식으로 입력합니다.

      tel:<phonenumber 또는 SIP URI> + <serviceURL>

      URL은 http:// 또는 https:// 시작해야 합니다.

      예: tel:1234 + https://10.11.20.159/path/service.xml

    • 작업 단추 서비스 이름 (선택 사항): 트리거와 연결된 서비스의 이름을 지정합니다. 이 이름은 사용자가 단추를 누를 때 화면 메시지에 표시되어 트리거되는 서비스를 나타냅니다. 이름이 지정되지 않은 경우 사용자 지정 서비스가 표시 이름으로 사용됩니다.

    • 사용자 정의 콘텐츠 필드 (선택 사항): [동작] 단추를 누를 때 전화기에서 HTTP Post 요청을 전송하도록 하려면 메서드, 헤더 및 게시 콘텐츠와 같은 HTTP 데이터를 최대 1024자로 입력합니다.

      POST 스크립트 예제 및 구문은 작업 단추에 대한 HTTP POST 요청을 참조하세요 .

    • 전화 걸기 지연: 트리거를 감지한 후 전화기에서 이벤트를 시작하는 시간 초과 기간(초)을 설정합니다. 기본값은 5초입니다. 0으로 설정하면 트리거 검색 즉시 이벤트가 시작됩니다.

    • 서비스 트리거 목록에서 트리거 선택: 한 번 누르기, 길게 누르기 또는 3번 누르기.

    • 서비스 암호 (선택 사항): 사용자 지정 서비스에서 액세스하기 위해 인증이 필요한 경우 인증 암호, 토큰 또는 암호를 입력합니다. 입력한 비밀은 마스킹된 문자열로 표시되며 사용자 정의 콘텐츠 필드 및 작업 단추 서비스 대상에서 매크로 $SS 를 사용하여 참조할 수 있습니다 .

    • 무성 비상 통화 (선택 사항): 서비스 대상에 전화 번호 또는 전화 걸기 URI를 포함한 경우 이 기능을 활성화하면 비상 전화가 무음이 됩니다.

      기본적으로 비상 통화는 다른 발신 통화와 마찬가지로 양방향 통화로 작동합니다. 활성화로 설정하면 발신자 쪽에서 소리가 들리지 않으므로 통화 중에 주의가 끌리지 않습니다. 통화 수신자만 통화를 종료할 수 있습니다.

      무음 비상 통화 중에는 전화기 9841의 화면은 정지되고 전화기 9851, 9861 및 9871의 화면은 꺼집니다. 다른 모든 기능에는 액세스할 수 없습니다. 수신자가 통화를 종료하면 전화기가 정상 작동을 복원합니다.

    • 무성 비상 통화 검색 허용(선택 사항): 비상 통화를 유지한 상태에서 사용자가 아무 키나 눌러 전화기 정상 작동을 복원할 수 있도록 허용하면 이 기능을 활성화합니다. 사용자가 볼륨 키를 사용하여 스피커 볼륨을 높이지 않는 한 통화 오디오는 들리지 않습니다.

이러한 매개 변수에 대한 자세한 내용은 동작 단추 에 대한 매개 변수를 참조하십시오.

4

저장을 선택합니다.

5

구성 적용을 선택합니다.

참조

동작 단추에 대한 매개 변수

매개 변수는 엔터프라이즈 전화기 구성, 일반 전화기 프로파일 및 개별 전화기 구성에서 사용할 수 있습니다.

표 1. 동작 단추에 대한 매개 변수
매개변수기본값 및 옵션설명
동작 버튼 기능 1~3

기본값: 끄기

옵션: 끄기, 긴급 통화, 사용자 정의

특정 서비스로 단추를 구성할 수 있습니다.

  • 끄기: 끄기로 설정하면 전화기에서 단일 서비스에 대한 동작 단추가 작동하지 않습니다.
  • 긴급 통화: 사용자는 작업 단추를 사용하여 긴급 통화를 걸 수 있습니다(구성된 경우).
  • 사용자 지정: 사용자는 작업 단추를 사용하여 사용자 지정 서비스(구성된 경우)에 액세스할 수 있습니다.

필드를 긴급 통화 또는 사용자 지정 으로설정할 경우 작업 단추 서비스 대상 필드에 서비스 대상을 입력해야 합니다. 또는 전화기에 구성 오류가 표시됩니다.

동작 단추 서비스 이름: 1~3

기본값: 비어 있음

선택적으로 동작 단추와 연결된 서비스의 이름을 지정합니다. 이 이름은 사용자가 단추를 누를 때 화면 메시지에 표시되어 트리거되는 서비스를 나타냅니다.

이름을 지정하지 않을 경우 기본 이름은 동작 단추 기능 필드의 선택 에 따라 긴급 통화, 무성 긴급 통화 또는 사용자 지정 작업이 됩니다.

동작 단추 서비스 대상 1~3

기본값: 비어 있음

[동작] 단추에 할당된 서비스에 따라 다음 형식 중 하나로 서비스 대상을 제공합니다.

  • 긴급 통화 서비스의 경우 전화 번호 또는 응급 서비스 URI를 입력합니다.

  • 사용자 지정 서비스에 대한 단추를 구성할 때 서비스 URL을 입력합니다. URL은 http:// 또는 https:// 시작해야 합니다. 예: https://10.11.20.159/path/service.xml.

  • 단일 트리거로 여러 이벤트를 시작하도록 단추를 구성하려면 tel:<phonenumber 또는 SIP URL> + <Service RUL> 을 입력합니다. : tel:1234 + https://10.11.20.159/path/service.xml.

    발신 SIP URI도 지원됩니다. URI를 tel: sip 4567@co.webex.com 형식으로 입력합니다.

유효한 서비스 대상을 설정하지 않고 동작 단추를 활성화하면 전화기 사용자에게 구성을 묻는 메시지가 표시됩니다. 사용자가 이 알림을 닫으면 단추가 제대로 구성되거나 비활성화될 때까지 경고 아이콘이 전화기 화면의 헤더에 계속 표시됩니다.

전화 번호는 사용자 지정 서비스의 대상으로 사용할 수 없습니다. [동작 단추]를 [사용자 정의 ]로 구성하고 전화 번호를 서비스 대상으로 입력하면 단추가 구성되지 않았음을 나타내는 경고 메시지가 전화기에 표시됩니다. 대신 tel:<phone number> 형식(예: tel:1234)으로 전화 번호를 추가할 수 있습니다.

앰퍼샌드(&)를 포함하는 URL을 입력할 수 없는 경우 대신 %26을 사용하십시오. 예를 들어 http://1.2.3.4/phone?a=1&b=2&c=3 대신 http://1.2.3.4/phone?a=1%26b=2%26c=3 를 입력합니다.

사용자 정의 콘텐츠 필드 1~3

기본값: 비어 있음

이 설정은 동작 단추 기능이 사용자 정의설정된 경우에만작동합니다.

메서드, 헤더, 게시물 내용과 같은 HTTP 데이터를 최대 1024자로 입력합니다. 구성된 경우 [동작]을 누르면 전화기에서 HTTP Post 요청을 전송합니다.

서비스에 액세스하기 위해 인증이 필요한 경우 서비스 암호 필드에 인증 암호를 입력해야 합니다. HTTP 데이터에서 매크로 $SS 서비스 암호에 대한 참조로 사용합니다.

예제 및 구문은 작업 단추 에 대한 HTTP Post 요청을 참조하세요.

서비스 시크릿 1~3

기본값: 비어 있음

서비스 암호는 인증 암호, 토큰 또는 암호일 수 있습니다. 입력한 비밀은 마스킹된 문자열로 표시되며 사용자 정의 콘텐츠 필드 및 작업 단추 서비스 대상에서 매크로 $SS 를 사용하여 참조할 수 있습니다 .

서비스 트리거 1~3

기본값: 한 번 누르기

옵션: 한 번 누르기, 길게 누르기, 3번 누르기

전화기의 동작 단추를 사용하여 사용자가 비상 전화를 걸거나 사용자 정의 서비스를 시작할 수 있는 방법을 선택합니다.

한 번 누르기: 동작 단추를 눌러 관련 통화 또는 서비스를 트리거합니다.

길게 누르기: 동작 버튼을 2초 이상 눌러 관련 통화 또는 서비스를 트리거합니다.

3번 누르기: 동작 버튼을 누를 때마다 2초 미만의 간격으로 세 번 누르면 관련 통화 또는 서비스가 트리거됩니다.

우선 순위가 낮은 매개 변수는 작동하지 않으므로 여러 서비스에서 트리거를 반복하지 마세요. 우선 순위는 그룹 1, 그룹 2, 그룹 3입니다.

전화 걸기 지연 1~3

기본값: 5

옵션: 0 - 30

[동작] 단추를 누른 후 전화기가 비상 통화 또는 사용자 정의 작업을 시작하는 시간 초과 기간(초)을 설정합니다.

전화기에서 트리거를 감지하는 즉시 전화를 걸거나 이벤트를 시작하도록 하려면 단추를 한 번 누르기, 길게 누르기 또는 세 번 눌러 지정합니다.

무성 긴급 전화 1~3

기본값: 비활성화됨

옵션: 사용, 사용 안 함

무성 긴급 통화는 위험한 상황에서 신중한 지원을 위해 설계되었습니다. 이를 통해 사용자는 소음 없이 도움을 요청할 수 있습니다.

  • 사용하도록 설정하면 사용자가 작업 단추로 단방향 전화를 걸 수 있습니다.

    무음 비상 통화가 걸려온 후에는 상대방만 통화를 종료할 수 있습니다. 진행 중인 통화 중에 주의를 끌지 않도록 하기 위해 전화기 9841의 화면은 정지되고 전화기 9851, 9861 및 9871의 화면은 꺼집니다. 무음 비상 통화 중에는 기본적으로 전화기의 모든 기능이 잠깁니다. 사용자가 무성 비상 통화를 유지하면서 전화기를 정상 작동하게 하려면 무성 비상 통화 검색 허용 기능을 활성화합니다 .

  • 비활성화된 경우 비상 통화는 다른 발신 통화와 마찬가지로 양방향 통화로 작동합니다.

무성 비상 통화 검색 허용

기본값: 아니요

옵션: 예, 아니요

무음 비상 통화 중에 사용자가 전화기 기능을 검색할 수 있는지 여부를 제어합니다. 기본적으로 무성 비상 통화가 시작되면 수신자가 통화를 종료할 때까지 전화기의 모든 기능이 잠깁니다.

이 매개 변수를 [예 ]로설정하면 사용자는 아무 키나 눌러 비상 통화를 유지하면서 전화기 정상 작동을 복원할 수 있습니다. 사용자가 볼륨 키를 사용하여 볼륨을 높이지 않으면 통화 오디오는 들리지 않습니다.

작업 단추에 대한 HTTP Post 요청

Cisco Desk Phone 9800 시리즈의 작업 단추는 HTTP Post 요청을 통해 XML 애플리케이션을 트리거하도록 구성할 수 있습니다.

사용자 지정 콘텐츠 필드에 사용자 지정된 요청 스크립트를 입력합니다. XML 또는 JSON 콘텐츠 형식을 지정하고 요청에 매크로를 포함할 수 있습니다. 예를 들어 $SS스크립트에 추가하여 서비스 암호 필드에 제공된 인증 암호, 토큰 또는 암호를 검색할 수 있습니다.

다음 예제는 XML 및 JSON입니다.

샘플 #1: XML --method POST --header 'Content-Type: application/xml' --header '권한 부여: 전달자 사용자 이름:$SS' --body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 샘플 #2: JSON --method POST --header 'Content-Type: application/json' --header '권한 부여: $SS' --body '{"events":[{"evtid":"12345", "parameters": {"trigger": true}, "Description":"이것은 HTTP POST JSON용입니다"}]}' 

Cisco Unified Communications Manager(UCM)에는 RFC 3986에 따라 예약된 문자에 대한 퍼센트 인코딩이 필요합니다.

표 2. 예약된 문자에 대한 퍼센트 인코딩
문자퍼센트 인코딩
&amp;%26
'%27
"%22
< %3c
> %3e

다음 스크립트는 퍼센트로 인코딩된 문자열을 사용하는 예제입니다.

--method POST --header %27Content-Type: application/xml%27 --body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eHTTP POST용입니다. XML%3c/Description%3e%3c/MetaData%3e%27
표 3. 지원되는 매크로
매크로 이름매크로 확장
#DEVICENAME#통화 시스템에 표시되는 장치 이름입니다. 예를 들면 SEP845A3EC21288
$SS서비스 비밀: 인증 비밀, 토큰 또는 암호와 같은 마스킹된 문자열이 전화기 구성 페이지에 표시됩니다.