# Mehrere Dienste in einem Kanal

Mehrere Tools schicken in denselben Kanal, jedes mit eigenem Namen und Schlüssel.

Ein Kanal muss nicht zu genau einem Tool gehören. Dein Kanal „Server“ kann Meldungen vom Uptime-Monitor, vom Backup-Skript und von deiner CI bekommen. Jedes dieser Tools ist ein **Dienst** im Kanal: mit eigenem Namen und eigenem Schlüssel.

## Wann ein Dienst, wann ein eigener Kanal

| | Eigener Kanal | Dienst in einem Kanal |
|---|---|---|
| In der Liste | ein Eintrag pro Tool | ein Eintrag für alle |
| Push, Ton, Ruhezeit | pro Tool einstellbar | gelten für den ganzen Kanal |
| Schlüssel | einer pro Kanal | einer pro Dienst, einzeln entfernbar |
| Gut für | Tools, die nichts miteinander zu tun haben | mehrere Tools zu einem Thema: Server, Shop, Smart Home |

## Dienst hinzufügen

1. Öffne den Kanal und tippe oben auf Avatar oder Namen.
2. Tippe unter **Dienste** auf **Dienst hinzufügen**.
3. Wähle, wie das Tool schickt: über [Slack](https://packlets.app/docs/slack.md), [Discord](https://packlets.app/docs/discord.md), [ntfy](https://packlets.app/docs/ntfy.md) oder mit eigenem Code.
4. Gib dem Dienst einen Namen, zum Beispiel „Uptime Kuma“. Er steht später über seinen Nachrichten.
5. Packlets zeigt den Schlüssel bzw. die fertige Adresse. Trag sie in deinem Tool ein. Sobald die erste Nachricht ankommt, zeigt Packlets **Verbunden!**. Mit **Testnachricht von hier senden** prüfst du es sofort.

Wie beim Kanal siehst du den Schlüssel nur dieses eine Mal.

## Senden

Ein Dienst schickt genau wie ein Kanal, nur mit seinem eigenen Schlüssel. Alle Aufrufe nehmen ihn an: [`POST /v1/push`](https://packlets.app/docs/api-push.md) und die Adressen für [Slack](https://packlets.app/docs/slack.md), [Discord](https://packlets.app/docs/discord.md) und [ntfy](https://packlets.app/docs/ntfy.md).

```bash
curl https://api.packlets.app/v1/push \
  -H "Authorization: Bearer $PACKLETS_KEY_BACKUP" \
  -H "Content-Type: application/json" \
  -d '{"title": "Backup fertig", "text": "Alle 4 Datenbanken gesichert, 2,3 GB."}'
```

Dann passiert:

- Die Nachricht steht im Kanal, mit dem Namen des Dienstes klein darüber.
- Hat die Nachricht keinen `title`, steht im Push der Name des Dienstes als Titel.
- Das [Protokoll](https://packlets.app/docs/fehlersuche.md#zuerst-das-protokoll) des Kanals zeigt den Namen des Dienstes vor jedem Aufruf.
- In den Einstellungen steht bei jedem Dienst, wann er zuletzt geschickt hat.

## Knöpfe und Webhook

Ein Kanal hat genau eine Webhook-URL. Tippt jemand einen [Knopf](https://packlets.app/docs/knoepfe.md) oder bedient ein [Element](https://packlets.app/docs/nachrichten-elemente.md) in der Nachricht eines Dienstes, geht das Ereignis an diese Adresse, signiert mit dem Schlüssel des **Kanals**, nicht dem des Dienstes. Das Ereignis nennt den Dienst nicht. Dein Empfänger erkennt die Nachricht an der `message_id`, die der Dienst beim Senden zurückbekommen hat.

Soll ein Tool selbst auf Knöpfe reagieren, gib ihm lieber einen eigenen Kanal mit eigener Webhook-URL.

## Grenzen

| Was | Grenze |
|---|---|
| Dienste pro Kanal | 20 |
| Aufrufe | Alle Dienste eines Kanals teilen sich das Limit des Kanals: 60 pro Minute. Dazu 300 pro Minute für dein Konto. |
| Kanal-Art | Nur Kanäle. Eine App hat keine Dienste. |

## Dienst entfernen

Tippe in den Einstellungen des Kanals unter **Dienste** auf den Dienst und bestätige. Sein Schlüssel und seine Adressen gelten dann sofort nicht mehr. Seine bisherigen Nachrichten bleiben im Kanal, mit seinem Namen. Der Schlüssel des Kanals und die anderen Dienste funktionieren weiter.
