Slack
Prerequisiti
- Un workspace Slack in cui puoi installare app.
- Permessi di amministratore o di gestione app in quel workspace.
1. Crea un’app Slack
- Apri api.slack.com/apps → Create New App → From scratch.
- Assegna un nome (ad es.
isthisthing.online Alerts) e scegli il tuo workspace.
2. Abilita Incoming Webhooks
- Nella barra laterale delle impostazioni dell’app fai clic su Incoming Webhooks.
- Imposta Activate Incoming Webhooks su On.
- Fai clic su Add New Webhook to Workspace.
- Scegli il canale di destinazione (ad es.
#incidents) → Allow.
Riceverai un URL simile a:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
Copia questo URL — ti servirà al passo successivo.
3. Aggiungi l’integrazione in isthisthing.online
- Vai su Integrations → New Integration.
- Seleziona Slack come tipo.
- Compila i campi:
| Field | Value |
|---|---|
| Name | Un’etichetta descrittiva, ad es. Slack #incidents |
| Webhook URL | L’URL del passo 2 |
| Channel | Lascia vuoto (il webhook pubblica nel canale che hai selezionato) |
- Abilita gli eventi di attivazione necessari (creato / risolto / aggiornato).
- Fai clic su Save.
4. Test
Fai clic sull’icona Test accanto all’integrazione nell’elenco. Entro pochi secondi dovrebbe comparire un messaggio di prova nel canale Slack.
Contenuto del messaggio
| Field | Description |
|---|---|
| Event & Status | CREATED, RESOLVED o UPDATED con lo stato attuale dell’Incident |
| Workspace & Monitor | Nomi e ID per riferimento rapido |
| Timestamps | Orari di inizio, risoluzione ed emissione in UTC |
| Links | Pulsanti per aprire l’Incident o il Dashboard del Workspace |
Risoluzione dei problemi
| Problem | Solution |
|---|---|
| Nessun messaggio ricevuto | Verifica che l’integrazione sia enabled e che almeno un evento di attivazione sia attivo. Controlla che l’URL del webhook sia ancora valido in Slack. |
Errore invalid_blocks | Rigenera il webhook in Slack e aggiorna l’URL nelle impostazioni dell’integrazione. |
| Canale errato | Gli Incoming Webhooks pubblicano nel canale scelto in fase di creazione. Crea un nuovo webhook per un altro canale. |
Sicurezza
- Tratta gli URL dei webhook come segreti — non committarli nel codice sorgente.
- Ruota l’URL immediatamente se viene esposto.
- Limita la gestione delle integrazioni agli Owner e agli Admin del Workspace.