Gestire i connettori e i connettori personalizzati di Microsoft 365

  • Articolo
  • Si applica a:
    Microsoft Teams

I connettori in Microsoft Teams forniscono aggiornamenti dei contenuti e dei servizi direttamente dai servizi di terze parti in un canale di Teams. Usando i connettori, gli utenti possono ricevere aggiornamenti dai servizi più diffusi come Azure DevOps Services, Trello, Wunderlist, GitHub e altro ancora. I connettori pubblicano questi aggiornamenti direttamente nel flusso di chat. Questa funzionalità consente a tutti i membri del team di rimanere sincronizzati e di ricevere rapidamente le informazioni pertinenti.

Teams e i gruppi di Microsoft 365 usano connettori. È possibile usare gli stessi connettori in Teams e Microsoft Exchange.

Qualsiasi membro del team può aggiungere un connettore a un canale, se consentito dalle autorizzazioni del team. Gli aggiornamenti dal servizio, da cui il connettore recupera informazioni, inviano una notifica a tutti i membri del team. Qualsiasi membro del team con le autorizzazioni per l'aggiunta o la rimozione può modificare la configurazione dei connettori eseguita da altri membri.

Abilitare o disabilitare i connettori in Teams

Il modulo Exchange Online PowerShell v2 usa l'autenticazione moderna e funziona con l'autenticazione a più fattori (MFA) per connettersi a tutti gli ambienti PowerShell correlati a Exchange in Microsoft 365. Gli amministratori possono usare Exchange Online PowerShell per disabilitare i connettori per un'intera organizzazione o una cassetta postale del gruppo specifica. Se un connettore è disabilitato, questo influisce su tutti gli utenti dell'organizzazione o della cassetta postale. Non è possibile disabilitare un connettore per alcuni utenti specifici.

L'impostazione dell'organizzazione sostituisce l'impostazione del gruppo. Ad esempio, se un amministratore abilita i connettori per il gruppo e disabilita gli stessi connettori per l'organizzazione, i connettori vengono disabilitati per il gruppo. Per abilitare un connettore in Teams, connettersi a PowerShell per Exchange Online usando l'autenticazione moderna con o senza MFA.

Per abilitare o disabilitare un connettore, eseguire i comandi seguenti in Microsoft Exchange Online PowerShell:

  1. Aprire PowerShell come amministratore.

  2. Usare il comando Import-Module ExchangeOnlineManagement per importare il modulo di Microsoft Exchange.

  3. Per disabilitare i connettori nell'organizzazione, usare il comando Set-OrganizationConfig -ConnectorsEnabled:$false.

  4. Per connettere l'account amministratore, usare il comando Connect-ExchangeOnline -UserPrincipalName UPN -ExchangeEnvironmentName O365USGovGCCHigh. Sostituire UPN con il nome dell'entità utente.

  5. Per abilitare i connettori per Teams, usare i comandi seguenti. Per disabilitare i connettori o i messaggi su cui è possibile eseguire azioni, impostare il valore false su anziché true nei comandi seguenti.

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

Per altre informazioni sullo scambio di moduli di PowerShell, vedere Set-OrganizationConfig. Per abilitare o disabilitare i connettori di Outlook, connettere le app ai gruppi in Microsoft Outlook. Per altre informazioni sul nome dell'entità utente (UPN), vedere cos'è UPN in Microsoft 365.

Nota

La propagazione di queste modifiche può richiedere fino a 24 ore.

Pubblicare i connettori per l'organizzazione

Per rendere disponibile un connettore personalizzato agli utenti dell'organizzazione, caricare un'app del connettore personalizzata nel catalogo app dell'organizzazione. Gli utenti all'interno dell'organizzazione possono installare, configurare e usare il connettore in un team.

Importante

I connettori personalizzati non sono disponibili negli ambienti Government Community Cloud (GCC), Government Community Cloud-High (GCCH) e Department of Defense (DOD).

Per usare i connettori in un team o in un canale, aprire il menu Altre opzioni nell'angolo in alto a destra di un canale. Nel menu selezionare Connettori, quindi individuare o cercare il connettore richiesto. Configurare il connettore selezionato, se necessario.

Screenshot che mostra l'aggiunta di connettori al canale in Teams da Altre opzioni nell'angolo in alto a destra del canale.

Usare connettori in GCC o GCCH

I connettori sono disabilitati per impostazione predefinita negli ambienti Government Cloud Community (GCC) e Government Community Cloud-High (GCCH). Per consentire agli utenti di usare connettori in ambienti GCC o GCCH, seguire questa procedura:

  1. È necessario abilitare i connettori in Teams.

  2. Per impostare i parametri, connettersi alla Exchange Online PowerShell.

  3. Per usare un webhook in arrivo in Teams, creare un'app personalizzata utilizzando il seguente manifest.json. Per usare le icone nell'app personalizzata, segui le linee guida per creare le icone delle app.

    {
  "$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. Caricare l'app personalizzata nell'interfaccia di amministrazione di Teams.

Considerazioni sull'uso dei connettori in Teams

  • I connettori sono disabilitati per impostazione predefinita negli ambienti Government Cloud Community (GCC) e Government Community Cloud-High (GCCH). Per abilitare i connettori, impostare i ConnectorsEnabled parametri $true o ConnectorsEnabledForTeams su con il SetOrganizationConfig cmdlet. Per impostare i parametri, connettersi alla Exchange Online PowerShell.

  • Se l'utente che ha aggiunto un connettore a un team lascia il team, il connettore continua a funzionare.

  • Non è possibile configurare nuove connessioni per i connettori seguenti:

    • Aha!
    • Airbrake
    • Chiamata aerea
    • Collegamenti app
    • AppSignal
    • Fagiolo magico
    • Bitbucket
    • Amico
    • Buildkite
    • GATTI
    • Chatra
    • CircleCI
    • CodeShip
    • Contatto costante
    • Getresponse
    • Ispettore fantasma
    • Groove
    • Heroku
    • Honeybadger
    • Citofono
    • Logentries
    • Mailchimp
    • Microsoft Forms
    • Opsgenie
    • PagerDuty
    • Papertrail
    • Pivotal Tracker
    • Raygun
    • Runscope
    • SatisMeter
    • Semaforo
    • Sentinella
    • In/Out semplice
    • Stack Exchange
    • SUBVERSION
    • TestFairy
    • Travis CI
    • Trello
    • Uptodown
    • Userlike
    • Wrike
    • XP-Dev
    • Zendesk