Azure Communications Gateway의 프로비전 API와 통합(미리 보기)
이 문서에서는 Azure Communications Gateway의 프로비전 API(미리 보기)와 통합해야 하는 경우를 설명하고 시작에 대한 대략적인 개요를 제공합니다. 통신 사업자를 위해 일하는 소프트웨어 개발자를 대상으로 합니다.
프로비전 API를 사용하면 고객의 세부 정보 및 고객에게 할당한 번호로 Azure Communications Gateway를 구성할 수 있습니다. 백 엔드 서비스 동기화에 프로비전 API를 사용하는 경우 엔터프라이즈 고객의 세부 정보와 할당한 번호로 운영자 연결 및 Teams Phone 모바일 환경을 프로비전할 수도 있습니다. 이 흐름 프로비저닝을 사용하면 서비스를 실행한 후 API를 사용하여 고객 및 번호를 관리하기 위해 Operator Connect 및 Teams Phone Mobile 요구 사항을 충족할 수 있습니다.
프로비전 API는 REST API입니다.
프로비전 API와의 통합 여부는 선택한 통신 서비스에 따라 다릅니다.
| 통신 서비스 | 프로비전 API 통합 | 목적 |
|---|---|---|
| Microsoft Teams 직접 라우팅 | 지원됨(번호 관리 포털 대체) | - 각 직접 라우팅 고객과 연결된 하위 도메인 구성 - 각 고객과 관련된 DNS 레코드 생성(Microsoft 365 환경에 필요한 경우). - 번호가 직접 라우팅에 사용하도록 설정되어 있음을 나타냅니다. - (선택 사항) 네트워크에 보내는 메시지에 대한 사용자 지정 헤더 구성 |
| 운영자 연결 | 권장 | - (권장) 연산자 연결 API와의 상호 운용을 통해(백 엔드 서비스 동기화 사용) 운영자 연결 고객의 흐름 프로비저닝 - (선택 사항) 네트워크에 보내는 메시지에 대한 사용자 지정 헤더 구성 |
| Teams 전화 모바일 | 권장 | - (권장) 운영자 연결 API와의 상호 운용을 통해 Teams Phone Mobile 고객의 흐름 프로비저닝(백 엔드 서비스 동기화 사용). |
| Zoom Phone 클라우드 피어링 | 지원됨(번호 관리 포털 대체) | - Zoom에 번호가 사용하도록 설정되어 있음을 표시. - (선택 사항) 네트워크에 보내는 메시지에 대한 사용자 지정 헤더 구성 |
팁
Azure Communications Gateway의 번호 관리 포털은 수동 프로비전과 동등한 기능을 제공합니다. 그러나 서비스를 시작한 후에는 운영자 연결 및 Teams 전화 모바일의 전체 흐름 프로비전을 위해 번호 관리 포털을 사용할 수 없습니다.
필수 조건
Azure Communications Gateway 배포를 완료해야 합니다.
프로비전 API(미리 보기)에 액세스할 수 있는 IP 주소가 있는 컴퓨터에 액세스할 수 있어야 합니다. 이 IP 주소(또는 범위)의 허용 목록은 Azure Communications Gateway 배포의 일부로 구성되었습니다.
프로비전 API(미리 보기)에 대해 알아보고 BSS 클라이언트 변경 내용 계획
API와 통합하려면 프로비전 API에 연결할 수 있는 BSS 클라이언트를 만들거나 업데이트해야 합니다. 프로비전 API는 컴퓨터 간 OAuth 2.0 클라이언트 자격 증명 인증 흐름을 지원합니다. 클라이언트는 사용자 상호 작용 없이 인증된 API 호출을 자체적으로 인증하고 수행합니다.
API 참조의 주요 개념 및 예제 정보를 사용하여 API를 통해 사용할 수 있는 리소스 및 조직에서 수행해야 하는 요청에 대해 알아봅니다.
- 계정 리소스는 운영자 고객(일반적으로 엔터프라이즈) 및 서비스 프로비전에 대한 고객별 설정에 대한 설명입니다.
- 번호 리소스는 계정에 속합니다. 번호, 번호가 사용하는 서비스(예: Microsoft Teams 직접 라우팅) 및 번호별 추가 구성을 설명합니다.
- RFI(정보 요청) 리소스는 운영자 연결 및 Teams Phone Mobile을 통해 운영자로부터 서비스를 받는 데 관심을 표명한 운영자 고객(일반적으로 엔터프라이즈)에 대한 설명입니다.
프로비전 API에는 모든 리소스에 적용되는 분당 요청 100개의 속도 제한이 있습니다. 여러 리소스를 업데이트하기 위한 일괄 처리 요청은 하나의 요청으로 계산됩니다.
Azure Communications Gateway에 연결하도록 BSS 클라이언트 구성
프로비저닝 API(미리 보기)는 provapi.<base-domain>의 포트 443에서 사용할 수 있으며, 여기서 <base-domain>은 Azure Communications Gateway 리소스의 기본 도메인입니다.
팁
기본 도메인을 찾으려면 다음을 수행합니다.
- Azure Portal에 로그인합니다.
- Azure Communications Gateway 리소스의 개요로 이동하고 속성을 선택합니다.
- 도메인이라는 필드를 찾습니다.
DNS 레코드의 TTL(Time-to-Live)은 60초입니다. 지역에 오류가 발생하면 Azure는 다른 지역을 참조하도록 DNS 레코드를 업데이트하므로 새 DNS 조회를 수행하는 클라이언트는 새 지역의 세부 정보를 받습니다. 클라이언트가 새 DNS 조회를 수행하고 시간 제한 또는 5xx 응답 후 60초 후에 요청을 다시 시도할 수 있도록 하는 것이 좋습니다.
API 참조의 시작 섹션을 사용하여 BSS 클라이언트가 프로비전 API에 액세스할 수 있도록 Azure 및 BSS 클라이언트를 구성합니다.
다음 단계에서는 필요한 Azure 구성을 요약합니다. 필요한 구성 값을 비롯한 자세한 내용은 API 참조의 시작 섹션을 참조하세요.
- Azure Communications Gateway 배포와 동일한 Azure 테넌트에 BSS 클라이언트를 등록합니다. 이 프로세스는 앱 등록을 만듭니다.
- 자신을 앱 등록의 소유자로 할당합니다.
- API 참조에 정의된 범위로 앱 등록을 구성합니다. 이 구성은 애플리케이션이 프로비전 API에 액세스할 수 있음을 Azure에 나타냅니다.
- 테넌트에 대한 관리자로서 애플리케이션에서 할당한 앱 역할을 사용하도록 허용합니다.