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).
Das Go-SDK
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.

Stimmt etwas auf dieser Seite nicht? Sag es uns.