M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Connettori di Teams e webhook: stato del ritiro e come sostituirli con i flussi di lavoro

Di ·

I connettori di Office 365 e i webhook in ingresso basati su connettori in Teams sono stati ritirati a maggio 2026. Questa guida spiega cosa ha smesso di funzionare, cosa lo sostituisce, come effettuare la migrazione e dove i flussi di lavoro presentano ancora differenze.

Tradotto automaticamente con l'IA dal post originale. Leggi l'originale in inglese

I connettori di Teams, incluso il connettore Incoming Webhook, non esistono più. Microsoft Learn afferma che i connettori di Office 365 in Teams sono stati ritirati a maggio 2026 e che il modo per ricevere richieste webhook e pubblicare in Teams è ora l'app Flussi di lavoro. Un flusso di lavoro creato con il trigger Quando viene ricevuta una richiesta webhook di Teams sostituisce il vecchio URL del connettore.

Punti chiave

  • Secondo Microsoft Learn, i connettori di Office 365 in Teams, compresi i webhook in ingresso basati su connettori, sono stati ritirati a maggio 2026. La finestra di distribuzione finale indicata nel blog per sviluppatori va dal 18 al 22 maggio 2026.
  • La sostituzione è l'app Workflows in Teams, cioè Power Automate. Usa il trigger "When a Teams webhook request is received" oppure un modello già pronto.
  • Un flusso di lavoro ha un proprio URL webhook, quindi ogni sistema che invia richieste deve essere aggiornato, perché il vecchio URL del connettore non funziona più.
  • I payload MessageCard vengono visualizzati, ma i relativi pulsanti HttpPost no. Per i contenuti interattivi usa le Schede adattive.
  • I flussi di lavoro appartengono a un proprietario, non a un canale. Aggiungi dei comproprietari, così il flusso non resta senza gestione quando il proprietario lascia l'organizzazione.

Questo articolo spiega cosa è stato ritirato, cosa lo sostituisce, come effettuare il passaggio e quali differenze possono ancora creare problemi.

Cosa è stato ritirato e quando

Il ritiro è durato quasi due anni e la data è stata spostata più volte. Il blog per sviluppatori di Microsoft 365 documenta la sequenza:

  • Luglio 2024: primo piano che prevedeva il blocco dei nuovi connettori dal 15 agosto 2024 e l'interruzione di tutti i connettori dal 1° ottobre 2024.
  • Luglio 2024: ritiro posticipato a dicembre 2025.
  • Ottobre 2025: scadenza della migrazione spostata al 31 marzo 2026.
  • Febbraio 2026: aggiunto il supporto per Message Card in Flussi di lavoro e il bot di Flussi di lavoro può pubblicare nei canali condivisi. La scadenza è stata spostata al 30 aprile 2026.
  • 14 aprile 2026 (aggiornamento finale): la distribuzione inizia il 18 maggio 2026 e si completa il 22 maggio 2026. Dopo tale data i connettori non funzionano più.

Gli elementi interessati sono i connettori di Office 365 in Teams, inclusi i connettori basati su webhook come Incoming Webhook e i connettori di terze parti che pubblicano su un URL. Il blog precisa che la modifica dell'URL webhook riguarda i connettori basati su webhook, non i connettori basati su polling come RSS.

Se qualcosa pubblica ancora tramite un vecchio connettore, consideralo non funzionante o prossimo a smettere di funzionare e pianifica subito la migrazione.

Cosa sostituisce i connettori

Microsoft indica tre percorsi su Learn:

  1. App Flussi di lavoro (Power Automate) per i webhook in ingresso. Usa un modello predefinito oppure il trigger Quando viene ricevuta una richiesta webhook di Teams.
  2. Il connettore di Power Automate per gli ISV e i team di prodotto. Learn lo definisce il modo scalabile e sicuro per spostare dati da e verso Teams in modo programmatico.
  3. Un'app Teams con messaggi proattivi, così gli utenti possono configurare messaggi basati su eventi di trigger del tuo sistema.

Per la maggior parte degli amministratori e degli scripter, il percorso 1 è la sostituzione diretta.

Come migrare un webhook a Workflows

Al momento della preparazione di questo articolo non è stato possibile leggere la pagina di supporto Microsoft sui webhook in ingresso, quindi i passaggi seguenti si basano sul blog per sviluppatori e sul riferimento del connettore di Learn.

  1. Elenca tutti i connettori in uso. Controlla i canali che hanno usato Gestisci canale > Connettori e i sistemi che inviano avvisi, come strumenti di monitoraggio, build o ticketing.
  2. In Teams, apri l'app Workflows. Il blog per sviluppatori indica che puoi aprirla anche da una chat o da un canale tramite Altre opzioni (...).
  3. Scegli un modello di webhook predefinito oppure parti da zero con il trigger Quando viene ricevuta una richiesta webhook di Teams.
  4. Scegli il team e il canale, quindi salva e copia l'URL del trigger dal flusso in Power Automate.
  5. Sostituisci nel sistema di invio il vecchio URL del connettore con il nuovo.
  6. Assegna un nome e una descrizione al flusso, testalo e aggiungi i co-proprietari.
  7. Invia una richiesta POST di prova e verifica che il messaggio venga visualizzato.

Il trigger accetta solo richieste POST. Il riferimento del connettore di Learn indica che le richieste GET non sono supportate.

Formato del payload e schede

