Configuração - Fila de chamadas via PowerShell

  • Aplica-se a: Microsoft Teams

Pré-requisitos

  • Verifique se você tem direitos de administração de locatário.
  • Os agentes, listas de distribuição e canais do Teams mencionados neste artigo já foram criados.

  1. Determine se o MicrosoftTeams módulo PowerShell já está instalado.

    Get-InstalledModule -Name MicrosoftTeams

    Se o MicrosoftTeams módulo PowerShell já estiver instalado, a saída do comando será semelhante a:

    Get-InstalledModule -Name MicrosoftTeams

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
7.7.0                MicrosoftTeams                      PSGallery            Microsoft Teams cmdlets module for Windows PowerShell and PowerShell Core....

    Prossiga para a Etapa 2.

    Se o modelo do PowerShell ainda não estiver instalado, vá para a MicrosoftTeams Etapa 3.

  2. Atualizar o MicrosoftTeams módulo

    Update-Module MicrosoftTeams

    Prossiga para os cenários

  3. Instale o módulo do MicrosoftTeams PowerShell no computador.

    • Configurar seu computador para o Windows PowerShell

    • Módulo MSTeams instalado

      Install-Module -Name MicrosoftTeams -Force -AllowClobber

    • Módulo do Microsoft Graph instalado

      Install-Module -Name Microsoft.Graph -Force -AllowClobber

Cenários

Vendas (Usuários e Grupos)

  • Aninhado atrás do Atendedor Automático: Sim
  • Chamadas: somente pelo atendedor automático de vendas - nenhuma conta de recurso é necessária
  • Idioma: Inglês dos EUA
  • Saudação: Nenhuma (as chamadas são saudadas pelo atendedor automático de vendas)
  • Música em espera: reproduzir um arquivo de áudio
    • Nome do arquivo: sales-hold-in-queue-music.wav
  • Atendimento de chamadas: usuários
    • Bill@contoso.com
    • Mary@contoso.com
  • Atendimento de chamada: Grupo
    • Sales@contoso.com
  • Modo de conferência: Ativado
  • Método de roteamento: Round Robin
  • Roteamento baseado em presença: Ativado
  • Os agentes de chamada podem optar por não receber chamadas: Sim
  • Chamar o agente Tempo de alerta: 15
  • Tratamento de estouro de chamada: 200
    • Redirecionar para: Adele@contoso.com
  • Tratamento de tempo limite de chamada: 120 segundos
    • Redirecionar para: Adele@contoso.com
  • Nenhum agente lidando com
    • Aplicar a todas as chamadas
    • Redirecionar para: Adele@contoso.com
  • Retorno de chamada: Não
  • Nível de serviço: 20 segundos
  • Usuário de Autenticação
    • Adele@contoso.com
  • Aplicativos de voz Política: Vendas
  • Registro de conformidade: Não
  • Histórico de chamadas compartilhado: Sim
    • Modelo: Vendas
  • Gravação automática: Não
Expanda para ver os comandos do PowerShell

Login

Quando solicitado, insira suas credenciais de administrador do Teams.

$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential
Connect-MgGraph -Credential $credential

Create Audio Files

Substitua d:\\ pelo caminho para onde os arquivos wav estão armazenados em seu computador.

$content = [System.IO.File]::ReadAllBytes('d:\sales-hold-in-queue-music.wav')
$audioFileSalesHoldInQueueMusicID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "sales-hold-in-queue-music.wav" -Content $content).ID

Criar modelo de histórico de chamadas compartilhado

Criar Gravação Automática para o modelo de Fila de Chamadas

Obter ID de Usuários

$userAdeleID = (Get-CsOnlineUser -Identity "sip:adele@contoso.com").Identity
$userSalesBillID = (Get-CsOnlineUser -Identity "sip:bill@contoso.com").Identity
$userSalesMaryID = (Get-CsOnlineUser -Identity "sip:mary@contoso.com").Identity

Obter lista de idiomas com suporte

Get-CsAutoAttendantSupportedLanguage

Criar Fila de chamadas

New-CsCallQueue -Name "Sales" -AgentAlertTime 15 -AllowOptOut $true -MusicOnHoldAudioFileID $audioFileSalesHoldInQueueMusicID -OverflowAction Forward -OverflowActionTarget $userAdeleID -OverflowThreshold 200 -TimeoutAction Forward -TimeoutActionTarget $userAdeleID -TimeoutThreshold 120 -RoutingMethod Attendant -ConferenceMode $true -User @($userSalesBillID, $userSalesMaryID) -LanguageID "en-US"

