Bots, Webhooks und Mnemo
Ein Bot bekommt genau den Zugriff, den ein Admin ihm gibt.
Bot-Konten
Ein Bot ist ein Konto ohne Anmeldung. Er liest und schreibt über die REST-API, empfängt Ereignisse über ein WebSocket-Gateway und weist sich mit Authorization: Bot <token> aus. Seine Nachrichten tragen das Kennzeichen BOT.
- Bots haben Rollen wie Mitglieder und sehen deshalb nur die Kanäle, die du freigibst.
- Nur der Owner und Mitglieder mit Bots verwalten legen Bots an, und niemand kann einem Bot mehr Rechte geben, als er selbst hat. Bots können keine Rollen, Bots, Webhooks oder Mitglieder verwalten.
- Bots können eigene Slash-Befehle anmelden, aber keine Direktnachrichten sehen.
Die REST- und Gateway-Referenz steht in der Entwickler-Doku (englisch), das Design in doc/bot-platform.md.
Offizielle SDKs
Beide SDKs werden bei jeder Änderung gegen den Server getestet und decken REST-API, Gateway, Slash-Befehle, Knöpfe und Modals ab.
- TypeScript für Node.js ab 24, unter MIT-Lizenz und ohne Laufzeit-Abhängigkeiten:
npm install @mnema-xyz/bot-sdk(Anleitung, englisch). - Go für Go ab 1.26, Paketname
mnema(Anleitung, englisch).
go get github.com/mnema-xyz/bot-sdk-go@latest
Beispiel: Ein Bot mit Slash-Befehl
Ein Bot, der /roll anmeldet und mit einer Zufallszahl antwortet.
TypeScript:
import { Client, OptionType } from '@mnema-xyz/bot-sdk';
const client = new Client({
baseUrl: process.env.MNEMA_URL ?? '',
token: process.env.MNEMA_TOKEN ?? '',
intents: 0,
});
client.on('ready', () =>
client.commands.set([
{
name: 'roll',
description: 'Rolls a die',
options: [{ name: 'sides', description: 'How many sides', type: OptionType.Integer, required: true }],
},
])
);
client.on('interactionCreate', async (i) => {
if (!i.isCommand() || i.commandName !== 'roll') return;
await i.deferReply();
const sides = Number(i.options.get('sides'));
const result = 1 + Math.floor(Math.random() * sides);
await i.editReply(`${i.user.display_name} rolled **${result}** (d${sides})`);
});
await client.connect();
Go:
c, err := mnema.New(mnema.Options{
BaseURL: os.Getenv("MNEMA_URL"),
Token: os.Getenv("MNEMA_TOKEN"),
})
if err != nil {
log.Fatal(err)
}
c.REST.SetCommands(ctx, []mnema.CommandInput{{
Name: "roll", Description: "Rolls dice",
Options: []mnema.CommandOption{{Name: "sides", Description: "Sides of each die", Type: mnema.OptionInteger, Required: true}},
}})
c.OnInteraction(func(ctx context.Context, i *mnema.Interaction) {
if i.CommandName() != "roll" {
return
}
i.DeferReply(ctx, false)
sides := i.Option("sides").Int()
n := rand.Int64N(sides) + 1
text := fmt.Sprintf("%s rolled **%d** (d%d)", i.User.DisplayName, n, sides)
i.EditReply(ctx, mnema.Edit{Content: &text})
})
c.Run(ctx)
Einen fremden Bot hinzufügen
Ein Bot kann sich in einem Manifest beschreiben. Öffne den Hinzufügen-Link des Bots oder füge das Manifest unter Admin-Konsole > Bots > Aus Manifest hinzufügen ein. Du siehst, was der Bot verlangt, wählst seine Kanäle und bestätigst.
Webhooks
Eingehende Webhooks verstehen das verbreitete Execute-Format, deshalb funktionieren die meisten Integrationen für CI, Monitoring oder Feeds mit dem Einfügen der URL. Ausgehende Webhooks schicken signierte Ereignisse an deinen Dienst, mit Wiederholungen und Zustellprotokoll. Siehe doc/webhooks.md (englisch).
Mnemo
Mnemo ist ein Beispiel-Bot auf Basis des TypeScript-SDK. Er antwortet mit einem KI-Modell, wenn du ihn erwähnst oder /ask nutzt, und kann Wetter abfragen, rechnen oder in der Wikipedia nachsehen. Du betreibst ihn selbst, mit dem API-Schlüssel eines Anbieters oder einem lokalen Modell.
Er braucht Mnema Talk 3.1.0 oder neuer. Die Einrichtung dauert etwa fünf Minuten.
Mnema Talk selbst hat außer der Rauschunterdrückung keine KI-Funktionen. Mnemo ist ein eigenes Programm und sieht nur die Kanäle, die du ihm gibst.