Współdziałanie zespołów: wywoływanie
Ważne
Funkcje opisane w tym artykule są obecnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą być nieobsługiwane lub ograniczone. Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.
W ramach tej wersji zapoznawczej zestawy SDK usług Azure Communication Services mogą służyć do tworzenia aplikacji, które umożliwiają korzystanie z własnych tożsamości (BYOI) do uruchamiania połączeń 1:1 z użytkownikami usługi Teams. Standardowe ceny usług Azure Communication Services mają zastosowanie do tych użytkowników, ale nie ma dodatkowej opłaty za możliwość współdziałania. Aplikacje niestandardowe utworzone za pomocą usług Azure Communication Services służące do łączenia się użytkowników usługi Teams lub aplikacji głosowych usługi Teams mogą być używane przez użytkowników końcowych lub botów oraz nie ma różnicy w sposobie ich wyświetlania użytkownikom w aplikacjach usługi Teams, chyba że jest to jawnie wskazane przez dewelopera aplikacji z nazwą wyświetlaną.
Aby włączyć wywoływanie między użytkownikami usług Communication Services i dzierżawą usługi Teams, zezwól dzierżawie za pośrednictwem formularza i włącz połączenie między dzierżawą a zasobem usług komunikacyjnych.
Włączanie współdziałania w dzierżawie usługi Teams
Użytkownik Firmy Microsoft Entra z rolą administratora usługi Teams może uruchamiać polecenie cmdlet programu PowerShell za pomocą modułu MicrosoftTeams, aby włączyć zasób usług komunikacyjnych w dzierżawie.
1. Przygotowanie modułu Microsoft Teams
Najpierw otwórz program PowerShell i zweryfikuj istnienie modułu Teams za pomocą następującego polecenia:
Get-module *teams*
Jeśli moduł nie jest widoczny MicrosoftTeams
, zainstaluj go najpierw. Aby zainstalować moduł, musisz uruchomić program PowerShell jako administrator. Uruchom następujące polecenie:
Install-Module -Name MicrosoftTeams
Zostaniesz poinformowany o modułach, które zostaną zainstalowane, co można potwierdzić przy użyciu elementu Y
lub A
odpowiedzi. Jeśli moduł jest zainstalowany, ale jest nieaktualny, możesz uruchomić następujące polecenie, aby zaktualizować moduł:
Update-Module MicrosoftTeams
2. Łączenie z modułem usługi Microsoft Teams
Gdy moduł jest zainstalowany i gotowy, możesz nawiązać połączenie z modułem MicrosftTeams za pomocą następującego polecenia. Zostanie wyświetlony monit z interakcyjnym oknem, aby się zalogować. Konto użytkownika, którego będziesz używać, musi mieć uprawnienia administratora usługi Teams. W przeciwnym razie możesz uzyskać access denied
odpowiedź w następnych krokach.
Connect-MicrosoftTeams
3. Włączanie konfiguracji dzierżawy
Współdziałanie z zasobami usług Communication Services jest kontrolowane za pośrednictwem konfiguracji dzierżawy i przypisanych zasad. Dzierżawa usługi Teams ma jedną konfigurację dzierżawy, a użytkownicy usługi Teams przypisyli zasady globalne lub zasady niestandardowe. Aby uzyskać więcej informacji, zobacz Przypisywanie zasad w usłudze Teams.
Po pomyślnym zalogowaniu można uruchomić polecenie cmdlet Set-CsTeamsAcsFederationConfiguration , aby włączyć zasób usług Communication Services w dzierżawie. Zastąp tekst IMMUTABLE_RESOURCE_ID
niezmiennym identyfikatorem zasobu w zasobie komunikacyjnym. Więcej informacji na temat sposobu uzyskiwania tych informacji można znaleźć tutaj.
$allowlist = @('IMMUTABLE_RESOURCE_ID')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlist
4. Włączanie zasad dzierżawy
Do każdego użytkownika usługi Teams przypisano element External Access Policy
, który określa, czy użytkownicy usług Komunikacyjnych mogą wywoływać tego użytkownika usługi Teams. Użyj polecenia cmdlet Set-CsExternalAccessPolicy, aby upewnić się, że zasady przypisane do użytkownika usługi Teams mają ustawioną wartość EnableAcsFederationAccess
$true
Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true
Uzyskiwanie identyfikatora użytkownika aplikacji Teams
Aby rozpocząć wywołanie za pomocą użytkownika usługi Teams lub aplikacji Teams Voice, musisz mieć identyfikator obiektu docelowego. Dostępne są następujące opcje pobierania identyfikatora:
- Interfejs użytkownika identyfikatora Entra firmy Microsoft lub z synchronizacją katalogów lokalnych Microsoft Entra Connect
- Programowo za pośrednictwem interfejsu API programu Microsoft Graph
Wywołanie
Za pomocą zestawu SDK wywołującego użytkownik lub punkt końcowy usługi Communication Services może uruchomić wywołanie 1:1 z użytkownikami usługi Teams zidentyfikowanym przez identyfikator obiektu Entra firmy Microsoft. Możesz łatwo zmodyfikować istniejącą aplikację, która wywołuje innych użytkowników usług komunikacyjnych w celu wywoływania użytkowników usługi Teams.
Zarządzanie wywołaniami — przewodnik dotyczący usług Azure Communication Services | Microsoft Docs
Wywoływanie innego punktu końcowego usług komunikacyjnych przy użyciu identyfikatora communicationUserId:
const acsCallee = { communicationUserId: '<Azure Communication Services User ID>' }
const call = callAgent.startCall([acsCallee]);
Wywoływanie użytkownika usługi Teams przy użyciu identyfikatora microsoftTeamsUserId:
const teamsCallee = { microsoftTeamsUserId: '<Teams User AAD Object ID>' }
const call = callAgent.startCall([teamsCallee]);
Zdarzenia połączeń głosowych i wideo
Zdarzenia połączeń głosowych i wideo usługi Communication Services są wywoływane w przypadku połączeń między użytkownikiem usług Communication Services i użytkownikami usługi Teams.
Ograniczenia i znane problemy
- Ta funkcja nie jest obecnie dostępna w zestawie .NET Calling SDK.
- Użytkownicy usługi Teams muszą być w trybie "TeamsOnly". Skype dla firm użytkownicy nie mogą odbierać połączeń 1:1 od użytkowników usług Komunikacyjnych.
- Eskalacja do wywołania grupy nie jest obsługiwana.
- Nagrywanie połączeń usług Komunikacyjnych nie jest dostępne dla połączeń 1:1.
- Zaawansowane możliwości routingu połączeń, takie jak przekazywanie połączeń, odbiór połączeń grupowych, jednoczesne dzwonienie i poczta głosowa nie są obsługiwane.
- Użytkownicy usługi Teams nie mogą ustawiać użytkowników usług Communication Services jako elementów docelowych przekazywania/transferu.
- Wiele funkcji w kliencie usługi Teams nie działa zgodnie z oczekiwaniami podczas wywołań 1:1 z użytkownikami usług Communication Services.
- Urządzenia innych firm dla aplikacji Teams i telefonów IP Skype nie są obsługiwane.
Prywatność
Współdziałanie usług Azure Communication Services i Microsoft Teams umożliwia aplikacjom i użytkownikom uczestnictwo w połączeniach i spotkaniach usługi Teams. W gestii Klienta leży zapewnienie, aby podczas rozmowy lub spotkania obsługiwanego przez usługę Microsoft Teams użytkownicy aplikacji byli powiadamiani o włączeniu funkcji nagrywania lub transkrypcji.
Firma Microsoft wskaże za pośrednictwem interfejsu API usług Azure Communication Services, że rozpoczęto nagrywanie lub transkrypcję. Należy przekazać ten fakt w czasie rzeczywistym użytkownikom w interfejsie użytkownika aplikacji. Zgadzasz się na uświadczenie firmy Microsoft za wszystkie koszty i szkody poniesione z powodu braku przestrzegania tego obowiązku.