Vonage 스포크 설정

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분

    • 인스턴스를 인스턴스와 Vonage 통합하여 ServiceNow 둘 사이의 통신을 가능하게 합니다. 이 통합을 ServiceNow 사용하면 인스턴스가 인스턴스에 대한 작업을 Vonage 자동화할 수 있고, 인스턴스는 Vonage 인스턴스에 페이로드를 ServiceNow 보낼 수 있습니다.

    시작하기 전에

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

    Vonage 개발자 인스턴스 구성

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

    시작하기 전에

    필요한 역할: 관리자

    개발자 계정에 액세스합니다 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. 새 보안 암호 추가 창에서 사용자 지정 보안 암호를 입력합니다.
      7. 저장을 선택합니다.
    4. 서명 비밀 필드에서 서명 비밀을 복사합니다.

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

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

    시작하기 전에

    필요한 역할: 관리자
    주:
    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 플로우 워크플로우 스튜디오 를 생성합니다.

    시작하기 전에

    필요한 역할: 관리자
    주:
    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(애플리케이션)를 선택합니다.빌드 및 관리 아래의 애플리케이션 링크.
    9. 내 애플리케이션 페이지에서 애플리케이션의 메뉴 아이콘( 메뉴 아이콘.)을 선택합니다.내 애플리케이션입니다.
    10. 편집을 선택합니다.
    11. 메시지 제목 아래에서 인바운드 URL 및 상태 URL 필드에 콜백 URL을 입력합니다.메시지 설정을 탭합니다.
    12. 왼쪽 패널에서 API 설정을 선택합니다.
    13. 설정 페이지의 SMS 설정 제목 아래에서 SMS API를 선택했는지 확인합니다.
    14. 값을 채웁니다.
      필드 값
      DLR(배송 영수증) 웹후크 웹후크 콜백 URL
      인바운드 SMS 웹후크 웹후크 콜백 URL
    15. 변경 사항 저장을 선택합니다.
      애플리케이션에 대한 SMS 설정이 저장됩니다.

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

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

    시작하기 전에

    필요한 역할: 관리자

    프로시저

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