Denkploeg kan een melding als bericht in een Discord- of Slack-kanaal zetten: een storing, een betaald abonnement, een sprint die klaar is, een goedkeuring die wacht. Je koppelt daarvoor een webhook. Dat kost je een paar minuten en je hebt er geen eigen bot of app voor nodig.
Een webhook maken in Discord
- Open in Discord de Serverinstellingen, dan Integraties, dan Webhooks, en kies Nieuwe webhook.
- Geef hem een naam (bijvoorbeeld Denkploeg) en een plaatje, en kies het kanaal waar de berichten in moeten komen.
- Kies Webhook-URL kopiëren. Die URL is een geheim: wie hem heeft, kan in dat kanaal schrijven. Zet hem niet in een chat of in een document.
Voor Slack maak je een app met Incoming Webhooks en voeg je een webhook toe aan het kanaal. De URL begint met hooks.slack.com.
Koppelen in Denkploeg
- Voor je hele bureau: Berichten aan je klanten, tab Kanalen. Alleen de eigenaar van het bureau koppelt. Alle werkruimtes onder het bureau melden in het kanaal, met de werkruimtenaam in het bericht.
- Voor één werkruimte: Planning Studio, een project, Automations, blok Chatkanalen.
Je plakt de URL, kiest het doel van het kanaal en een meldingsniveau, en vult een code uit je authenticator-app in. Die code geldt vijf minuten, dus koppel meerdere kanalen achter elkaar. De URL staat daarna versleuteld in de kluis en komt nergens meer in beeld.
Daarna kun je per kanaal Stuur testbericht kiezen, of bovenaan Stuur een voorbeeld naar alle kanalen. Je ziet dan hoe elk kanaal er in het echt uitziet.
Welke kanalen je aanmaakt
Een doel heeft hoogstens één kanaal. Je hoeft er niet alle dertien te maken; begin met wat je wilt horen.
| Doel | Voor wat |
|---|---|
| Storingen | een dienst valt om, en het herstel |
| Beveiliging | mislukte aanmeldingen, tweede factor, rollen, tokens, breekglas |
| Uitrol | een nieuwe versie is gestart of geslaagd |
| Kosten en credits | het maandplafond is bijna bereikt, credits zijn bijgevuld |
| Werker en logs | wat de werker deed (stil, om terug te zoeken) |
| Aanmeldingen | een nieuwe proef of klant, een proef die afloopt |
| Orders en betalingen | een betaald abonnement, een factuur die vervalt |
| Support | een nieuw ticket, een assistent die stilstaat |
| Te tekenen | een goedkeuring wacht op jou |
| Activiteit van de ploeg | agents die een taak starten of afronden (stil) |
| Sprint | een sprint is gestart of afgerond |
| Reviews en checks | een pull request wacht op review |
| Voortgang per klant | een mijlpaal of preview is klaar |
Het meldingsniveau is de kleur van de rand: rood vraagt actie, geel waarschuwt, groen is goed nieuws, grijs is stil. Dat helpt in Discord om per kanaal meldingen te dempen of juist altijd aan te laten.
Wat een bericht laat zien
Een titel, een korte uitleg, tot acht velden (bijvoorbeeld werkruimte, bedrag, versie), een regel Volgende stap en een knop Open in Denkploeg. De titel en de knop wijzen naar je eigen portaal. Een bericht kan nooit iemand taggen en bevat geen links naar andere sites.
Veiligheid
- De webhook is een geheim en staat versleuteld in de kluis, nooit in een scherm, een log of een bericht.
- Koppelen en een doel wijzigen vragen een code uit je authenticator-app. Losmaken vraagt die ook.
- Een kanaal krijgt hoogstens tien berichten per minuut.
- Denkploeg stuurt alleen naar de webhook die je zelf koppelde. Een bericht kiest nooit zelf een bestemming.
- Verwijder je de webhook in Discord, dan stopt het kanaal en staat het in Denkploeg op uit, met de reden erbij.
Een eigen bot of de Denkploeg-app
Berichten met knoppen die iets doen, een thread per storing en privéberichten vragen een bot. Die kan Denkploeg zelf voor zijn eigen server gebruiken. Voor klanten bieden we dat nu niet aan: koppel je een webhook, dan krijg je alles hierboven. Wil je later knoppen of threads in je eigen server, laat het ons weten.