이 문서에서
액션 버튼 사용자 지정
dropdown icon
참고 문헌
    액션 버튼의 매개변수들
    액션 버튼에 대한 HTTP 포스트 요청
9800용 액션 버튼 구성해 (Unified CM)
list-menu이 문서에서
list-menu피드백이 있습니까?

액션 버튼은 핸드폰 오른쪽 상단에 있는 빨간 버튼이에요.사용자들이 응급 서비스나 맞춤 서비스 같은 지정된 서비스를 빠르게 이용할 수 있게 해줘요.특정 사용 사례에 맞는 이벤트를 시작하도록 버튼을 사용자 지정할 수 있어요.이 페이지의 정보는 Cisco Unified Communications Manager (Unified CM) 에 등록된 시스코 데스크 폰 9800 시리즈에 적용돼요.

액션 버튼 사용자 지정

시스코 데스크 폰 9800 시리즈의 액션 버튼 사용자 지정 옵션에는 특정 PhoneOS 펌웨어 지원이 필요해요. 자세한 내용은 다음 표를 참조하세요.

특징필수 펌웨어 버전
긴급 전화아이폰OS 3.0.1 이상
맞춤 서비스예요아이폰OS 3.2.1 이상
멀티플 트리거폰오에스 3.3.1 이상
HTTP 포스트폰오에스 3.3.1 이상
단일 트리거에 여러 이벤트가 발생해요.폰오에스 3.4.1 이상
1

에 Cisco Unified Communications Manager Administration 로그인하세요.

2

필요에 따라 다음 작업 중 하나를 하세요.

  • 배포된 전화를 모두 구성하려면 시스템 > 기업 전화 구성으로 가세요.
  • 같은 전화 프로필을 공유하는 전화기를 구성하려면 장치 > 장치 설정 > 일반 전화 프로필로 이동하세요.
  • 개별 전화를 구성하려면 장치 > 전화로 가세요. 그런 다음 휴대폰을 찾아 전화 구성 페이지를 여세요.

구성이 계층 구조를 따른대요.

  • 개별 기기 설정이 일반 전화 프로필 및 기업 수준의 설정보다 우선해요
  • 일반 전화 프로필 설정이 기업 수준 설정보다 우선해요.

3

사용 사례에 따라 다음 매개변수로 액션 버튼 설정을 사용자 지정하세요.

