Kanal: Nachrichten schicken

Vorlagen

Fertige Nachrichten zum Kopieren: Server-Alarm, Deploy, Bestellung, Tagesbericht und Rechnung.

Fertige Nachrichten für einen Kanal. Jede Vorlage sieht hier so aus wie in Samy, und Schalter, Buttons und Eingabefelder kannst du direkt ausprobieren.

So nutzt du eine Vorlage: JSON kopieren, mit POST /v1/push schicken, Texte und IDs an dein Tool anpassen. Wie das geht, steht ganz unten unter Schicken. Was die einzelnen Felder bedeuten, steht unter Knöpfe und Elemente.

Server antwortet nicht

Dein Uptime-Check merkt, dass ein Dienst ausfällt. Die Meldung kommt mit Ton, auch in der Ruhezeit. Ein Knopf startet den Dienst neu, der zweite öffnet die Statusseite.

shop-api antwortet nicht

Seit 9:38 Uhr kein Health-Check mehr. Letzter Status: 502.

Letzte Checks

Zeit	Status	ms
9:36	200	182
9:37	200	240
9:38	502	30.012
9:39	502	30.008

JSON

{
  "title": "shop-api antwortet nicht",
  "text": "Seit **9:38 Uhr** kein Health-Check mehr. Letzter Status: 502.",
  "priority": "high",
  "elements": [
    {
      "type": "table", "id": "checks", "label": "Letzte Checks",
      "columns": ["Zeit", "Status", "ms"],
      "rows": [["9:36", "200", 182], ["9:37", "200", 240], ["9:38", "502", 30012], ["9:39", "502", 30008]]
    }
  ],
  "buttons": [
    { "id": "restart", "label": "Neu starten" },
    { "id": "status", "label": "Status", "url": "https://status.example.com" }
  ]
}

Tippst du Neu starten, bekommt dein Webhook das Ereignis button mit button_id: "restart".

Deploy fehlgeschlagen

Deine CI meldet einen roten Build. Die Tabelle zeigt, welche Tests scheitern. Den Button Erneut starten kannst du mehrmals tippen, anders als einen Knopf.

Deploy fehlgeschlagen

shop-api auf `main`, Commit a3f9c21 von Jonas.

Fehlgeschlagene Tests

Test	Dauer
checkout › Gutschein	1,2 s
checkout › Versand	0,8 s

JSON

{
  "title": "Deploy fehlgeschlagen",
  "text": "**shop-api** auf `main`, Commit a3f9c21 von Jonas.",
  "priority": "high",
  "elements": [
    {
      "type": "table", "id": "tests", "label": "Fehlgeschlagene Tests",
      "columns": ["Test", "Dauer"],
      "rows": [["checkout › Gutschein", "1,2 s"], ["checkout › Versand", "0,8 s"]]
    },
    { "type": "button", "id": "retry", "label": "Erneut starten", "width": 3 },
    { "type": "button", "id": "rollback", "label": "Zurückrollen", "style": "secondary", "width": 3 }
  ],
  "buttons": [
    { "id": "log", "label": "Log öffnen", "url": "https://ci.example.com/runs/4711" }
  ]
}

Neue Bestellung

Dein Shop meldet jede Bestellung. Der Knopf markiert sie als versendet, der Link öffnet sie im Backend.

Neue Bestellung #1049

Tim R. aus Leipzig, 129,00 €, bezahlt mit PayPal.

Artikel	Menge	€
Kaffeemühle Classic	1	99
Bohnen Espresso 1 kg	2	15

JSON

{
  "title": "Neue Bestellung #1049",
  "text": "Tim R. aus Leipzig, **129,00 €**, bezahlt mit PayPal.",
  "elements": [
    {
      "type": "table", "id": "artikel",
      "columns": ["Artikel", "Menge", "€"],
      "rows": [["Kaffeemühle Classic", 1, 99], ["Bohnen Espresso 1 kg", 2, 15]]
    }
  ],
  "buttons": [
    { "id": "shipped", "label": "Versendet" },
    { "id": "open", "label": "Öffnen", "url": "https://shop.example.com/admin/orders/1049" }
  ]
}

Tagesbericht

Ein Cronjob schickt jeden Morgen die Zahlen von gestern. Mit priority: "silent" kommt er ohne Ton.

Tagesbericht

Gestern

23 Bestellungen, 1.204 € Umsatz
3 Deploys, alle erfolgreich
Backup um 3:00 fertig

Umsatz der Woche

1.204 €

JSON

{
  "title": "Tagesbericht",
  "text": "## Gestern\n- **23 Bestellungen**, 1.204 € Umsatz\n- 3 Deploys, alle erfolgreich\n- Backup um 3:00 fertig",
  "priority": "silent",
  "elements": [
    {
      "type": "chart", "id": "umsatz", "label": "Umsatz der Woche", "unit": "€", "height": 160,
      "points": [
        { "label": "Do", "value": 1310 }, { "label": "Fr", "value": 1580 }, { "label": "Sa", "value": 720 },
        { "label": "So", "value": 640 }, { "label": "Mo", "value": 860 }, { "label": "Di", "value": 1204 }
      ]
    }
  ]
}

Rechnung freigeben

Eine neue Rechnung wartet auf deine Freigabe. Zwei Knöpfe entscheiden, das Eingabefeld schickt eine Rückfrage an dein Tool. Musst du viele Rechnungen nacheinander prüfen, ist eine eigene App bequemer.

Rechnung von Hosting GmbH

189,00 €, fällig am 20.11. Leistung: Server November.

Rückfrage an die Buchhaltung

Gesendet

JSON

{
  "title": "Rechnung von Hosting GmbH",
  "text": "**189,00 €**, fällig am 20.11. Leistung: Server November.",
  "elements": [
    {
      "type": "input", "id": "frage", "label": "Rückfrage an die Buchhaltung",
      "placeholder": "z. B. Warum teurer als im Oktober?", "button": "Fragen"
    }
  ],
  "buttons": [
    { "id": "approve", "label": "Freigeben" },
    { "id": "reject", "label": "Ablehnen" },
    { "id": "pdf", "label": "PDF", "url": "https://example.com/rechnungen/2026-118.pdf" }
  ]
}

Schicken

Speicher das JSON einer Vorlage als vorlage.json und schick es als Nachricht:

curl https://api.packlets.app/v1/push \
  -H "Authorization: Bearer $SAMY_KEY" \
  -H "Content-Type: application/json" \
  -d @vorlage.json

Danach kommt jeder Tipp auf einen Knopf als Webhook-Ereignis button, jede Bedienung eines Elements als Ereignis ui, beide mit der message_id der Nachricht. Wie dein Tool darauf reagiert, steht unter Webhook einrichten.