Suporte (Microsoft Shifts)

  • Aninhado atrás do Atendedor Automático: Sim –
  • Chamadas: Por meio do atendedor automático do Suporte, internamente e por meio da PSTN - conta de recurso necessária
  • Idioma: Inglês UK
  • Saudação: Reproduzir um arquivo de áudio
    • Nome do arquivo: support-greeting.wav
  • Música em espera: reproduzir um arquivo de áudio
    • Nome do arquivo: support-hold-in-queue-music.wav
  • Atendimento de chamadas: a equipe de suporte do Microsoft Turns
    • Support@contoso.com
  • Modo de conferência: Ativado
  • Método de roteamento: ocioso por mais tempo
  • Roteamento baseado em presença: N/A – ativado por padrão devido ao Ocioso por Mais Tempo
  • Os agentes de chamada podem optar por não receber chamadas: Não
  • Chamar o agente Tempo de alerta: 15
  • Tratamento de estouro de chamada: 200
    • Redirecionamento: Suporte ao correio de voz compartilhado
      • Reproduzir um arquivo de áudio (support-shared-voicemail-greeting.wav)
      • Transcrição habilitada
  • Tratamento do tempo limite de chamada: 45 minutos
    • Redirecionamento: Suporte ao correio de voz compartilhado
      • TTS: "Lamentamos ter deixado você esperando e agora estamos transferindo sua ligação para o correio de voz."
      • Transcrição habilitada
  • Nenhum agente lidando com
  • Retorno de chamada: Sim
  • Nível de serviço: 30 segundos
  • Usuário de Autenticação
  • Registros de Conformidade
  • Histórico de chamadas compartilhado
  • gravação automática
Expanda para ver os comandos do PowerShell

Login

Quando solicitado, insira suas credenciais de administrador do Teams.

$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential
Connect-MgGraph -Credential $credential

Criar arquivos de áudio

Substitua d:\\ pelo caminho para onde os arquivos wav estão armazenados em seu computador.

$content1 = [System.IO.File]::ReadAllBytes('d:\support-greeting.wav')
$audioFileSupportGreetingID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-greeting.wav" -Content $content1).ID

$content2 = [System.IO.File]::ReadAllBytes('d:\support-hold-in-queue-music.wav')
$audioFileSupportHoldInQueueMusicID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-hold-in-queue-music.wav" -Content $content2).ID

$content3 = [System.IO.File]::ReadAllBytes('d:\support-shared-voicemail-greeting.wav')
$audioFileSupportSharedVoicemailGreetingID = (Import-CsOnlineAudioFile -ApplicationID HuntGroup -FileName "support-shared-voicemail-greeting.wav" -Content $content3).ID

Obter ID do grupo da equipe de suporte

$teamSupportID = (Get-Team -DisplayName "Support").GroupID

Obter lista de idiomas com suporte

Get-CsAutoAttendantSupportedLanguage

Criar Fila de chamadas

New-CsCallQueue -Name "Support" -AgentAlertTime 15 -AllowOptOut $false -DistributionLists $teamSupportID -WelcomeMusicAudioFileID $audioFileSupportGreetingID -MusicOnHoldAudioFileID $audioFileSupportHoldInQueueMusicID -OverflowAction SharedVoicemail -OverflowActionTarget $teamSupportID -OverflowThreshold 200 -OverflowSharedVoicemailAudioFilePrompt $audioFileSupportSharedVoicemailGreetingID -EnableOverflowSharedVoicemailTranscription $true -TimeoutAction SharedVoicemail -TimeoutActionTarget $teamSupportID -TimeoutThreshold 2700 -TimeoutSharedVoicemailTextToSpeechPrompt "We're sorry to have kept you waiting and are now transferring your call to voicemail." -EnableTimeoutSharedVoicemailTranscription $true -RoutingMethod LongestIdle -ConferenceMode $true -LanguageID "en-US"

Obter tipos de licença

Get-MgSubscribedSku

Criar e atribuir uma conta de recurso

Um número de telefone não é necessário aqui, pois a fila de chamadas está aninhada atrás de um atendedor automático.

  • ID do aplicativo
    • Atendente automático: ce933385-9390-45d1-9512-c8d228074e07
    • Fila de chamadas: 11cd3e2e-fccb-42ad-ad00-878b93575e07

O tipo de licença mostrado depois (PHONESYSTEM_VIRTUALUSER) deve ser aquele listado Get-MgSubscribedSku pelo cmdlet.

