Vonage 스포크 설정

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 6분

    • 인스턴스를 인스턴스와 Vonage 통합 ServiceNow 하여 인스턴스 간에 통신을 활성화합니다. 이 통합을 통해 인스턴스는 ServiceNow 인스턴스에 대한 Vonage 작업을 자동화하는 동시에 Vonage 인스턴스에 페이로드를 보낼 수 있습니다 ServiceNow .

    시작하기 전에

    • 구독을 Integration Hub 요청합니다.
    • 인스턴스에서 Vonage 스포크 플러그인을 활성화합니다 ServiceNow .
    • 필요한 역할: admin
    • Vonage 개발자 인스턴스 계정입니다.

    Vonage 개발자 인스턴스 구성

    API 키, 비밀 및 서명 비밀과 같은 필수 자격 증명을 생성하여 Vonage 개발자 인스턴스를 설정합니다. 인스턴스는 ServiceNow 연결 기록의 이러한 자격 증명을 사용하여 개발자 인스턴스에 연결합니다 Vonage .

    시작하기 전에

    필요한 역할: admin

    개발자 계정에 대한 Vonage 액세스 권한.

    프로시저

    1. https://developer.vonage.com/en/home에 로그인합니다.
    2. 개발자 센터 페이지에서 내 대시보드를 Vonage 선택합니다.내 대시보드 페이지입니다.
    3. Vonage API 대시보드 페이지에서 기본 API 키와 API 시크릿을 사용하거나 사용자 지정 API 키 및 API 시크릿을 생성합니다.
      1. 기본 API 키와 API 시크릿을 사용하려면 기본 API 키와 API 시크릿 값을 복사합니다.API 키 및 API 비밀에 대한 복사 버튼입니다.
      2. 사용자 지정 API 키 및 API 시크릿을 생성하려면 왼쪽 패널에서 API 설정을 선택합니다.API 설정 링크.
      3. 추가 API 키 요청을 선택합니다.
      4. 양식을 작성하여 제출합니다.
      5. 새 비밀 만들기를 선택합니다.
      6. Add a new secret(새 보안 암호 추가) 창에서 사용자 지정 암호를 입력합니다.
      7. 저장을 선택합니다.
    4. 서명 비밀 필드에서 서명 비밀을 복사합니다.

    Vonage 연결 및 자격 증명 별칭에 대한 연결 기록 구성

    인스턴스를 인스턴스와 Vonage 연결하고 인스턴스에 대한 Vonage 다양한 작업을 자동화할 수 ServiceNow 있는 연결 기록을 구성합니다. 예를 들어 계정 잔액을 가져오는 Vonage 플로우를 워크플로우 스튜디오 생성합니다.

    시작하기 전에

    필요한 역할: admin
    주:
    Vonage 스포크 범위 내에 있는지 확인합니다.

    프로시저

    1. 다음으로 이동 모두 > 프로세스 자동화 > 플로우 디자이너.
    2. 연결을 선택합니다.
    3. 모든 연결 검색 필드에 Vonage를 입력합니다.모든 연결 검색 필드.
    4. Vonage 카드에서 상세 정보 보기를 선택합니다.
    5. 구성을 선택합니다.
    6. 양식을 작성합니다.
      표 1. 연결 작성
      필드 설명
      연결 이름 연결 기록의 기본 및 읽기 전용 이름입니다. 연결 기록에 사용자 지정 이름을 제공하려면 연결 추가를 선택하여 연결 기록을 생성합니다.
      연결 URL Vonage API에 연결하는 URL입니다.
      메시지 API 버전 Vonage 인스턴스에서 SMS 기능을 사용하기 위해 연결 기록이 요청하는 API의 버전입니다.
      음성 API 버전 Vonage 인스턴스에서 음성 기능을 사용하기 위해 연결 기록이 요청하는 API의 버전입니다.
      자격 증명 이름 자격 증명 기록의 이름입니다. 업데이트할 수 있는 기본 이름 os Vonage 자격 증명입니다.
      애플리케이션 이름 Vonage 개발자 계정의 설정 페이지에서 입력한 계정의 이름입니다.Vonage 인스턴스의 계정 이름 필드입니다.
      API 키 Vonage 개발자 인스턴스에서 획득한 API 키입니다.
      API 비밀 Vonage 개발자 인스턴스에서 획득한 API 비밀입니다.
      서명 비밀 Vonage 개발자 인스턴스에서 획득한 서명 비밀 키입니다.
    7. 연결 만들기를 선택합니다.

    Vonage에 대한 연결 기록 구성 기본 별칭

    인스턴스를 인스턴스와 Vonage 연결하고 인스턴스에 대한 Vonage 다양한 작업을 자동화할 수 ServiceNow 있는 연결 기록을 구성합니다. 예를 들어 계정 잔액을 가져오는 Vonage 플로우를 워크플로우 스튜디오 생성합니다.

    시작하기 전에

    필요한 역할: admin
    주:
    Vonage 스포크 범위 내에 있는지 확인합니다.

    프로시저

    1. 다음으로 이동 모두 > 프로세스 자동화 > 플로우 디자이너.
    2. 연결을 선택합니다.
    3. 모든 연결 검색 필드에 Vonage를 입력합니다.모든 연결 검색 필드.
    4. VonagePrimary 카드에서 상세 정보 보기를 선택합니다.
    5. 구성을 선택합니다.
    6. 양식을 작성합니다.
      표 2. 연결 작성
      필드 설명
      연결 이름 연결 기록의 기본 및 읽기 전용 이름입니다. 연결 기록에 사용자 지정 이름을 제공하려면 연결 추가를 선택하여 연결 기록을 생성합니다.
      연결 URL Vonage API에 연결하는 URL입니다. 을 입력합니다 https://rest.nexmo.com.
      API 키 Vonage 개발자 인스턴스에서 획득한 API 키입니다.
      API 비밀 Vonage 개발자 인스턴스에서 획득한 API 비밀입니다.
    7. 연결 만들기를 선택합니다.

    Vonage에서 데이터를 수신하기 위한 웹후크 생성

    Vonage API 플랫폼에서 ServiceNow 인스턴스로 데이터를 보낼 수 있도록 SMS용 웹후크를 설정합니다. 예를 들어, ServiceNow 인스턴스의 플로우가 호출 상세 정보에 대한 API 요청을 Vonage API로 보내지만 처음에 요청이 실패하는 경우, 웹후크는 Vonage API가 나중에 데이터를 보내도록 보장합니다.

    시작하기 전에

    필요한 역할: admin.

    프로시저

    1. 다음으로 이동 모두 > Vonage 스포크 > Vonage 웹후크 레지스트리.
    2. 새로 만들기를 선택합니다.
    3. 양식에서 다음과 같은 필드를 채웁니다.
      표 3. Vonage 웹후크 레지스트리 양식
      필드 설명
      이름 웹후크 기록을 고유하게 식별하는 이름입니다.
      설명 웹후크 기록에 대한 설명입니다.
      이벤트 유형 웹후크가 설정된 이벤트의 유형입니다. SMS를 선택합니다.
      비밀 키 웹후크 요청을 인증하는 비밀 키입니다. 사용자 지정 비밀 키를 입력합니다.
    4. 양식 헤더를 마우스 오른쪽 버튼으로 클릭하고 저장을 선택합니다.
    5. 콜백 URL을 선택합니다.
      웹후크 콜백 URL이 표시됩니다.
    6. 웹후크 콜백 URL을 복사하고 기록합니다.
    7. https://developer.vonage.com/en/home에 로그인합니다.
    8. 왼쪽 패널의 Build & Manage(빌드 및 관리)에서 Applications(애플리케이션)를 선택합니다.Build & Manage(빌드 및 관리) 아래의 Applications(애플리케이션) 링크.
    9. Your applications(내 애플리케이션) 페이지에서 애플리케이션에 대한 메뉴 아이콘( Menu icon.)을 선택합니다.내 응용 프로그램.
    10. 편집을 선택합니다.
    11. 메시지 제목 아래에서 인바운드 URL 및 상태 URL 필드에 콜백 URL을 입력합니다.메시지 설정을 탭합니다.
    12. 왼쪽 패널에서 API 설정을 선택합니다.
    13. 설정 페이지의 SMS 설정 제목에서 SMS API를 선택했는지 확인합니다.
    14. 값을 입력합니다.
      필드 값
      DLR(Delivery Receipts) 웹후크 웹후크 콜백 URL
      인바운드 SMS 웹후크 웹후크 콜백 URL
    15. 변경 사항 저장을 선택합니다.
      애플리케이션에 대한 SMS 설정이 저장됩니다.

    웹후크 및 라우팅 정책 사용자 지정

    요구 사항에 따라 웹후크 라우팅 정책 및 하위 플로우를 사용자 지정합니다.

    시작하기 전에

    필요한 역할: admin

    프로시저

    1. 다음으로 이동 모두 > 플로우 디자이너 > 디자이너.
    2. 하위 플로우를 클릭합니다.
    3. 필요한 기본 하위 플로우의 사본을 생성합니다.
    4. 요구 사항에 따라 하위 플로우를 사용자 지정하고 게시합니다.
      하위 플로우 생성 및 사용에 대한 자세한 내용과 Vonage 스포크 기본 라우팅 정책 및 하위 플로우가 지원하는 필드에 대한 자세한 내용은 하위 플로우 빌드를 참조하십시오.
    5. 다음으로 이동 Vonage 스포크 > Vonage WebHook 라우팅 정책.
    6. 새로 만들기를 클릭합니다.
    7. 양식의 필드에 내용을 입력합니다.
      표 4. 결정 양식
      필드 설명
      레이블 라우팅 정책을 식별하는 고유 레이블입니다.
      기본 대답 이 옵션이 기본 대답인지 여부를 지정하는 옵션입니다. 조건이 충족되지 않는 경우 기본 대답을 적용할 수 있습니다.
      1. 조회 아이콘(조회 아이콘)을 클릭합니다.
      2. 문서 목록에서 필요한 하위 플로우를 선택합니다.
        주:
        테이블 이름이플로우 [sys_hub_flow]인지 확인합니다.
      조건 에서 필요한 이벤트가 발생할 때 충족해야 하는 조건입니다 Vonage. 지원되는 Vonage 필드는 다음과 같습니다.
      • 키워드
      • 호출 방향
      • 호출 상태
      • 이벤트 유형
      • 시작
      • SMS 상태
      • SMS 텍스트
      • 받는 사람
      • 왓츠앱 메시지 상태
      • 왓츠앱 문자 메시지
      • 관련 필드 표시
      응답 지정된 조건이 충족될 때 트리거되어야 하는 하위 플로우입니다.
    8. 제출을 클릭합니다.
      주:
      이러한 라우팅 정책은 결정 테이블에 저장됩니다. 사용자는 이러한 테이블의 데이터를 직접 업데이트하거나 수정하지 않도록 주의해야 합니다.