Sdílet prostřednictvím

Interoperabilita Teams: Volání

  • Článek

Důležité

Funkce popsané v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

V rámci této verze Preview je možné sady SDK služeb Azure Communication Services použít k vytváření aplikací, které umožňují uživatelům přineste si vlastní identitu (BYOI), aby mohli s uživateli Teams zahajovat volání 1:1. Standardní ceny služeb Azure Communication Services se vztahují na tyto uživatele, ale za možnosti interoperability se neplatí žádné další poplatky. Vlastní aplikace vytvořené pomocí Azure Communication Services pro připojení a komunikaci s uživateli Teams nebo hlasovými aplikacemi Teams můžou používat koncoví uživatelé nebo roboti a neexistuje žádné rozdíly v tom, jak se uživatelům Teams v aplikacích Teams zobrazují, pokud vývojář aplikace explicitně nezjistí zobrazovaný název.

Pokud chcete povolit volání mezi uživateli komunikačních služeb a tenantem Teams, povolte tenanta prostřednictvím formuláře a povolte propojení mezi tenantem a prostředkem komunikačních služeb.

Povolení interoperability v tenantovi Teams

Uživatel Microsoft Entra s rolí správce Teams může spustit rutinu PowerShellu s modulem MicrosoftTeams a povolit prostředek Komunikační služby v tenantovi.

1. Příprava modulu Microsoft Teams

Nejprve otevřete PowerShell a pomocí následujícího příkazu ověřte existenci modulu Teams:

Get-module *teams*

Pokud modul nevidíte MicrosoftTeams , nejdřív ho nainstalujte. Pokud chcete nainstalovat modul, musíte spustit PowerShell jako správce. Pak spusťte následující příkaz:

	Install-Module -Name MicrosoftTeams

Budete informováni o nainstalovaných modulech, které můžete potvrdit pomocí Y odpovědi.A Pokud je modul nainstalovaný, ale je zastaralý, můžete spuštěním následujícího příkazu modul aktualizovat:

	Update-Module MicrosoftTeams

2. Připojení k modulu Microsoft Teams

Po instalaci a připravenosti modulu se můžete připojit k modulu MicrosoftTeams pomocí následujícího příkazu. Zobrazí se výzva k přihlášení pomocí interaktivního okna. Uživatelský účet, který budete používat, musí mít oprávnění správce Teams. V opačném případě můžete získat access denied odpověď v dalších krocích.

Connect-MicrosoftTeams

3. Povolení konfigurace tenanta

Interoperabilita s prostředky komunikačních služeb se řídí prostřednictvím konfigurace tenanta a přiřazených zásad. Tenant Teams má jednu konfiguraci tenanta a uživatelé Teams přiřadili globální zásady nebo vlastní zásady. Další informace najdete v tématu Přiřazení zásad v Teams.

Po úspěšném přihlášení můžete spuštěním rutiny Set-CsTeamsAcsFederationConfiguration povolit prostředek Komunikační služby ve vašem tenantovi. Nahraďte text IMMUTABLE_RESOURCE_ID neměnným ID prostředku v komunikačním prostředku. Další podrobnosti o tom, jak tyto informace získat, najdete tady.

$allowlist = @('IMMUTABLE_RESOURCE_ID')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlist

4. Povolení zásad tenanta

Každý uživatel Teams přiřadil, External Access Policy který určuje, jestli uživatelé komunikačních služeb mohou volat tohoto uživatele Teams. Pomocí rutiny Set-CsExternalAccessPolicy zajistěte, aby zásady přiřazené uživateli Teams byly nastaveny EnableAcsFederationAccess na $true

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Získání ID uživatele Teams

Pokud chcete zahájit hovor s uživatelem Teams nebo aplikací Teams Voice, potřebujete identifikátor cíle. ID můžete načíst pomocí následujících možností:

Povolání

Pomocí sady SDK pro volání může uživatel nebo koncový bod komunikační služby zahájit hovor s uživateli Teams 1:1 identifikovaným ID objektu Microsoft Entra. Existující aplikaci, která volá ostatní uživatele komunikačních služeb, můžete snadno upravit tak, aby volala uživatele Teams.

Správa volání – Průvodce postupy služby Azure Communication Services | Microsoft Docs

Volání jiného koncového bodu komunikační služby pomocí communicationUserId:

const acsCallee = { communicationUserId: '<Azure Communication Services User ID>' }
const call = callAgent.startCall([acsCallee]);

Volání uživatele Teams pomocí microsoftTeamsUserId:

const teamsCallee = { microsoftTeamsUserId: '<Teams User AAD Object ID>' }
const call = callAgent.startCall([teamsCallee]);

Události hlasových hovorů a videohovorů

Události hlasového volání a videohovorů komunikačních služeb jsou vyvolány pro volání mezi uživatelem komunikačních služeb a uživateli Teams.

Omezení a známé problémy

  • Tato funkce není v současné době dostupná v sadě SDK pro volání .NET.
  • Uživatelé Teams musí být v režimu TeamsOnly. Skype pro firmy uživatelé nemůžou od uživatelů komunikačních služeb přijímat volání 1:1.
  • Eskalace skupinového volání se nepodporuje.
  • Záznam hovorů komunikačních služeb není k dispozici pro volání 1:1.
  • Pokročilé možnosti směrování hovorů, jako je přesměrování hovorů, vyzvednutí skupinového hovoru, souběžné vyzvánění a hlasová pošta, se nepodporují.
  • Uživatelé Teams nemůžou nastavit uživatele komunikačních služeb jako cíle předávání a přenosu.
  • Mnoho funkcí v klientovi Teams nefunguje podle očekávání během volání 1:1 s uživateli komunikačních služeb.
  • Zařízení třetích stran pro Teams a SKYPE IP telefony se nepodporují.

Ochrana osobních údajů

Interoperabilita mezi službami Azure Communication Services a Microsoft Teams umožňuje vašim aplikacím a uživatelům účastnit se hovorů a schůzek v Teams. Je vaší odpovědností zajistit, aby uživatelé vaší aplikace byli upozorněni, když je povoleno nahrávání nebo přepis při volání nebo schůzce produktu Teams.

Microsoft bude indikovat prostřednictvím rozhraní API služby Azure Communication Services, že se zahájil záznam nebo přepis. Tento fakt musíte sdělit uživatelům v reálném čase v uživatelském rozhraní vaší aplikace. Souhlasíte s tím, že společnosti Microsoft poskytnete veškeré náklady a škody vzniklé v důsledku vašeho nedodržení této povinnosti.