# Knöpfe

Mit Knöpfen öffnest du Links oder bedienst dein Tool direkt vom Handy.

Eine Nachricht kann bis zu drei Knöpfe haben. Du gibst sie im Feld `buttons` an.

## Zwei Arten

- **Link-Knopf** (mit `url`): öffnet die Adresse auf dem Handy.
- **Aktions-Knopf** (ohne `url`): Samy meldet den Tipp an die Webhook-URL deines Packlets. So bedienst du dein Tool vom Handy aus. Dafür muss beim Packlet eine [Webhook-URL](https://samy.sinio.io/docs/webhook.md) eingetragen sein.

## Felder eines Knopfs

| Feld | Typ | Pflicht | Bedeutung |
|---|---|---|---|
| `id` | Text, 1 bis 64 Zeichen | ja | Deine Kennung für den Knopf. Pro Nachricht eindeutig. Sie kommt im Webhook als `button_id` zurück. |
| `label` | Text, 1 bis 40 Zeichen | ja | Beschriftung. |
| `url` | http(s)-Adresse | nein | Macht aus dem Knopf einen Link-Knopf. |

## Beispiel

```bash
curl https://api-production-e537a.up.railway.app/v1/push \
  -H "Authorization: Bearer $SAMY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Neue Bestellung #1042",
    "text": "2× Kaffeebecher, 89,00 €",
    "buttons": [
      {"id": "label", "label": "Versandlabel drucken"},
      {"id": "open", "label": "Details", "url": "https://shop.example.com/orders/1042"}
    ]
  }'
```

Der erste Knopf ist ein Aktions-Knopf, der zweite ein Link-Knopf. Nach dem Tipp zeigt die Nachricht in der App, welcher Knopf gedrückt wurde.