Microsoft Teams koppelen: stapsgewijze handleiding
Plaatst de samenvatting van de uitvoering in een Teams-kanaal, en met NEXUS_TEAMS_NOTIFY=true één bericht per mislukte test. Deze handleiding begeleidt je vanaf 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 Teams-kanaal waaraan je een werkstroom kunt toevoegen.
- Eén webhook-URL van Workflows voor dat kanaal.
De toegangsgegevens verkrijgen
- Open in Teams het menu ··· van het kanaal → Werkstromen en voeg "Een bericht plaatsen in een kanaal wanneer een webhookaanvraag wordt ontvangen" toe.
- Kopieer de webhook-URL die je krijgt. Deze eindigt op logic.azure.com (oudere connectors: webhook.office.com). 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 de Studio Instellingen → Integraties → Microsoft Teams.
- Plak de webhook-URL en druk op Opslaan & testbericht verzenden. Er wordt een testbericht naar het kanaal verzonden.
- Schakel
TEAMS_ENABLEDin. Schakel voor één bericht per mislukte test ookNEXUS_TEAMS_NOTIFYin.
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" | TEAMS_WEBHOOK_URL is leeg. | Plak de webhook-URL in Instellingen → Integraties en sla deze op. |
"TEAMS_WEBHOOK_URL is geen Teams-webhook" | De waarde is geen https-URL op logic.azure.com of webhook.office.com. | Kopieer de URL opnieuw uit de trigger "Een bericht plaatsen in een kanaal wanneer een webhookaanvraag wordt ontvangen" van de werkstroom. |
| Een HTTP 4xx- of 5xx-antwoord van Teams | De werkstroom is uitgeschakeld of verwijderd, of de eigenaar is vertrokken of heeft geen licentie meer, waardoor de werkstroom niet meer wordt uitgevoerd. | Open de werkstroom in Teams (Werkstromen → beheren), schakel deze in of maak een nieuwe en sla de nieuwe URL op. |
| "kon Teams niet bereiken (ENOTFOUND)" of "antwoordde niet binnen 20 s" | Deze pc kan Microsoft 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 | TEAMS_ENABLED is false, of alleen de uitvoeringssamenvatting is ingeschakeld: voor berichten per test is NEXUS_TEAMS_NOTIFY=true nodig. | Zet beide schakelaars aan. |
Instellingssleutels
| Sleutel | Wat het doet | Geldige waarde | Zo controleert u dit |
|---|---|---|---|
TEAMS_ENABLED | Meldingen naar Microsoft Teams sturen | true of false | Schakel dit in nadat het testbericht is aangekomen. |
TEAMS_WEBHOOK_URL | Teams-kanaal voor meldingen (geheim, alleen op deze computer opgeslagen) | Een URL met https://…logic.azure.com of …webhook.office.com | Testbericht verzenden plaatst een bericht in het kanaal. |
NEXUS_TEAMS_NOTIFY | Teams-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, Slack, 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.