Ga naar hoofdinhoud

Een bot maken

Post in een kanaal met een webhook, geef je community eigen slash-commando's en zet knoppen onder de kaarten.

Met drie bouwstenen laat je je eigen service meepraten in je community. Ze werken samen: één koppeling kan een kaart posten, een /commando beantwoorden, op een knop reageren en haar eigen bericht bijwerken.

De bouwstenen

  • Webhooks: een URL die in een kanaal post. Je service stuurt er JSON naartoe en het bericht verschijnt onder de naam die je de webhook gaf. Gemaakt voor meldingen: CI-resultaten, monitoring, tickets.
  • Triggers: de eigen slash-commando's van je community. Een lid typt /weather, mssgs stuurt het bericht naar je webservice, en wat die antwoordt verschijnt als kaart in het kanaal.
  • Knoppen: onder een kaart openen ze een link, veranderen ze de kaart voor iedereen of starten ze een van je triggers (zie Botkaarten & -knoppen).

Je eerste bericht posten

1
Open in de desktop-app bij je community Server beheren → Webhooks en klik op Webhook toevoegen.
2
Geef hem een naam, kies de Kanalen waarin hij mag posten, kopieer het Webhook-secret en klik op Webhook maken.
3
Klik op het linkicoon naast de webhook (Webhook-URL bekijken), kies een Kanaal en kopieer de URL.
4
POST JSON naar die URL, ondertekend met het secret. Het bericht verschijnt meteen in het kanaal.
BODY='{"content": "Build #1847 passed on main"}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$MSSGS_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST "$MSSGS_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Mssgs-Signature: sha256=$SIG" \
  -d "$BODY"
Houd de URL en het secret voor jezelf. Samen laten ze iedereen in dat kanaal posten, dus houd ze uit openbare repositories en uit code die in de browser draait. Een verzoek zonder geldige handtekening wordt geweigerd.

Post je vanuit GitHub? Daar is geen code voor nodig: laat een GitHub-webhook naar de URL wijzen en plak het secret in het veld Secret. Zie integraties.

Een slash-commando toevoegen

1
Open Server beheren → Triggers en klik op Trigger maken.
2
Vul het Woord om te matchen in, zoals /weather, en het URL-eindpunt van je webservice. Onder Toegestane gebruikersgroepen houd je het commando voor bepaalde rollen.
3
Stuurt een lid een bericht dat begint met /weather, dan POST mssgs het naar je URL. Antwoord binnen 5 seconden met JSON en het verschijnt als kaart in het kanaal.

Heb je meer tijd nodig? Antwoord meteen met een laadkaart en maak hem af via de callback_url uit het verzoek, die 30 minuten werkt. De kaart toont de naam van je community, en de voettekst zegt wie welk commando gebruikte.

Een eigen bot

Wil je dat de bot een eigen lid is, met een naam, avatar en BOT-label? Maak een botaccount dat aan je eigen account is gekoppeld, en beheer het vanuit het botdashboard. Is de desktop-app ingelogd als de bot, dan kan een AI-assistent via de MCP-server kaarten met knoppen posten.

Elk veld, elk antwoord en elke foutcode staat in de ontwikkelaarsdocumentatie: webhooks, slash-commando's, berichtkaarten, knoppen en live-updates. En wil je AI-gedrag zonder iets te bouwen, dan is de MCP-route misschien alles wat je nodig hebt.

Was dit artikel nuttig?

Niet gevonden wat je zocht? We helpen je graag verder.

Stel je vraag

Nog hulp nodig?

Ons supportteam reageert meestal binnen 24 uur - gewoon in het Nederlands.

Neem contact op