Collegare Microsoft Teams: guida passo passo
Pubblica il riepilogo dell'esecuzione in un canale Teams e, con NEXUS_TEAMS_NOTIFY=true, un messaggio per ogni test non superato. Questa guida ti accompagna da zero fino alla verifica della connessione ed elenca gli errori che potresti incontrare con le relative cause e soluzioni.
Ultimo aggiornamento:
Mantieni riservate le tue credenziali. Non incollare mai token, chiavi, password o URL di webhook in una chat. Inseriscili solo in Studio → Impostazioni → Integrazioni, dove vengono salvati nel file .env del tuo spazio di lavoro e visualizzati come puntini. Lo stesso vale per un assistente IA: può accompagnarti lungo questa guida, ma non ha mai bisogno del tuo token.
Cosa serve
- Un canale Teams in cui puoi aggiungere un flusso di lavoro.
- Un URL webhook di Workflows per quel canale.
Ottieni le credenziali
- In Teams, apri il menu ··· del canale → Flussi di lavoro e aggiungi "Pubblica in un canale quando viene ricevuta una richiesta webhook".
- Copia l'URL del webhook fornito. Termina con logic.azure.com (per i connettori precedenti: webhook.office.com). L'URL stesso è il segreto.
- Tienilo negli appunti. Non incollarlo da nessuna parte tranne che nello Studio (passaggio successivo).
Collegalo nello Studio
- In Studio, apri Impostazioni → Integrazioni → Microsoft Teams.
- Incolla l'URL del webhook e premi Salva & invia test. Un messaggio di prova viene inviato al canale.
- Attiva
TEAMS_ENABLED. Per ricevere un messaggio per ogni test non riuscito, attiva ancheNEXUS_TEAMS_NOTIFY.
Verifica che funzioni
- Invia messaggio di prova risponde "Inviato." e il messaggio compare nel canale.
- Esegui un test qualsiasi. Il riepilogo dell'esecuzione arriva nel canale.
Errori comuni
| Cosa vedi | Causa | Soluzione |
|---|---|---|
| "Nessun webhook" | TEAMS_WEBHOOK_URL è vuoto. | Incolla l'URL del webhook in Impostazioni → Integrazioni e salva. |
"TEAMS_WEBHOOK_URL non è un webhook di Teams" | Il valore non è un URL https su logic.azure.com o webhook.office.com. | Copia nuovamente l'URL dal trigger "Pubblica in un canale quando viene ricevuta una richiesta webhook" del flusso di lavoro. |
| Una risposta HTTP 4xx o 5xx da Teams | Il flusso di lavoro è stato disattivato o eliminato, oppure il suo proprietario ha lasciato l'organizzazione o ha perso la licenza, quindi non viene più eseguito. | Apri il flusso di lavoro in Teams (Flussi di lavoro → gestisci), attivalo o creane uno nuovo e salva il nuovo URL. |
| "impossibile raggiungere Teams (ENOTFOUND)" o "nessuna risposta entro 20 s" | Questo PC non riesce a raggiungere Microsoft: una VPN o un proxy impedisce la connessione, oppure la rete non è disponibile. | Controlla la connessione di rete dallo stesso PC e riprova. |
| Il test funziona ma i test non superati non vengono segnalati | TEAMS_ENABLED è false, oppure è attivo solo il riepilogo dell'esecuzione: i messaggi per singolo test richiedono NEXUS_TEAMS_NOTIFY=true. | Attiva entrambi gli interruttori. |
Chiavi di configurazione
| Chiave | Cosa fa | Valore valido | Come verificarlo |
|---|---|---|---|
TEAMS_ENABLED | Invia avvisi a Microsoft Teams | true o false | Attiva dopo l'arrivo del messaggio di prova. |
TEAMS_WEBHOOK_URL | Canale Teams per le notifiche (segreto, salvato solo su questo computer) | Un URL https://…logic.azure.com o …webhook.office.com | Invia messaggio di prova pubblica un messaggio nel canale. |
NEXUS_TEAMS_NOTIFY | Avviso su Teams per ogni errore | true o false | Arriva un messaggio per ogni test non superato, non solo il riepilogo dell'esecuzione. |
Approfondimenti: tutte le integrazioni, la guida alle impostazioni, risoluzione dei problemi. Altre guide: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
Non riesci ancora a risolvere? Scrivi a [email protected] riportando l'esatta riga di errore mostrata da Studio. Non includere token.