New-CsOnlineApplicationInstance -UserPrincipalName Support-RA@contoso.com -DisplayName "Support" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Support-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Support-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Support-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Support").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

Instalações (Canal do Teams)

  • Aninhado atrás do Atendedor Automático: Não
  • Chamada direta da PSTN: Não (somente chamadas internas)
  • Idioma: Francês FR
  • Saudação: Nenhuma
  • Música de espera: padrão
  • Atendimento de chamadas: Equipe: Instalações
  • Canal de atendimento telefônico: Suporte técnico
    • Proprietário do canal: Fred@contoso.com
  • Modo de conferência: Ativado
  • Método de roteamento: Round Robin
  • Roteamento baseado em presença: Ativado
  • Os agentes de chamada podem optar por não receber chamadas: Não
  • Chamar o agente Tempo de alerta: 15
  • Tratamento de estouro de chamada: 200
    • Desconectar
  • Tratamento do tempo limite de chamada: 45 minutos
    • Desconectar
  • Nenhum agente lidando com
  • Retorno de chamada: Sim
  • Nível de serviço: 30 segundos
  • Usuário de Autenticação
  • Registros de Conformidade
  • Histórico de chamadas compartilhado
  • gravação automática
Expanda para ver os comandos do PowerShell

Login

Quando solicitado, insira suas credenciais de administrador do Teams.

$credential = Get-Credential
Connect-MicrosoftTeams -Credential $credential
Connect-MgGraph -Credential $credential

Obter ID do grupo da equipe de instalações

$teamFacilitiesGroupID = (Get-Team -DisplayName "Facilities").GroupID

Obter ID do canal da equipe de Suporte Técnico de Recursos

Get-TeamChannel -GroupId $teamFacilitiesGroupID
$teamFacilitiesHelpDeskChannelID = "{assign ID from output of above command}"

Obter ID de usuário do proprietário do canal do Suporte Técnico de Recursos

$teamFacilitiesHelpDeskChannelUserID = (Get-TeamChannelUser -GroupId $teamFacilitiesGroupID -DisplayName "Help Desk" -Role Owner).UserId

Obter em nome de ID da conta de recurso de chamada

$oboResourceAccountID = (Get-CsOnlineUser -Identity "MainAA-RA@contoso.com").Identity

Obter lista de idiomas com suporte

Get-CsAutoAttendantSupportedLanguage

Criar Fila de chamadas

New-CsCallQueue -Name "Facilities" -AgentAlertTime 15 -AllowOptOut $false -ChannelId $teamFacilitiesHelpDeskChannelID -ChannelUserObjectId $teamFacilitiesHelpDeskChannelUserID  -ConferenceMode $true -DistributionList $teamFacilitiesGroupID -LanguageID "fr-FR" -OboResourceAccountIds $oboResourceAccountID -OverflowAction DisconnectWithBusy -OverflowThreshold 200 -RoutingMethod RoundRobin -TimeoutAction Disconnect -TimeoutThreshold 2700 -UseDefaultMusicOnHold $true

Obter tipos de licença

Get-MgSubscribedSku

Criar e atribuir Conta de Recurso

Um número de telefone não é necessário aqui, pois a fila de chamadas está aninhada atrás de um atendedor automático.

  • ID do aplicativo
    • Atendente automático: ce933385-9390-45d1-9512-c8d228074e07
    • Fila de chamadas: 11cd3e2e-fccb-42ad-ad00-878b93575e07

O tipo de licença mostrado depois (PHONESYSTEM_VIRTUALUSER) deve ser aquele listado Get-MgSubscribedSku pelo cmdlet.

New-CsOnlineApplicationInstance -UserPrincipalName Facilities-RA@contoso.com -DisplayName "Facilities" -ApplicationID "11cd3e2e-fccb-42ad-ad00-878b93575e07"

Update-MgUser -UserId "Facilities-RA@contoso.com" -UsageLocation US

Set-MgUserLicense -UserId "Facilities-RA@contoso.com" -AddLicenses @(contoso:PHONESYSTEM_VIRTUALUSER) -RemoveLicenses @()

$applicationInstanceID = (Get-CsOnlineUser -Identity "Facilities-RA@contoso.com").Identity
$callQueueID = (Get-CsCallQueue -NameFilter "Facilities").Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($applicationInstanceID) -ConfigurationID $callQueueID -ConfigurationType CallQueue

Planejar o Teams, atendedores automáticos e filas de chamadas

Veja o que você obtém com a Telefonia do Microsoft Teams

Criar um Atendedor automático por meio de cmdlets

  • Last updated on