Gerenciar conectores e conectores personalizados do Microsoft 365

  • Artigo
  • Aplica-se a:
    Microsoft Teams

Os conectores no Microsoft Teams fornecem atualizações de conteúdo e serviço diretamente de serviços de terceiros em um canal do Teams. Usando conectores, os usuários podem receber atualizações de serviços populares como Azure DevOps Services, Trello, Wunderlist, GitHub e muito mais. Os conectores postam essas atualizações diretamente no fluxo de chat. Essa funcionalidade facilita que todos os membros da equipe permaneçam em sincronização e recebam rapidamente as informações relevantes.

O Teams e os grupos do Microsoft 365 usam conectores. Você pode usar os mesmos conectores no Teams e no Microsoft Exchange.

Qualquer membro da equipe pode adicionar um conector a um canal, se as permissões da equipe permitirem. As atualizações do serviço, das quais o conector busca informações, notifica todos os membros da equipe. Qualquer membro da equipe com as permissões para adicionar ou remover pode modificar a configuração de conectores feita por outros membros.

Habilitar ou desabilitar conectores no Teams

O módulo Exchange Online PowerShell v2 usa autenticação moderna e funciona com MFA (autenticação multifator) para se conectar a todos os ambientes do PowerShell relacionados ao Exchange no Microsoft 365. Os administradores podem usar Exchange Online PowerShell para desabilitar conectores para uma organização inteira ou uma caixa de correio de grupo específica. Se um conector estiver desabilitado, ele afetará todos os usuários dessa organização ou caixa de correio. Você não pode desabilitar um conector para alguns usuários específicos.

A configuração da organização substitui a configuração do grupo. Por exemplo, se um administrador habilita conectores para o grupo e desabilita os mesmos conectores para a organização, os conectores serão desabilitados para o grupo. Para habilitar um conector no Teams, conecte-se ao PowerShell do Exchange Online usando autenticação moderna com ou sem MFA.

Para habilitar ou desabilitar um conector, execute os seguintes comandos no Microsoft Exchange Online PowerShell:

  1. Abra o PowerShell como administrador.

  2. Use o comando Import-Module ExchangeOnlineManagement para importar o módulo do Microsoft Exchange.

  3. Para desabilitar conectores em sua organização, use o comando Set-OrganizationConfig -ConnectorsEnabled:$false.

  4. Para conectar a conta de administrador, use o comando Connect-ExchangeOnline -UserPrincipalName UPN -ExchangeEnvironmentName O365USGovGCCHigh. Substitua UPN pelo nome da entidade de usuário.

  5. Para habilitar conectores para o Teams, use os comandos a seguir. Para desabilitar conectores ou mensagens acionáveis, defina o valor como false em vez de true nos comandos a seguir.

    • Set-OrganizationConfig -ConnectorsEnabled:$true
    • Set-OrganizationConfig -ConnectorsEnabledForTeams:$true
    • Set-OrganizationConfig -ConnectorsActionableMessagesEnabled:$true

Para obter mais informações sobre a troca de módulos do PowerShell, consulte Set-OrganizationConfig. Para habilitar ou desabilitar conectores do Outlook, conecte aplicativos aos seus grupos no Microsoft Outlook. Para saber mais sobre o NOME da Entidade de Usuário (UPN), confira o que é UPN no Microsoft 365.

Nota

Leva até 24 horas para que essas alterações se propagassem.

Publicar conectores para sua organização

Para disponibilizar um conector personalizado para os usuários da sua organização, carregue um aplicativo de conector personalizado no catálogo de aplicativos da sua organização. Os usuários dentro da organização podem instalar, configurar e usar o conector em uma equipe.

Importante

Os conectores personalizados não estão disponíveis nos ambientes GCC (Nuvem da Comunidade Governamental), GCCH (Government Community Cloud-High) e DOD (Departamento de Defesa).

Para usar conectores em uma equipe ou canal, abra o menu Mais Opções no canto superior direito de um canal. No menu, selecione Conectores e localize ou pesquise o conector necessário. Configure o conector selecionado, se necessário.

Captura de tela que mostra adicionar conectores ao canal no Teams a partir das opções Mais no canto superior direito do canal.

Usar conectores no GCC ou no GCCH

Os conectores são desabilitados por padrão nos ambientes do GCC (Government Cloud Community) e do GCCH (Government Community Cloud-High). Para permitir que os usuários usem conectores em ambientes GCC ou GCCH, siga estas etapas:

  1. Você deve habilitar conectores no Teams.

  2. Para definir os parâmetros, conecte-se ao Exchange Online PowerShell.

  3. Para usar um webhook de entrada no Teams, crie um aplicativo personalizado usando o seguinte manifest.json. Para usar ícones no aplicativo personalizado, siga as diretrizes para criar ícones de aplicativo.

    {
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
  "manifestVersion": "1.5",
  "id": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
  "version": "1.0.0",
  "packageName": "com.incomingwebhook.microsoft",
  "developer": {
    "name": "Microsoft Corporation",
    "websiteUrl": "https://go.microsoft.com/fwlink/?linkid=837668",
    "privacyUrl": "https://privacy.microsoft.com/privacystatement",
    "termsOfUseUrl": "https://www.microsoft.com/servicesagreement"
  },
  "description": {
    "full": "The Incoming Webhook connector enables external services to notify you about activities that you want to track.",
    "short": "Send data from a service to your Microsoft 365 group in real time. "
  },
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "connectors": [
    {
      "connectorId": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
      "scopes": ["team"]
    }
  ],
  "name": {
    "full": "Incoming Webhook",
    "short": "Incoming Webhook"
  },
  "accentColor": "#FFFFFF",
  "permissions": ["identity", "messageTeamMembers"]
}

  4. Carregue o aplicativo personalizado no centro de administração do Teams.

Considerações ao usar conectores no Teams

  • Os conectores são desabilitados por padrão nos ambientes do GCC (Government Cloud Community) e no GCCH (Government Community Cloud-High). Para habilitar conectores, defina os ConnectorsEnabled parâmetros ou ConnectorsEnabledForTeams como $true com o SetOrganizationConfig cmdlet. Para definir os parâmetros, conecte-se ao Exchange Online PowerShell.

  • Se o usuário que adicionou um conector a uma equipe deixar a equipe, o conector continuará funcionando.

  • Você não pode configurar novas conexões para os seguintes conectores:

    • Aha!
    • Airbrake
    • Aircall
    • Links de aplicativo
    • AppSignal
    • Feijão
    • Bitbucket
    • Amigo
    • Buildkite
    • GATOS
    • Chatra
    • CircleCI
    • CodeShip
    • Contato constante
    • Getresponse
    • Inspetor Fantasma
    • Groove
    • Heroku
    • Honeybadger
    • Intercomunicador
    • Logentries
    • Mailchimp
    • Microsoft Forms
    • Opsgenie
    • PagerDuty
    • Papertrail
    • Rastreador Crucial
    • Raygun
    • Runscope
    • SatisMeter
    • Semáforo
    • Sentinela
    • Entrada/saída simples
    • Stack Exchange
    • SUBVERSION
    • TestFairy
    • Travis CI
    • Trello
    • Uptodown
    • Userlike
    • Wrike
    • XP-Dev
    • Zendesk