Een inkomende webhook instellen in Microsoft Teams en integreren met Guardey

Microsoft Teams inkomende webhooks begrijpen

Een inkomende webhook is een type connector in Microsoft Teams waarmee externe diensten zoals Guardey geautomatiseerde berichten en meldingen naar een specifiek Teams-kanaal kunnen sturen.

Soorten meldingen

Eenmaal ingesteld, zal deze webhook meldingen in het Teams-kanaal geven wanneer er een nieuwe uitdaging beschikbaar is in Guardey. Deze meldingen worden automatisch verstuurd door het Guardey-systeem en vereisen geen handmatige tussenkomst.

Frequentie van meldingen

De frequentie van meldingen is configureerbaar in je Guardey-omgeving. Je kunt instellen hoe vaak je meldingen wilt ontvangen (via e-mail en/of Teams) met de volgende opties: geen, wekelijks, eens in de twee weken, eens in de drie weken, eens in de vier weken. Nieuwe uitdagingen worden altijd wekelijks uitgebracht, en dit releaseschema kan niet worden gewijzigd.

Relatie tot wekelijkse e-mails

Hoewel de webhook-meldingen tijdige updates over nieuwe uitdagingen bieden, dienen ze momenteel als aanvulling op de wekelijkse e-mail in plaats van als vervanging. De wekelijkse e-mail kan aanvullende informatie bevatten die niet in de webhook-meldingen is opgenomen.

Microsoft Teams webhook installatieproces

Stap 1: Open Microsoft Teams, navigeer naar het kanaal waar je meldingen wilt ontvangen.

Stap 2: Klik op de drie puntjes naast de kanaalnaam, selecteer connectors of voeg een nieuw tabblad toe in het kanaal en een nieuwe app. Afhankelijk van je MS Teams-versie.

Stap 3: Zoek naar inkomende Webhook, klik op toevoegen, en vervolgens op configureren.

Stap 4: Geef je webhook een naam en upload eventueel het Guardey-logo om deze te representeren. Na configuratie ontvang je een unieke URL. Kopieer deze URL; je hebt deze nodig voor integratie met Guardey.

Guardey integratiestappen

Stap 1: Log in op het adminportaal.

Stap 2: Selecteer gebruikers en vervolgens groepen.

Stap 3: Kies de groep die je wilt configureren en klik op instellingen, selecteer vervolgens geavanceerd.

Stap 4: Voer in de geavanceerde instellingen de Webhook URL in die je van Microsoft Teams hebt ontvangen.

Eén Webhook gebruiken voor meerdere groepen

Je kunt dezelfde webhook URL gebruiken voor meerdere groepen in Guardey, maar dit is niet nodig als je je vereiste Teams-kanaal al hebt toegevoegd. De meldingen worden echter naar hetzelfde Teams-kanaal gestuurd. Voor verschillende kanalen moet je afzonderlijke webhooks aanmaken.

Webhook beveiliging

Webhooks zijn over het algemeen veilig omdat ze alleen eenrichtingscommunicatie van Guardey naar je Microsoft Teams-kanaal toestaan. Het is echter belangrijk om de webhook URL vertrouwelijk te houden om ongeautoriseerd gebruik te voorkomen.

Webhooks wijzigen

Je kunt de webhook op elk moment bewerken of verwijderen in zowel Microsoft Teams als Guardey. Ga in Teams naar de connectorsinstellingen van het kanaal, en in Guardey naar de geavanceerde instellingen van de groep.

Voor problemen met Guardey-instellingen, neem contact op met Guardey-support via support@guardey.com. Voor problemen met Microsoft Teams, raadpleeg je IT-beheerder.