액션 버튼에는 매개 변수 그룹이 세 개 있는데, 각 그룹은 고유한 트리거를 가진 서비스에 해당해요. 서비스 트리거가 여러 그룹에 지정되면 그룹 1의 설정이 그룹 2와 3의 설정보다 우선하고 그룹 2의 설정이 그룹 3보다 우선해요.

  • 긴급 전화

    다음 매개변수를 구성하세요.

    • 액션 버튼 기능: 긴급 통화 선택하세요.

    • 액션 버튼 서비스 목적지: 긴급 서비스 전화번호나 URI를 입력하세요.

    • 액션 버튼 서비스 이름 (선택 사항): 액션 트리거와 관련된 서비스 이름을 지정하세요. 사용자가 버튼을 누르면 화면 메시지에 이 이름이 표시되어 어떤 이벤트가 시작될지 알려줘요. 이름을 지정하지 않으면 긴급 전화가 표시 이름으로 사용돼요.

    • 다이얼 아웃 지연: 트리거가 감지된 후 전화가 긴급 통화를 시작하는 제한 기간 (초) 을 설정하세요. 기본값은 5초예요. 0으로 설정하면 트리거 감지 즉시 전화가 걸려요.

    • 서비스 트리거 목록에서 트리거를 선택하세요: 한 번 누르기, 길게 누르기, 3번 누르기.

    • 무음 긴급 통화 (선택 사항): 기본적으로 긴급 전화는 다른 발신 전화와 마찬가지로 양방향 통화로 작동해요. 긴급 통화 무음 활성화하면 진행 중인 통화 중에 주의를 끌지 않도록 발신자 쪽에서 오디오가 무음으로 재생돼요. 전화 받는 사람만 조용한 긴급 통화를 끊을 수 있어요.

      조용한 긴급 통화 중에는 9811, 9841 전화의 화면이 멈추고 전화 9851, 9861, 9871 화면은 꺼져요. 다른 기능들은 전부 액세스할 수 없어요. 받는 사람이 통화를 끝내면 전화가 정상 작동으로 복구돼요.

    • 무음 긴급 통화 검색 허용 (선택 사항): 긴급 통화를 유지하면서 사용자가 아무 키나 눌러 정상 전화 작동으로 복원할 수 있게 하면 이 기능을 활성화하세요. 사용자가 볼륨 키를 사용하여 스피커 볼륨을 높이지 않는 한 통화 오디오는 무음으로 유지돼요.

  • 맞춤 서비스

    다음 매개변수를 구성하세요.

    • 액션 버튼 기능: 사용자 지정을 선택하세요.

    • 액션 버튼 서비스 대상: 사용자 지정 서비스의 URL을 입력하세요. URL은 예를 들어 https://, http://또는 로 시작해야 해요 https://10.11.20.159/path/service.xml.

    • 액션 버튼 서비스 이름 (선택 사항): 트리거와 관련된 서비스 이름을 지정하세요. 사용자가 버튼을 누르면 화면 메시지에 이 이름이 표시되어 어떤 서비스가 트리거될지 알려줘요. 이름을 지정하지 않으면 사용자 지정 서비스가 표시 이름으로 사용돼요.

    • 사용자 지정 콘텐츠 필드 (선택 사항): 작업 버튼을 눌렀을 때 전화기에서 HTTP Post 요청을 보낼 수 있게 하려면 메서드, 헤더, 게시물 내용과 같은 HTTP 데이터를 최대 1024자까지 입력하세요.

      POST 스크립트 예제와 구문은 액션 버튼에 대한 HTTP Post 요청을 참조하세요.

    • 다이얼 아웃 딜레이: 트리거를 감지한 후 휴대폰이 이벤트를 시작하는 제한 시간을 초 단위로 설정해요. 기본값은 5초예요. 0으로 설정하면 트리거 감지 즉시 이벤트가 시작돼요.

    • 서비스 트리거 목록에서 트리거를 선택하세요: 한 번 누르기, 길게 누르기, 3번 누르기.

    • 서비스 암호 (선택 사항): 사용자 지정 서비스에 액세스하려면 인증이 필요한 경우 인증 암호, 토큰 또는 암호를 입력하세요. 입력한 비밀은 마스크 문자열로 표시되며 사용자 지정 콘텐츠 필드 및 액션 버튼 서비스 대상의 매크로를 $SS사용하여 참조할 수 있어요.

  • 멀티플 트리거

    각 그룹에서 매개변수를 각각 설정하세요. 위의 긴급 전화 및 맞춤 서비스 섹션을 참조하세요.

  • 여러 이벤트의 단일 트리거

    트리거에 여러 이벤트를 할당하려면 다음 매개변수를 구성하세요.

    • 액션 버튼 기능: 사용자 지정을 선택하세요.

    • 액션 버튼 서비스 목적지: 전화할 전화번호와 XML 서비스 URL을 다음 형식으로 입력하세요.

      tel:<phonenumber or 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를 포함한 경우, 이 기능을 사용하면 긴급 전화가 무음으로 전환돼요.

      기본적으로 긴급 전화는 다른 발신 전화와 비슷하게 양방향 통화로 작동해요. 활성화하면 통화 중에 주의를 끌지 않도록 발신자 쪽에서 오디오가 무음으로 들린대요. 전화 받는 사람만 통화 끊을 수 있어요.

      조용한 긴급 통화 중에는 9811, 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 or 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 포스트 요청을 참조하세요.

서비스 시크릿 1~3

기본값: 비어 있어요

서비스 비밀은 인증 비밀, 토큰, 비밀번호일 수 있어요. 입력한 비밀은 마스크 문자열로 표시되며 사용자 지정 콘텐츠 필드 및 액션 버튼 서비스 대상의 매크로를 $SS사용하여 참조할 수 있어요.

서비스 트리거 1~3

기본값: 싱글 프레스

옵션: 싱글 프레스, 롱 프레스, 3번 누르기

전화의 액션 버튼으로 사용자가 긴급 전화를 걸거나 사용자 지정 서비스를 시작할 수 있는 방법을 선택하세요.

한 번 누르기: 액션 버튼을 누르면 관련 전화나 서비스가 시작돼요.

길게 누르기: 액션 버튼을 2초 이상 누르면 관련 통화나 서비스가 시작돼요.

