Collega Slack: guida passo passo
Pubblica il riepilogo dell'esecuzione in un canale e, con NEXUS_SLACK_NOTIFY=true, un messaggio per ogni test non superato, instabile, di caos o di regressione visiva. Un messaggio relativo a un errore contiene il collegamento al ticket Jira corrispondente, se esiste. 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'area di lavoro Slack in cui puoi aggiungere un'app.
- Un URL Incoming Webhook per il canale che deve ricevere i messaggi.
Ottieni le credenziali
- In Slack, crea un'app con un webhook in ingresso (https://api.slack.com/messaging/webhooks) e scegli il canale.
- Copia l'URL del webhook. Inizia con https://hooks.slack.com/services/. 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 → Slack.
- Incolla l'URL del webhook e premi Salva & invia test. Un messaggio di prova viene inviato al canale.
- Attiva
SLACK_ENABLED. Per ricevere un messaggio per ogni test non superato, attiva ancheNEXUS_SLACK_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" | SLACK_WEBHOOK_URL è vuoto. | Incolla l'URL del webhook in Impostazioni → Integrazioni e salva. |
"SLACK_WEBHOOK_URL non è un webhook in ingresso di Slack" | Il valore non inizia con https://hooks.slack.com/services/. | Copia di nuovo l'URL del webhook dalla pagina dei webhook in ingresso della tua app Slack. |
| HTTP 404 "no_service" o HTTP 403 "invalid_token" | Il webhook è stato revocato o eliminato, oppure l'app è stata rimossa dall'area di lavoro. | Crea un nuovo webhook in ingresso e salva il nuovo URL. |
| HTTP 404 "channel_not_found" o HTTP 410 "channel_is_archived" | Il canale in cui il webhook pubblica i messaggi è stato eliminato o archiviato. | Crea un nuovo webhook per un canale attivo. |
| "impossibile raggiungere Slack (ENOTFOUND)" o "nessuna risposta entro 20 s" | Questo PC non riesce a raggiungere Slack: una VPN o un proxy, oppure una connessione di rete assente. | Controlla la connessione di rete dallo stesso PC e riprova. |
| Il test funziona ma i test non superati non vengono segnalati | SLACK_ENABLED è false, oppure è attivo solo il riepilogo dell'esecuzione: i messaggi per i singoli test richiedono NEXUS_SLACK_NOTIFY=true. | Attiva entrambi gli interruttori. |
Chiavi di configurazione
| Chiave | Cosa fa | Valore valido | Come verificarlo |
|---|---|---|---|
SLACK_ENABLED | Invia avvisi a Slack | true o false | Attiva dopo l'arrivo del messaggio di prova. |
SLACK_WEBHOOK_URL | Canale Slack per gli avvisi (segreto, salvato solo su questo computer) | https://hooks.slack.com/services/… (non sono accettati altri valori) | Invia messaggio di prova pubblica un messaggio nel canale. |
NEXUS_SLACK_NOTIFY | Avviso Slack per ogni test non superato | 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, Microsoft Teams, Telegram, GitHub Issues.
Non riesci ancora a risolvere? Scrivi a [email protected] riportando l'esatta riga di errore mostrata da Studio. Non includere token.