Vonage 스포크
전화, SMS 및 왓츠앱 인스턴스의 계정을 사용하여 커뮤니케이션을 Vonage 관리합니다 ServiceNow .
스토어에서 앱 요청
사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 ServiceNow Store 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.
통합 허브 구독
이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.
스포크 버전
Vonage spoke v2.0.0 이 최신 버전입니다.
지원되는 버전
이 스포크는 이러한 버전용 Vonage 으로 빌드되었지만 이후 버전과 호환될 수 있습니다.
- 메시지 API 버전 v1
- 음성 API 버전 v1
스포크 요구 사항
- 계정 및 Vonage API 대시보드에 대한 Vonage 관리자 액세스 권한입니다.
- API 키 및 API 시크릿의 값을 기록합니다. API 대시보드에서 Vonage 이러한 값에 액세스할 수 있습니다. 자세한 내용은 Vonage API 개발자 설명서 사이트의 인증 페이지를 참조하십시오.
- 서명 암호의 값을 기록하고 저장합니다. Vonage API 대시보드의 계정 설정에서 이 값에 액세스할 수 있습니다. 자세한 내용은 Vonage API 개발자 설명서 사이트의 인증 페이지를 참조하십시오.
스포크 종속성
앱을 설치하는 데 문제가 있는 경우 다음 종속 플러그인이 설치되어 있는지 확인합니다.
- ServiceNow 통합 허브 작업 단계 - REST(com.glide.hub.action_step.rest)
- ServiceNow 통합 허브 런타임(com.glide.hub.integration.runtime)
- 복합 객체(com.glide.cobject)
- ServiceNow 플로우 디자이너 - 동적 입력(com.glide.hub.dynamic_inputs)
주:
이러한 플러그인 중 일부는 라이센스 가능 기능이며, 스포크 구현 외부에서 사용되는 경우 적절한 라이센스가 필요합니다.
스포크 하위 플로우
Vonage 스포크는 작업 자동화를 보여주는 샘플 하위 플로우를 제공합니다.Vonage 샘플 하위 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 하위 플로우는 다음과 같습니다.
| 하위 플로우 | 설명 |
|---|---|
| Vonage SMS 웹후크 | 의 VonageSMS 요청을 처리합니다. |
| Vonage 음성 웹후크 | 의 Vonage음성 요청을 처리합니다. |
| Vonage 왓츠앱 웹후크 | 의 Vonage요청을 처리합니다왓츠앱. |
스포크 트리거
Vonage 스포크에서 트리거를 사용하여 필요한 이벤트를 구독합니다. 엔드포인트를 사용하면 웹후크가 ServiceNow 인스턴스와 연결할 수 있습니다. 지정된 트리거 조건이 충족될 때만 플로우가 실행되도록 구성할 수 있습니다. 지원되는 이벤트는 다음과 같습니다.
Vonage 스포크에 대한 트리거 설정에 대한 자세한 내용은 Vonage 스포크에 대한 트리거 설정 단원을 참조하십시오.
| 범주 | 트리거 | 설명 |
|---|---|---|
| 호출 관리 | 음성 벨소리 | 트리거는 Vonage에서 전화가 걸려오고 번호가 울리면 시작됩니다. |
| 음성 응답됨 | 트리거는 Vonage에서 전화가 걸려오고 전화에 응답하면 시작됩니다. | |
| 음성 완료됨 | 트리거는 Vonage에서 호출이 이루어지고 호출이 완료되면 시작됩니다. | |
| SMS 관리 | SMS 전달됨 | 트리거는 Vonage에서 번호로 SMS가 전송될 때 시작됩니다. |
| SMS 실패 | 트리거는 Vonage에서 SMS가 전송되어 실패할 때 시작됩니다. | |
| SMS 수락됨 | 트리거는 메시지가 전달을 위해 수락되었지만 아직 전달되지 않았을 때 시작됩니다. |
스포크 작업
Vonage 스포크는 인스턴스에서 ServiceNow 이벤트가 발생할 때 작업을 자동화 Vonage 하는 작업을 제공합니다. 사용 가능한 작업은 다음과 같습니다.
| 범주 | 동작 | 설명 |
|---|---|---|
| 계정 관리 | 계정 잔액 가져오기 | Vonage 계정의 현재 잔액을 조회합니다. |
| 호출 관리 | DTMF 톤을 호출로 재생 | DTMF(Dual–tone multi–frequency) 톤을 활성 콜로 플레이합니다. |
| 기록에 ServiceNow 기록 첨부 | 대상 ServiceNow 기록에 통화 기록을 첨부합니다. | |
| 아웃바운드 호출 작성 | 전화 번호에 대한 아웃 바운드 호출을 작성합니다. | |
| NCCO 작성 | 아웃바운드 호출 작성 작업에 사용되는 NCCO(Nexmo 호출 통제 객체)를 구성합니다. | |
| 연결 NCCO 생성 | 아웃바운드 호출을 전화 번호 또는 WebSocket과 같은 엔드포인트에 연결하는 방법을 정의하는 NCCO(Nexmo 호출 제어 객체)를 생성합니다. | |
| 알림 NCCO 생성 | 아웃바운드 호출에 대한 알림 작업을 정의하는 NCCO(Nexmo 호출 통제 객체)를 생성합니다. | |
| 이전 NCCO 작성 | 활성 통화를 전환하는 방법을 정의하는 NCCO(Nexmo 통화 통제 객체)를 생성합니다. | |
| 호출 상세 정보 조회 | 지정된 호출의 상세 정보를 조회합니다. | |
| 호출 조회 | 지정된 호출의 상세 정보를 조회합니다. | |
| 호출을 음성으로 재생 | 오디오 파일을 활성 호출로 재생합니다. | |
| 텍스트 음성 변환을 호출로 재생 | 텍스트 음성 변환을 활성 통화로 재생합니다. | |
| 전화에서 오디오 재생 중지 | 활성 호출로의 오디오 파일 재생을 중지합니다. | |
| 통화 시 텍스트 음성 변환 중단 | 텍스트 음성 변환을 활성 통화로 중지합니다. | |
| 호출 업데이트 | 활성 호출의 상태를 업데이트합니다. | |
| 번호 관리 | 번호 조회 | Vonage 계정과 연결된 모든 인바운드 번호를 조회합니다. |
| RCS 관리 주: 이전 버전의 스포크에서 업그레이드하는 경우 이 범주 작업을 사용하기 전에 기존 자격 증명 기록에 새 JWT 토큰을 생성해야 합니다. |
RCS 카드 메시지 보내기 | 지정된 전화 번호로 RCS(Rich Communication Services) 카드 메시지를 보냅니다. |
| RCS 미디어 메시지 보내기 | 지정된 전화 번호로 RCS(Rich Communication Services) 미디어 메시지를 보냅니다. | |
| RCS 텍스트 메시지 보내기 | 지정된 전화 번호로 RCS(Rich Communication Services) 문자 메시지를 보냅니다. | |
| SMS 관리 | SMS 보내기 | SMS(짧은 메시지 서비스)를 휴대폰 번호로 전송합니다. |
| 왓츠앱 관리 주: 이전 버전의 스포크에서 업그레이드하는 경우 이 범주 작업을 사용하기 전에 기존 자격 증명 기록에 새 JWT 토큰을 생성해야 합니다. |
연락처 보내기 | 연락처를 번호로 왓츠앱 보냅니다. |
| 위치 전송 | 위치의 지리적 좌표를 숫자로 왓츠앱 보냅니다. | |
| 미디어 메시지 보내기 | 번호로 왓츠앱 미디어 메시지를 보냅니다. | |
| 텍스트 메시지 보내기 | 숫자로 왓츠앱 텍스트 메시지를 보냅니다. | |
| 템플릿을 사용하여 텍스트 메시지 전송 | 템플릿을 사용하여 숫자로 왓츠앱 문자 메시지를 보냅니다. |
스포크 모듈
필요한 이벤트에 대한 알림을 받도록 양방향 웹후크를 설정할 수 있습니다. 라우팅 정책은 인스턴스에 알리기 위해 충족되어야 하는 조건을 정의합니다.ServiceNow 이러한 조건은 알림을 받으려는 이벤트를 Vonage 기반으로 합니다. 조건이 충족되면 라우팅 정책이 연결된 하위 플로우를 트리거하여 작업을 자동화합니다.Vonage 기본적으로 Vonage 스포크 애플리케이션을 사용할 수 있으며 다음 모듈이 있습니다.
- Vonage 웹후크 레지스트리
- Vonage WebHook 라우팅 정책
웹후크 레지스트리 모듈을 Vonage 사용하여 토큰을 할당하고 API 경로를 제공합니다. 여기에서 콜백 URL을 생성하고 이 URL을 제공해야 합니다 Vonage. 기본 라우팅 정책은 WebHook 라우팅 정책 모듈에서 Vonage 참조로 제공됩니다. 요구 사항에 따라 이러한 라우팅 정책을 사용자 지정합니다. 라우팅 정책은 다음 필드를 지원합니다.
- 키워드
- 호출 방향
- 호출 상태
- 이벤트 유형
- 시작 날짜
- SMS 상태
- SMS 텍스트
- ~
- 왓츠앱 메시지 상태
- 왓츠앱 텍스트
- 관련 필드 표시
연결 및 자격 증명 별칭 요구 사항
통합 허브 는 별칭을 사용하여 연결 및 자격 증명 정보를 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다. 자세한 내용은 Connections and Credentials 문서를 참조하십시오.
스포크와 함께 Vonage 두 개의 연결 및 자격 증명 별칭을 사용할 수 있습니다.
| Vonage 별칭 | 설명 |
|---|---|
| Vonage기본 | SMS, 번호 및 계정을 관리하는 작업에 필요합니다. |
| Vonage | 호출 왓츠앱을 관리하는 작업에 필요합니다. |
스포크 설정에 대한 자세한 내용은 다음 문서를 참조하십시오 Vonage 스포크 설정.