Il corpo del trigger può contenere un array di schede adattive. Il riferimento mostra un messaggio con un array attachments il cui contentType è application/vnd.microsoft.card.adaptive. Viene accettato anche un singolo corpo di Message Card.

Tieni presenti questi punti:

  • Le schede adattive sono il modo supportato per creare contenuti interattivi.
  • I payload MessageCard vengono visualizzati, ma i pulsanti che usano HttpPost non funzionano. Il blog per sviluppatori consiglia di passare alle schede adattive se utilizzi elementi interattivi.

Controllo degli accessi

Un miglioramento concreto: il trigger ha un'impostazione di autenticazione. Learn elenca tre opzioni.

| Impostazione | Cosa deve fare il mittente | |---|---| | Chiunque | Non inviare l'intestazione del token di autenticazione, altrimenti la richiesta non va a buon fine | | Qualsiasi utente del mio tenant | Invia un token di autenticazione | | Utenti specifici del mio tenant | Invia un token di autenticazione, e l'utente deve essere nell'elenco dei consentiti |

Per le opzioni del tenant, Learn rimanda alla sua guida sull'autenticazione OAuth per i trigger di richieste HTTP. Se uno strumento può solo inviare una semplice POST a un URL, ha bisogno dell'impostazione Chiunque. In quel caso, tratta l'URL come un segreto.

Differenze rispetto al connettore precedente

Tienine conto prima di passare al nuovo sistema.

  • Identità del mittente. L'aggiornamento del blog per sviluppatori di aprile 2026 indica che la personalizzazione di icona e nome del bot non è disponibile per i post dei webhook. I messaggi mostrano l'identità bot predefinita di Workflows.
  • Proprietà. Learn spiega che i flussi sono associati ai proprietari, non a un team o a un canale. Se il proprietario lascia l'organizzazione e non esiste un co-proprietario, il flusso può restare orfano. Aggiungi co-proprietari con controllo completo.
  • Limiti. Il riferimento di Learn indica circa 1.000 chiamate in ingresso simultanee per il trigger e un limite di 28 KB per l'azione Pubblica scheda adattiva in una chat o in un canale. Payload più grandi restituiscono l'errore «Request Entity too large».
  • Canali privati. Le fonti non concordano. Il blog per sviluppatori afferma che la selezione dei canali privati nell'app Workflows doveva essere completamente disponibile entro il 20 aprile 2026; una pagina di Learn indica che i webhook di Workflows supportano i canali privati, mentre un'altra pagina di Learn definisce il supporto ai canali privati in fase di sviluppo. Il riferimento del connettore Microsoft Teams afferma ancora che la pubblicazione di un messaggio o di una scheda in un canale privato non è attualmente supportata. Prova il canale di destinazione prima di farvi affidamento.

Errori comuni

  • Migrare solo il canale dimenticando di cambiare l'URL nel sistema di invio.
  • Lasciare una sola persona come unico proprietario del flusso.
  • Inviare un token a un trigger impostato su Chiunque.
  • Mantenere i pulsanti dei MessageCard aspettandosi che i callback funzionino.
  • Dare per scontato che il vecchio nome e l'icona del bot vengano mantenuti.

Correlati

Fonti

Segui il podcastApple PodcastsSpotify

FAQ

I connettori di Teams funzionano ancora?

No. Microsoft Learn afferma che i connettori di Office 365 in Teams, compresi i webhook in ingresso basati su connettori, sono stati ritirati a maggio 2026. Il blog per sviluppatori di Microsoft 365 indica come ultima finestra di distribuzione il periodo dal 18 al 22 maggio 2026 e precisa che i webhook dovevano essere migrati prima del suo inizio.

Cosa sostituisce il connettore Incoming Webhook in Teams?

L'app Workflows, che gira su Power Automate. Secondo Microsoft Learn puoi scegliere un modello predefinito che pubblica in una chat o in un canale quando viene ricevuta una richiesta webhook, oppure creare un flusso da zero con il trigger "When a Teams webhook request is received".

Mi serve un nuovo URL per lo strumento di monitoraggio o lo script?

Sì. Un flusso di lavoro ha un proprio URL di trigger e la documentazione dei connettori descrive il trigger come avviato da una richiesta POST a tale endpoint. Le pagine che ho consultato non indicano dove viene visualizzato l'URL, quindi apri il trigger del flusso di lavoro in Power Automate per copiarlo. Incollalo nel sistema che invia la richiesta POST.

Il webhook dei flussi di lavoro può pubblicare pulsanti che richiamano il mio sistema?

Non con MessageCard. Il blog per sviluppatori spiega che MessageCard visualizza i contenuti ma non supporta i pulsanti di azione HttpPost. Per gli elementi interattivi Microsoft consiglia le Schede adattive e Learn precisa che devi configurare il flusso di lavoro per gestire le risposte.

Chi può inviare richieste al webhook di un flusso di lavoro?

Decidi tu. La documentazione del connettore Microsoft Teams su Learn elenca tre opzioni: chiunque, qualsiasi utente del tenant oppure utenti specifici del tenant. Per le opzioni riservate al tenant, le richieste devono includere un token di autenticazione. Per l'opzione Chiunque, non devi inviarlo.

Entità in questo articolo

Temi di questo articolo:

Microsoft Teams – Strumento di collaborazione di Microsoft Power Automate – Strumento low-code di Microsoft Connettore – Concetto Adaptive Cards – Prodotto

Articoli correlati

Altri articoli su Microsoft Teams:

RSS