Integracja z interfejsem API aprowizacji usługi Azure Communications Gateway (wersja zapoznawcza)
W tym artykule wyjaśniono, kiedy musisz zintegrować się z interfejsem API aprowizacji usługi Azure Communications Gateway (wersja zapoznawcza) i przedstawiono ogólne omówienie rozpoczynania pracy. Jest przeznaczony dla deweloperów oprogramowania pracujących dla operatorów telekomunikacyjnych.
Interfejs API aprowizacji umożliwia skonfigurowanie usługi Azure Communications Gateway ze szczegółami klientów i przypisanymi do nich numerami. Jeśli używasz interfejsu API aprowizacji na potrzeby synchronizacji usługi zaplecza, możesz również aprowizować środowiska Kontakt z operatorem i Teams Phone Mobile ze szczegółami klientów korporacyjnych i numerami przydzielanymi do nich. Ta aprowizacja przepływowa pozwala spełnić wymagania Kontakt z operatorem i aplikacji Teams Phone Mobile, aby używać interfejsów API do zarządzania klientami i numerami po uruchomieniu usługi.
Interfejs API aprowizacji jest interfejsem API REST.
Niezależnie od tego, czy integrujesz się z interfejsem API aprowizacji, zależy od wybranej usługi komunikacji.
| Usługa komunikacji | Integracja interfejsu API aprowizacji | Purpose |
|---|---|---|
| Routing bezpośredni w usłudze Microsoft Teams | Obsługiwane (alternatywą dla portalu zarządzania numerami) | — Konfigurowanie poddomeny skojarzonej z każdym klientem routingu bezpośredniego. — Generowanie rekordów DNS specyficznych dla każdego klienta (zgodnie z wymaganiami środowiska platformy Microsoft 365). — Wskazuje, że liczby są włączone dla routingu bezpośredniego. - (Opcjonalnie) Konfigurowanie niestandardowego nagłówka dla komunikatów w sieci. |
| Kontakt z operatorem | Zalecane | - (Zalecane) Aprowizowanie przepływowe Kontakt z operatorem klientów za pośrednictwem współdziałania z interfejsami API Kontakt z operatorem (przy użyciu synchronizacji usługi zaplecza). - (Opcjonalnie) Konfigurowanie niestandardowego nagłówka dla komunikatów w sieci. |
| Telefon komórkowy w aplikacji Teams | Zalecane | - (Zalecane) Aprowizowanie przepływów klientów aplikacji Teams Phone Mobile za pośrednictwem współdziałania z interfejsami API Kontakt z operatorem (przy użyciu synchronizacji usługi zaplecza). |
| Zoom Phone Cloud Peering | Obsługiwane (alternatywą dla portalu zarządzania numerami) | — Wskazuje, że liczby są włączone dla funkcji Zoom. - (Opcjonalnie) Konfigurowanie niestandardowego nagłówka dla komunikatów w sieci. |
Napiwek
Portal zarządzania numerami bramy usługi Azure Communications Gateway zapewnia równoważną funkcję ręcznej aprowizacji. Nie można jednak użyć portalu zarządzania numerami do szczegółowej aprowizacji Kontakt z operatorem i aplikacji Teams Phone Mobile po uruchomieniu usługi.
Wymagania wstępne
Musisz ukończyć wdrażanie usługi Azure Communications Gateway.
Musisz mieć dostęp do maszyny z adresem IP, który może uzyskać dostęp do interfejsu API aprowizacji (wersja zapoznawcza). Ta lista dozwolonych adresów IP (lub zakresów) została skonfigurowana w ramach wdrażania usługi Azure Communications Gateway.
Dowiedz się więcej o interfejsie API aprowizacji (wersja zapoznawcza) i zaplanuj zmiany klienta BSS
Aby zintegrować się z interfejsem API, należy utworzyć (lub zaktualizować) klienta BSS, który może skontaktować się z interfejsem API aprowizacji. Interfejs API aprowizacji obsługuje przepływ uwierzytelniania poświadczeń klienta OAuth 2.0 na maszynie. Klient uwierzytelnia się i wykonuje autoryzowane wywołania interfejsu API bez interakcji użytkowników.
Skorzystaj z kluczowych pojęć i przykładów w dokumentacji interfejsu API, aby dowiedzieć się więcej o zasobach dostępnych za pośrednictwem interfejsu API i żądaniach, które organizacja musi wykonać.
- Zasoby konta to opisy klientów operatorów (zazwyczaj przedsiębiorstwa) i ustawień poszczególnych klientów na potrzeby aprowizacji usług.
- Liczba zasobów należy do konta. Opisują one liczby, usługi, z których korzystają liczby (na przykład routing bezpośredni w usłudze Microsoft Teams) i wszelkie dodatkowe konfiguracje na liczbę.
- Żądania dotyczące zasobów informacji (RFI) to opisy klientów operatorów (zazwyczaj przedsiębiorstwa), którzy wyrazili zainteresowanie odbieraniem usług od operatora za pośrednictwem Kontakt z operatorem i aplikacji Teams Phone Mobile.
Interfejs API aprowizacji ma limit szybkości wynoszący 100 żądań na minutę, stosowany we wszystkich zasobach. Żądanie wsadowe w celu zaktualizowania wielu zasobów jest liczone jako jedno żądanie.
Konfigurowanie klienta usługi BSS w celu nawiązania połączenia z usługą Azure Communications Gateway
Interfejs API aprowizacji (wersja zapoznawcza) jest dostępny na porcie 443 obiektu provapi.<base-domain>, gdzie <base-domain> jest podstawową domeną zasobu usługi Azure Communications Gateway.
Napiwek
Aby znaleźć domenę podstawową:
- Zaloguj się w witrynie Azure Portal.
- Przejdź do obszaru Przegląd zasobu usługi Azure Communications Gateway i wybierz pozycję Właściwości.
- Znajdź pole o nazwie Domena.
Rekord DNS ma czas wygaśnięcia (TTL) 60 sekund. Gdy region ulegnie awarii, platforma Azure aktualizuje rekord DNS w celu odwoływania się do innego regionu, więc klienci tworzący nowe wyszukiwanie DNS otrzymują szczegóły nowego regionu. Zalecamy upewnienie się, że klienci mogą utworzyć nowe wyszukiwanie DNS i ponowić żądanie 60 sekund po przekroczeniu limitu czasu lub odpowiedzi 5xx.
Skorzystaj z sekcji Wprowadzenie w dokumentacji interfejsu API, aby skonfigurować platformę Azure i klienta BSS, aby zezwolić klientowi BSS na dostęp do interfejsu API aprowizacji.
Poniższe kroki zawierają podsumowanie potrzebnej konfiguracji platformy Azure. Zobacz sekcję Wprowadzenie w dokumentacji interfejsu API, aby uzyskać szczegółowe informacje, w tym wymagane wartości konfiguracji.
- Zarejestruj klienta usługi BSS w tej samej dzierżawie platformy Azure co wdrożenie usługi Azure Communications Gateway. Ten proces tworzy rejestrację aplikacji.
- Przypisz się jako właściciel do rejestracji aplikacji.
- Skonfiguruj rejestrację aplikacji przy użyciu zakresów zdefiniowanych w dokumentacji interfejsu API. Ta konfiguracja wskazuje na platformę Azure, że aplikacja może uzyskać dostęp do interfejsu API aprowizacji.
- Jako administrator dzierżawy zezwól aplikacji na używanie przypisanych ról aplikacji.