3번 누르세요: 각 누를 때마다 2초 미만의 간격으로 액션 버튼을 세 번 누르면 관련 통화나 서비스가 트리거돼요.

우선 순위가 낮은 파라미터는 작동하지 않으므로 여러 서비스에서 트리거를 반복하지 마세요. 높은 것부터 낮은 것까지 우선 순위는 다음과 같아요: 그룹 1, 그룹 2, 그룹 3이에요.

다이얼 아웃 딜레이 1~3

기본값: 5예요

옵션: 0 - 30

액션 버튼을 누른 후 전화기에서 긴급 통화나 사용자 지정 액션이 시작되는 제한 시간을 초 단위로 설정해요.

트리거를 감지하는 즉시 전화를 걸거나 이벤트를 시작하도록 하려면 0으로 설정하세요. 버튼을 한 번 누르거나 길게 누르거나 세 번 눌러 지정한 대로 말이죠.

사일런트 이머전시 콜 1~3

기본값: 비활성화됨

옵션: 활성화됨, 비활성화됨

무음 긴급 통화는 위험한 상황에서 눈에 띄지 않게 도움을 주기 위해 설계됐어요. 사용자들이 소리 없이 도움을 요청할 수 있게 해줘요.

  • 활성화되면 사용자들이 액션 버튼으로 단방향 전화를 걸 수 있어요.

    무음 긴급 전화 걸고 나면 상대방만 통화 끊을 수 있어요. 통화 중에 주의를 끌지 않기 위해 전화 9811, 9841에서는 화면이 멈추고 전화 9851, 9861, 9871은 화면이 꺼져요. 무음 긴급 통화 중에는 기본적으로 전화기가 모든 기능을 잠가줘요. 사용자가 무음 긴급 통화 상태를 유지하면서 전화 작동을 정상적으로 복원할 수 있게 하려면 무음 긴급 통화 검색 허용 기능을 활성화하세요.

  • 비활성화되면 긴급 전화는 다른 발신 전화와 비슷하게 양자 통화로 작동해요.

무음 긴급 통화 검색 허용해요

기본값: 아니요

옵션: 네, 아니요

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

이 매개 변수를 Yes로 설정하면 사용자는 긴급 통화를 유지하면서 아무 키나 눌러 정상 전화 작동을 복원할 수 있어요. 사용자가 Volume 키를 사용하여 볼륨을 높이지 않는 한 통화 음성은 무음으로 유지돼요.

액션 버튼에 대한 HTTP 포스트 요청

시스코 데스크 폰 9800 시리즈의 액션 버튼은 HTTP Post 요청을 통해 XML 애플리케이션을 트리거하도록 구성할 수 있어요.

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

다음 예시는 XML과 JSON으로 되어 있어요.

Sample #1: XML
--method POST
--header 'Content-Type: application/xml'
--header 'Authorization: Bearer username:$SS'
--body '<MetaData><Trigger>True</Trigger><Description>This is for HTTP POST XML</Description></MetaData>' 

Sample #2: JSON
--method POST
--header 'Content-Type: application/json'
--header 'Authorization: $SS'
--body '{"events":[{"evtid":"12345", "parameters": {"trigger":true}, "Description":"This is for HTTP POST JSON"}]}' 

Cisco Unified Communications Manager(UCM) 에는 RFC 3986에 따른 예약 문자 퍼센트 인코딩이 필요해요.

테이블 2예요.예약 문자 인코딩 퍼센트
캐릭터퍼센트 인코딩
&%26
'%27
"%22
< %3c
> %3e

다음 스크립트는 퍼센트 인코딩 문자열을 사용한 예시예요.

--method POST
--header %27Content-Type: application/xml%27
--body %27%3cMetaData%3e%3cTrigger%3eTrue%3c/Trigger%3e%3cDescription%3eThis is for HTTP POST XML%3c/Description%3e%3c/MetaData%3e%27
테이블 3이에요.지원되는 매크로
매크로 이름매크로 확장
#DEVICENAME#통화 시스템에 표시된 장치 이름. 예를 들어, SEP845A3EC21288
$SS전화 구성 페이지에 인증 비밀, 토큰, 비밀번호 같은 마스킹된 문자열을 나타내는 서비스 비밀이에요.
이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?