Elemente in Nachrichten

Eine Nachricht kann mehr als Text und Knöpfe enthalten: einen Button, einen Schalter, ein Eingabefeld, ein Diagramm, eine Tabelle. Diese Elemente gibt es nur in Nachrichten.

Du brauchst: Nachricht senden. Für bedienbare Elemente zusätzlich einen Webhook.

Elemente mitschicken

Elemente stehen im Feld elements, bis zu 12 pro Nachricht. Jedes hat einen type und eine id, die in der Nachricht eindeutig ist:

curl https://api.packlets.app/v1/push \
  -H "Authorization: Bearer $SAMY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Fehlerrate nach Deploy",
    "text": "Seit Deploy v2.14 schlagen 6 % der Anfragen fehl.",
    "elements": [
      {"type": "button", "id": "rollback", "label": "Auf v2.13 zurückrollen"},
      {"type": "toggle", "id": "auto_deploy", "label": "Automatische Deploys", "value": true},
      {"type": "chart", "id": "fehler", "label": "Fehlerrate", "unit": "%", "chart": "line",
       "points": [{"label": "9:00", "value": 0.2}, {"label": "10:00", "value": 6.2}]}
    ]
  }'

Welche Elemente es gibt und welche Felder sie haben, steht in der Referenz Elemente.

Auf Bedienung reagieren

Tippst du den Button, legst den Schalter um oder schickst ein Eingabefeld ab, bekommt dein Webhook das Ereignis ui:

{
  "type": "ui",
  "packlet_id": "9d2f7c10-3a5b-4c8e-9f21-6b7d8e9f0a12",
  "message_id": "5b0c1a52-7c1e-4a43-9d0b-2f6f0c7d1e11",
  "element_id": "auto_deploy",
  "value": false,
  "changed_at": "2026-11-10T18:00:00.000Z"
}

element_id sagt, welches Element es war, value den neuen Wert. Beim Button ist value gleich null. An message_id erkennst du, aus welcher Nachricht die Bedienung kommt.

Wie dein Tool das Ereignis empfängt, steht unter Webhook einrichten.

Knöpfe oder Elemente

Beides zusammen in einer Nachricht geht auch.

Was du wissen solltest

• Nachträglich ändern geht nicht. Die Werte in einer Nachricht ändern sich nur, wenn du sie in der App bedienst. Dein Tool kann sie nicht aktualisieren. Schick stattdessen eine neue Nachricht. Brauchst du eine Ansicht, die immer aktuell ist, bau eine eigene App.
• Es ist schmal. Eine Nachricht ist schmaler als der Bildschirm. Lass Elemente am besten auf voller Breite (ohne width) und halt Beschriftungen kurz. Mehr dazu unter Layout der Elemente.
• Fertige Beispiele zum Kopieren stehen unter Vorlagen.
• Im Push steht nur der Text. Elemente siehst du erst in der App.