--- sourceDocument: Xanadu 애플리케이션과의 통합 생성 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications Release : - xanadu ft:locale : - ko-KR ft:publication_title : - Xanadu 애플리케이션과의 통합 생성 ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Vonage 스포크 # Vonage 스포크 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분 통화, SMS를 통해 그리고 왓츠앱 인스턴스의 ServiceNow 계정을 사용하여 통신을 Vonage 관리합니다. ## 스토어에서 앱 요청 {#vonage-spoke__section_sz5_jv3_z3b} [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 [ServiceNow Store 버전 기록 릴리스 정보](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html)를 참조하십시오.{#vonage-spoke__inline-send-to-store} ## Integration Hub 구독 {#vonage-spoke__section_rsf_yvb_l3b} 이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 [법무 일정 - 통합 허브 개요](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf)를 참조하십시오. ## 스포크 버전 {#vonage-spoke__section_mxx_ndy_bsb} Vonage spoke v1.1.3 이 최신 버전입니다.{#vonage-spoke__vonagespk-vr} ## 지원되는 버전 {#vonage-spoke__section_sv2_1n2_pmb} 이 스포크는 다음 버전용으로 Vonage 빌드되었지만 이후 버전과 호환될 수 있습니다. * 메시지 API 버전 v0.1 * 음성 API 버전 v1 {#vonage-spoke__ul_usd_grf_pmb} ## 스포크 요구 사항 {#vonage-spoke__section_vv2_1n2_pmb} * 계정 및 [Vonage API 대시보드](https://dashboard.nexmo.com/)에 대한 Vonage 관리자 액세스 권한입니다. * API 키 및 API 시크릿의 값을 기록합니다. API 대시보드에서 이러한 값에 Vonage 액세스할 수 있습니다. 자세한 내용은 [Vonage API 개발자](https://developer.nexmo.com/documentation) 설명서 사이트의 [인증](https://developer.nexmo.com/concepts/guides/authentication) 페이지를 참조하십시오.{#vonage-spoke__vonage-api-key} * 서명 암호의 값을 기록하고 저장합니다. [Vonage API 대시보드의 계정 설정](https://dashboard.nexmo.com/settings)에서 이 값에 액세스할 수 있습니다. 자세한 내용은 [Vonage API 개발자](https://developer.nexmo.com/documentation) 설명서 사이트의 [인증](https://developer.nexmo.com/concepts/guides/authentication) 페이지를 참조하십시오. {#vonage-spoke__ul_wv2_1n2_pmb} ## 스포크 종속성 {#vonage-spoke__section_xv2_1n2_pmb} 앱을 설치하는 데 문제가 있는 경우 다음 종속 플러그인이 설치되어 있는지 확인합니다. * ServiceNow 통합 허브 작업 단계 - REST(com.glide.hub.action_step.rest) * ServiceNow 통합 허브 런타임(com.glide.hub.integration.runtime) * Complex Object (com.glide.cobject) * ServiceNow 플로우 디자이너 - 동적 입력(com.glide.hub.dynamic_inputs) {#vonage-spoke__ul_yv2_1n2_pmb} 주: 이러한 플러그인 중 일부는 라이센스 가능 기능이며, 스포크 구현 외부에서 사용되는 경우 적절한 라이센스가 필요합니다. ## 스포크 하위 플로우 {#vonage-spoke__section_uxx_tgf_kfb} Vonage 스포크는 작업 자동화를 보여주는 샘플 하위 플로우를 Vonage 제공합니다. 샘플 하위 플로우를 사용자 지정하려면 새 애플리케이션 범위에 복사합니다. 사용 가능한 샘플 하위 플로우는 다음과 같습니다. {#vonage-spoke__table_hbd_qty_qfb__entry__2} | 하위 플로우 | 설명 | |-|-| | Vonage SMS 웹후크 | 에서 VonageSMS 요청을 처리합니다. | | Vonage 음성 웹후크 | 의 Vonage음성 요청을 처리합니다. | | Vonage 왓츠앱 웹후크 | 의 Vonage요청을 처리합니다왓츠앱. | [ ] {#vonage-spoke__table_hbd_qty_qfb}기본 하위 플로우를 사용자 지정하려면 샘플 하위 플로우의 복사본을 만들고 요구 사항에 따라 하위 플로우를 사용자 지정해야 합니다. 하위 플로우를 사용자 지정하는 동안 무한 루프를 방지하도록 하위 플로우가 구성되어 있는지 확인해야 합니다. ## 스포크 작업 {#vonage-spoke__section_b43_3h2_hfb} Vonage 스포크는 인스턴스에서 이벤트가 발생할 때 작업을 자동화 Vonage 하는 ServiceNow 작업을 제공합니다. 사용 가능한 작업은 다음과 같습니다. {#vonage-spoke__table_u1p_kh2_hfb__entry__3}{#vonage-spoke__vonage}{#vonage-spoke__whatsapp} | 범주 | 작업 | 설명 | |-|-|-| | 계정 관리 | 계정 잔액 가져오기 | Vonage 계정의 현재 잔액을 조회합니다. | | 호출 관리 | DTMF 톤을 호출로 재생 | DTMF(Dual--tone multi--frequency) 톤을 활성 콜로 플레이합니다. | | 호출 관리 | 기록에 기록 ServiceNow 첨부 | 대상 ServiceNow 기록에 통화 기록을 첨부합니다. | | 호출 관리 | 아웃바운드 호출 작성 | 전화 번호에 대한 아웃 바운드 호출을 작성합니다. | | 호출 관리 | NCCO 작성 | 아웃바운드 호출 작성 작업에 사용 되는 NCCO(Nexmo 호출 통제 객체)를 작성합니다. | | 호출 관리 | 호출 세부 정보 가져오기 | 지정된 호출의 상세 정보를 조회합니다. | | 호출 관리 | 호출 조회 | 지정된 호출의 상세 정보를 조회합니다. | | 호출 관리 | 호출을 음성으로 재생 | 오디오 파일을 활성 호출로 재생합니다. | | 호출 관리 | 텍스트 음성 변환을 호출로 재생합니다 | 텍스트 음성 변환을 활성 통화로 재생합니다. | | 호출 관리 | 전화에서 오디오 재생 중지 | 활성 호출로의 오디오 파일 재생을 중지합니다. | | 호출 관리 | 통화 시 텍스트 음성 변환 중단 | 텍스트 음성 변환을 활성 통화로 중지합니다. | | 호출 관리 | 호출 업데이트 | 활성 호출의 상태를 업데이트합니다. | | 번호 관리 | 자신의 번호 조회 | Vonage 계정과 관련된 인바운드 수를 모두 가져옵니다. | | SMS 관리 | SMS 보내기 | SMS(짧은 메시지 서비스)를 휴대폰 번호로 전송합니다. | | 왓츠앱 경영 | 연락처 보내기 | 연락처를 왓츠앱 여러 번호로 보냅니다. | | 왓츠앱 경영 | 위치 전송 | 위치의 지리적 좌표를 숫자로 왓츠앱 보냅니다. | | 왓츠앱 경영 | 미디어 메시지 보내기 | 여러 번호로 왓츠앱 문자 메시지를 보냅니다. | | 왓츠앱 경영 | 텍스트 메시지 보내기 | 여러 번호로 왓츠앱 문자 메시지를 보냅니다. | | 왓츠앱 경영 | 템플릿을 사용하여 텍스트 메시지 전송 | 템플릿을 사용하여 여러 번호로 왓츠앱 문자 메시지를 보냅니다. | [ ] {#vonage-spoke__table_u1p_kh2_hfb} ## 스포크 모듈 {#vonage-spoke__section_w2k_lyx_qlb} 필요한 이벤트에 대한 알림을 받도록 양방향 웹후크를 설정할 수 있습니다. 라우팅 정책은 인스턴스에 알리 ServiceNow 기 위해 충족되어야 하는 조건을 정의합니다. 이러한 조건은 알림을 받을 이벤트를 Vonage 기반으로 합니다. 조건이 충족되면 라우팅 정책이 관련 하위 플로우를 트리거하여 작업을 자동화합니다 Vonage . 기본적으로 Vonage Spoke 애플리케이션을 사용할 수 있으며 다음 모듈이 있습니다. * Vonage 웹후크 레지스트리 * Vonage WebHook 라우팅 정책 {#vonage-spoke__ul_qzt_2h4_z3b} Vonage 웹후크 레지스트리 모듈을 사용하여 토큰을 할당하고 API 경로를 제공합니다. 여기에서 콜백 URL을 생성하고 이 URL을 Vonage에 제공해야 합니다. 기본 라우팅 정책은 WebHook 라우팅 정책 모듈에서 Vonage 참조로 제공됩니다. 요구 사항에 따라 이러한 라우팅 정책을 사용자 지정합니다. 라우팅 정책은 다음 필드를 지원합니다. * 키워드 * 호출 방향 * 호출 상태 * 이벤트 유형 * 시작 * SMS 상태 * SMS 텍스트 * 받는 사람 * 왓츠앱 메시지 상태 * 왓츠앱 문자 메시지 * 관련 필드 표시 {#vonage-spoke__supp-fields-vonage} ## 연결 및 자격 증명 별칭 요구 사항 {#vonage-spoke__section_ibn_pj2_hfb} Integration Hub는 별칭을 사용하여 연결 및 자격 증명 정보를 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다. 자세한 내용은 [Connections and Credentials](https://www.servicenow.com/docs/access?context=r-credentials&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 문서를 참조하십시오. 스포크와 함께 두 개의 연결 및 자격 증명 별칭을 사용할 수 있습니다.Vonage{#vonage-spoke__table_gtq_d52_pmb__entry__2} | Vonage 별명 | 설명 | |-|-| | Vonage기본 | SMS, 번호, 계정을 관리하는 작업에 필요합니다. | | Vonage | 호출 왓츠앱을 관리하는 작업에 필요하며 . | [ ] {#vonage-spoke__table_gtq_d52_pmb} 스포크 설정에 대한 자세한 내용은 다음을 참조하십시오. [Vonage 스포크 설정](https://servicenow-prod.fluidtopics.net/~JZoBlDxZK~p1jTGsU3CsA#setup-vonage-spoke "인스턴스를 인스턴스와 Vonage 통합 ServiceNow 하여 인스턴스 간에 통신을 활성화합니다. 이 통합을 통해 인스턴스는 ServiceNow 인스턴스에 대한 Vonage 작업을 자동화하는 동시에 Vonage 인스턴스에 페이로드를 보낼 수 있습니다 ServiceNow .").