Come impostare una webhook di Teams per notifiche automatiche

Un webhook di Teams è un indirizzo web che riceve un messaggio da uno script, da un sistema di monitoraggio o da un’applicazione e lo pubblica in un canale. Il vecchio connettore “Webhook in ingresso” non esiste più: Microsoft ha ritirato i connettori di Office 365 in Teams, con la disattivazione completata a maggio 2026. Oggi il webhook si crea con l’app Flussi di lavoro (Workflows), basata su Power Automate. Questa guida crea il webhook, lo prova, spiega i limiti e come non farlo smettere di funzionare quando chi l’ha creato lascia l’azienda.

Prerequisiti: un team e un canale per le notifiche (meglio uno dedicato, per esempio “Avvisi IT”); un account che sia membro del team e abbia una licenza con Power Automate standard (inclusa in Microsoft 365); i criteri di Teams che consentono l’app Flussi di lavoro.

1. Crea il flusso dal canale

  1. In Teams, sul canale, apri il menu … e scegli Flussi di lavoro.
  2. Scegli il modello Pubblica in un canale quando viene ricevuta una richiesta webhook (in inglese Post to a channel when a webhook request is received).
  3. Dai un nome al flusso (per esempio “Avvisi backup”), conferma team e canale e crea.
  4. Copia l’URL che viene mostrato alla fine.

L’URL è un segreto: chiunque lo conosca può pubblicare nel canale. Non scriverlo negli script né nei repository; salvalo come credenziale, come spiegato in come gestire le credenziali in modo sicuro negli script.

2. Invia un messaggio di prova

Il flusso si aspetta una Adaptive Card dentro un elenco di allegati:

$url = 'https://...'   # URL del flusso, letto da un archivio sicuro
$scheda = @{
    type    = 'message'
    attachments = @(@{
        contentType = 'application/vnd.microsoft.card.adaptive'
        content     = @{
            '$schema' = 'http://adaptivecards.io/schemas/adaptive-card.json'
            type      = 'AdaptiveCard'
            version   = '1.4'
            body      = @(
                @{ type = 'TextBlock'; text = 'Backup notturno non riuscito'; weight = 'Bolder'; size = 'Medium' }
                @{ type = 'TextBlock'; text = "Server SRV-FILE01 - $(Get-Date -Format 'dd/MM/yyyy HH:mm')"; wrap = $true }
            )
        }
    })
}
Invoke-RestMethod -Uri $url -Method Post -ContentType 'application/json; charset=utf-8' `
    -Body ([Text.Encoding]::UTF8.GetBytes(($scheda | ConvertTo-Json -Depth 10)))

La conversione in UTF-8 evita che le lettere accentate arrivino rovinate. Il flusso risponde con il codice 202: il messaggio compare nel canale dopo qualche secondo.

3. Migra i vecchi webhook

Gli script che usavano il connettore vanno aggiornati con il nuovo URL. I messaggi nel vecchio formato MessageCard vengono ancora accettati dai flussi, ma senza pulsanti; per le schede interattive serve una Adaptive Card. Cerca negli script gli indirizzi dei vecchi connettori (contengono webhook.office.com) e sostituiscili.

4. Limiti da conoscere

  • I messaggi vengono pubblicati dall’identità dell’app Flussi di lavoro: non si possono personalizzare nome e icona del mittente.
  • Il flusso appartiene all’utente che l’ha creato. Se il suo account viene disattivato, il flusso si ferma. Aggiungi un comproprietario in Power Automate (I miei flussi > Condivisione) o crealo con un account di servizio con licenza.
  • I canali privati e condivisi sono supportati; per i canali privati il flusso si crea dal portale di Power Automate.
  • Ogni esecuzione conta nei limiti di richieste di Power Automate: per avvisi molto frequenti raggruppa i messaggi invece di inviarne uno al secondo.

5. Controlla le esecuzioni

Su make.powerautomate.com, in I miei flussi, apri il flusso e guarda la Cronologia esecuzioni: un’esecuzione fallita mostra quale passaggio non ha funzionato, per esempio una scheda con un campo non valido.

Verifica finale: lo script di prova riceve risposta senza errori, il messaggio compare nel canale con le lettere accentate corrette, la cronologia del flusso mostra l’esecuzione riuscita e il flusso ha almeno due proprietari. Per integrare l’invio nei tuoi script vedi come configurare un webhook per Microsoft Teams da uno script; uno script pronto è notifica su Teams per eventi critici rilevati.

Approfondisci

Guide correlate

Script PowerShell pronti all'uso

Per capire i concetti

Privacy Policy Cookie Policy