Slack koppelen: stapsgewijze handleiding
Plaatst de samenvatting van de uitvoering in een kanaal, en met NEXUS_SLACK_NOTIFY=true één bericht per mislukte, instabiele, chaos- of visuele-regressietest. Een bericht over een fout bevat een link naar het bijbehorende Jira-ticket als dat bestaat. Deze handleiding begeleidt je van het begin tot een gecontroleerde verbinding en vermeldt de fouten die je kunt tegenkomen met hun oorzaak en oplossing.
Laatst bijgewerkt:
Houd je toegangsgegevens privé. Plak nooit een token, sleutel, wachtwoord of webhook-URL in een chat. Voer deze alleen in via Studio → Instellingen → Integraties, waar ze worden opgeslagen in het .env-bestand van je werkruimte en als stippen worden weergegeven. Hetzelfde geldt voor een AI-assistent: die kan je door deze handleiding leiden, maar heeft je token nooit nodig.
Wat je nodig hebt
- Een Slack-werkruimte waarin je een app kunt toevoegen.
- Eén URL voor een inkomende webhook voor het kanaal dat de berichten moet ontvangen.
De toegangsgegevens verkrijgen
- Maak in Slack een app met een inkomende webhook (https://api.slack.com/messaging/webhooks) en kies het kanaal.
- Kopieer de webhook-URL. Deze begint met https://hooks.slack.com/services/. De URL zelf is de geheime sleutel.
- Bewaar het op je klembord. Plak het nergens anders dan in de Studio (volgende stap).
Koppelen in de Studio
- Open in Studio Instellingen → Integraties → Slack.
- Plak de webhook-URL en druk op Opslaan & testbericht verzenden. Er wordt een testbericht naar het kanaal verzonden.
- Schakel
SLACK_ENABLEDin. Schakel ookNEXUS_SLACK_NOTIFYin voor één bericht per mislukte test.
Controleren of het werkt
- Testbericht verzenden geeft als antwoord "Verzonden." en het bericht verschijnt in het kanaal.
- Voer een willekeurige test uit. De samenvatting van de uitvoering verschijnt in het kanaal.
Veelvoorkomende fouten
| Wat je ziet | Oorzaak | Oplossing |
|---|---|---|
| "Geen webhook" | SLACK_WEBHOOK_URL is leeg. | Plak de webhook-URL in Instellingen → Integraties en sla deze op. |
"SLACK_WEBHOOK_URL is geen inkomende Slack-webhook" | De waarde begint niet met https://hooks.slack.com/services/. | Kopieer de webhook-URL opnieuw vanaf de pagina Incoming Webhooks van je Slack-app. |
| HTTP 404 "no_service" of HTTP 403 "invalid_token" | De webhook is ingetrokken of verwijderd, of de app is uit de werkruimte verwijderd. | Maak een nieuwe inkomende webhook en sla de nieuwe URL op. |
| HTTP 404 "channel_not_found" of HTTP 410 "channel_is_archived" | Het kanaal waarin de webhook berichten plaatst, is verwijderd of gearchiveerd. | Maak een nieuwe webhook voor een actief kanaal. |
| "kon Slack niet bereiken (ENOTFOUND)" of "antwoordde niet binnen 20 s" | Deze pc kan Slack niet bereiken: door een VPN of proxy, of doordat er geen netwerkverbinding is. | Controleer het netwerk vanaf dezelfde pc en probeer het opnieuw. |
| De test werkt, maar mislukte tests worden niet gemeld | SLACK_ENABLED staat op false, of alleen de samenvatting van de uitvoering is ingeschakeld: berichten per test vereisen NEXUS_SLACK_NOTIFY=true. | Zet beide schakelaars aan. |
Instellingssleutels
| Sleutel | Wat het doet | Geldige waarde | Zo controleert u dit |
|---|---|---|---|
SLACK_ENABLED | Meldingen naar Slack verzenden | true of false | Schakel dit in nadat het testbericht is aangekomen. |
SLACK_WEBHOOK_URL | Slack-kanaal voor meldingen (geheim, alleen op deze computer opgeslagen) | https://hooks.slack.com/services/… (niets anders wordt geaccepteerd) | Testbericht verzenden plaatst een bericht in het kanaal. |
NEXUS_SLACK_NOTIFY | Slack-melding per mislukte test | true of false | Er verschijnt één bericht per mislukte test, niet alleen de samenvatting van de uitvoering. |
Meer: alle integraties, de instellingenhandleiding, problemen oplossen. Andere handleidingen: Jira Cloud, Azure Boards, Microsoft Teams, Telegram, GitHub Issues.
Kom je er nog steeds niet uit? Mail naar [email protected] met de exacte foutregel die Studio toont. Stuur geen token mee.