Compartilhar via

Gerir conectores e conectores personalizados do Microsoft 365

  • Artigo
  • Aplica-se a:
    Microsoft Teams

Os conectores no Microsoft Teams fornecem conteúdos e atualizações de serviço diretamente de serviços de terceiros para um canal do Teams. Ao utilizar conectores, os utilizadores podem receber atualizações de serviços populares, como Azure DevOps Services, Trello, Wunderlist, GitHub e muito mais. Os conectores publicam estas atualizações diretamente no fluxo de chat. Esta funcionalidade facilita a sincronização de todos os membros da equipa e a receção rápida das informações relevantes.

Os grupos do Teams e do Microsoft 365 utilizam conectores. Pode utilizar os mesmos conectores no Teams e no Microsoft Exchange.

Qualquer membro da equipa pode adicionar um conector a um canal, se as permissões da equipa o permitirem. As atualizações do serviço, das quais o conector obtém informações, notificam todos os membros da equipa. Qualquer membro da equipa com permissões para adicionar ou remover pode modificar a configuração dos conectores efetuada por outros membros.

Importante

Os programadores não podem registar novos conectores no portal do programador do Conector.

Atualizar o URL dos conectores

Os conectores do Teams estão a transitar para um novo URL para melhorar a segurança. Durante esta transição, poderá receber notificações para atualizar o conector configurado para utilizar o novo URL. Recomendamos vivamente que atualize o conector imediatamente para evitar qualquer interrupção nos serviços do conector.

Esta alteração é necessária apenas para Conectores baseados em webhook, como Webhook recebido e conectores de terceiros. A alteração não é necessária para os conectores de consulta, como o RSS. Tem de atualizar o URL do conector para continuar a publicar notificações no Teams após 31 de dezembro de 2024.

Sugestão

Recomendamos que anote o URL que atualizar. Depois de ser atualizado, já não pode ver o URL anterior. Um URL antigo pode ser útil para localizar e identificar os sistemas que ainda o utilizam e que tem de atualizar com o novo URL.

Para atualizar o URL, siga estes passos:

  1. Aceda a Gerir canal num canal do Teams, selecione Editar na opção Conectores e selecione Secção Configurado . Verifique as ligações de conector existentes nesta página.

    Captura de ecrã a mostrar a opção gerir canal no Teams.

  2. Atualize apenas as ligações que são apresentadas Attention required na opção Gerir .

    Captura de ecrã a mostrar as ligações configuradas num canal do Teams que precisam de atenção.

  3. Siga um destes procedimentos:

    • Para os conectores que contêm um URL de webhook, selecione Gerir e Atualizar URL.

      Captura de ecrã a mostrar a opção para atualizar um URL de webhook.

    • Para outros tipos de conectores, remova o conector e recrie a configuração do conector.

  4. Utilize o URL atualizado ou a nova ligação nos sistemas que estavam a publicar no URL antigo. A página Configurar apresenta que o URL está atualizado.

    Captura de ecrã a mostrar uma confirmação após a atualização do URL.

Para saber mais ou para partilhar mais informações com os programadores de aplicações, veja Informações de preterição de conectores.

Habilitar ou desabilitar conectores no Teams

O módulo Exchange Online PowerShell v2 utiliza autenticação moderna e funciona com autenticação multifator (MFA) para ligar a todos os ambientes do PowerShell relacionados com o Exchange no Microsoft 365. Os administradores podem utilizar Exchange Online PowerShell para desativar os conectores de uma organização inteira ou de uma caixa de correio de grupo específica. Se um conector estiver desativado, afetará todos os utilizadores nessa organização ou caixa de correio. Não pode desativar um conector para alguns utilizadores específicos.

A definição da organização substitui a definição do grupo. Por exemplo, se um administrador ativar os conectores para o grupo e desativar os mesmos conectores para a organização, os conectores serão desativados 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 ativar ou desativar um conector, execute os seguintes comandos no Microsoft Exchange Online PowerShell:

  1. Abra o PowerShell como administrador.

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

  3. Para desativar os conectores na sua organização, utilize o comando Set-OrganizationConfig -ConnectorsEnabled:$false.

  4. Para ligar a conta de administrador, utilize o comando Connect-ExchangeOnline -UserPrincipalName UPN -ExchangeEnvironmentName O365USGovGCCHigh. Substitua pelo UPN Nome Principal de Utilizador.

  5. Para ativar conectores para o Teams, utilize os seguintes comandos. Para desativar conectores ou mensagens acionáveis, defina o valor como false em vez de true nos seguintes comandos.

    • 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, veja Set-OrganizationConfig. Para habilitar ou desabilitar conectores do Outlook, conecte aplicativos aos seus grupos no Microsoft Outlook. Para saber mais sobre o Nome Principal de Utilizador (UPN), veja o que é o UPN no Microsoft 365.

Nota

Estas alterações demoram até 24 horas a serem propagadas.

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 utilizadores na organização podem instalar, configurar e utilizar o conector numa equipa.

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 ecrã que mostra a adição de conectores ao seu canal no Teams a partir das opções Mais no canto superior direito do canal.

Utilizar conectores em GCC ou GCCH

Os conectores estão desativados por predefinição nos ambientes da Comunidade de Nuvem governamental (GCC) e da Comunidade Governamental Cloud-High (GCCH). Para permitir que os seus utilizadores utilizem conectores em ambientes GCC ou GCCH, siga estes passos:

  1. Tem de ativar os conectores no Teams.

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

  3. Para utilizar um webhook recebido no Teams, crie uma aplicação personalizada com o seguinte manifest.json. Para utilizar ícones na aplicação personalizada, siga as diretrizes para criar ícones de aplicação.

    {
  "$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 a aplicação personalizada no seu centro de administração do Teams.

Considerações ao utilizar Conectores no Teams

  • Os conectores estão desativados por predefinição nos ambientes da Comunidade de Nuvem governamental (GCC) e Cloud-High da Comunidade Governamental (GCCH). Para ativar os conectores, defina os ConnectorsEnabled parâmetros ou ConnectorsEnabledForTeams como $true com o SetOrganizationConfig cmdlet . Para definir os parâmetros, ligue-se ao Exchange Online PowerShell.

  • Se o utilizador que adicionou um conector a uma equipa sair da equipa, o conector continuará a funcionar.

  • Não pode configurar novas ligações para os seguintes conectores:

    • Aha!
    • Travão aéreo
    • Chamada aérea
    • Ligações da Aplicação
    • AppSignal
    • Pé de feijão
    • Bitbucket
    • Amigo
    • Buildkite
    • GATOS
    • Chatra
    • CírculoCI
    • CodeShip
    • Contacto Constante
    • GetResponse
    • Inspetor Fantasma
    • Groove
    • Heroku
    • Honeybadger
    • Intercomunicador
    • Logentries
    • Mailchimp
    • Microsoft Forms
    • Opsgenie
    • PagerDuty
    • Papel de papel
    • Controlador Pivotal
    • Raygun
    • Runscope
    • SatisMeter
    • Semáforo
    • Sentinela
    • Entrada/Saída Simples
    • Stack Exchange
    • SUBVERSION
    • TestFairy
    • Travis CI
    • Trello
    • Para cima para baixo
    • Userlike
    • Wrike
    • XP-Dev
    • Zendesk