Kanal: Nachrichten schicken

Mehrere Dienste in einem Kanal

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

Als Markdown öffnen

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.

Ein Kanal, mehrere Dienste: der Name steht klein über jeder Nachricht

Wann ein Dienst, wann ein eigener Kanal

Eigener KanalDienst in einem Kanal
In der Listeein Eintrag pro Toolein Eintrag für alle
Push, Ton, Ruhezeitpro Tool einstellbargelten für den ganzen Kanal
Schlüsseleiner pro Kanaleiner pro Dienst, einzeln entfernbar
Gut fürTools, die nichts miteinander zu tun habenmehrere 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, Discord, ntfy 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 und die Adressen für Slack, Discord und ntfy.

Shell
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 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 oder bedient ein Element 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

WasGrenze
Dienste pro Kanal20
AufrufeAlle Dienste eines Kanals teilen sich das Limit des Kanals: 60 pro Minute. Dazu 300 pro Minute für dein Konto.
Kanal-ArtNur 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.