# Überblick

Was Samy macht, wann du einen Kanal und wann eine App nimmst und wie diese Doku aufgebaut ist.

Samy bringt Software, die du selbst gebaut hast, aufs Handy. Dein Tool schickt mit einem einzigen HTTP-Aufruf eine Nachricht, Samy zeigt sie als Push. Und was du in der App tippst, schaltest oder schreibst, kommt bei deinem Tool wieder an.

Dein Code läuft dabei weiter bei dir: auf dem Rechner, einem Server, einem Raspberry Pi oder als Cronjob. Samy ist nur der Weg aufs Handy und zurück.

## Kanal oder App

Jedes Tool, das du verbindest, bekommt in der App einen eigenen Platz. Beim Verbinden wählst du, was dein Tool tun soll: **Mir Bescheid geben** (ein Kanal) oder **Eigene App bauen** (eine App). In einem Kanal kannst du außerdem **Antworten erlauben**, dann schreibst du mit deinem Tool wie in einem Chat. Diesen Schalter kannst du jederzeit umlegen.

| In der App | Nimm es, wenn … | Beispiele |
|---|---|---|
| **Mir Bescheid geben** (Kanal) | dein Tool von sich aus etwas meldet. | Server fällt aus, Deploy oder Backup schlägt fehl, neue Bestellung, Tagesbericht |
| … mit **Antworten erlauben** | du deinem Tool etwas sagen oder es etwas fragen willst. | eigener KI-Agent, Bot mit Befehlen |
| **Eigene App bauen** (App) | du immer wieder etwas nachsehen oder abarbeiten willst. | Rechnungen freigeben, Server-Dashboard, Pull Requests prüfen, Support-Postfach |

Unsicher? Fang mit einem Kanal an. Er braucht nur einen HTTP-Aufruf. Eine App ist eine Webseite, die du selbst baust und auf deinem Server betreibst.

Kann dein Tool schon an Slack, Discord oder ntfy schicken, geht es ganz ohne Code: Tipp beim Verbinden auf **Integrationen** und wähle [Slack](https://packlets.app/docs/slack.md), [Discord](https://packlets.app/docs/discord.md) oder [ntfy](https://packlets.app/docs/ntfy.md). So meldet sich zum Beispiel dein Uptime-Monitor in Samy.

## So ist die Doku aufgebaut

Lies von oben nach unten. Jeder Teil baut nur auf den Teilen davor auf.

| Teil | Was du dort findest |
|---|---|
| **Loslegen** | [Schnellstart](https://packlets.app/docs/schnellstart.md): die erste Nachricht in fünf Minuten. Danach [So funktioniert Samy](https://packlets.app/docs/konzepte.md) mit allen Begriffen. |
| **Kanal** | [Nachrichten senden](https://packlets.app/docs/senden.md), [Knöpfe](https://packlets.app/docs/knoepfe.md) und [Elemente](https://packlets.app/docs/nachrichten-elemente.md) darin, [Vorlagen](https://packlets.app/docs/vorlagen.md), [Push und Ruhezeit](https://packlets.app/docs/push.md). |
| **Auf Eingaben reagieren** | Der [Webhook](https://packlets.app/docs/webhook.md): So erfährt dein Tool, was du in der App tust. Knöpfe, Elemente und Antworten bauen darauf auf. |
| **Antworten** | Einen [Chat-Bot bauen](https://packlets.app/docs/chat.md). |
| **Apps** | [Eigene App bauen](https://packlets.app/docs/apps.md): deine Webseite als App in Samy. |
| **Referenz** | Zum Nachschlagen: jeder [Aufruf](https://packlets.app/docs/api.md), jedes [Element](https://packlets.app/docs/elemente.md), jedes [Ereignis](https://packlets.app/docs/ereignisse.md), jeder [Fehler](https://packlets.app/docs/fehler.md). |
| **Hilfe** | [Fehlersuche](https://packlets.app/docs/fehlersuche.md), [fertiger Code](https://packlets.app/docs/beispiele.md) und [Sicherheit](https://packlets.app/docs/sicherheit.md). |

Du lässt lieber deinen Coding-Assistenten bauen? Dann reicht [Mit KI bauen](https://packlets.app/docs/ki.md).

## Kosten

Die App, Push-Nachrichten, Knöpfe, Chats und eigene Apps sind kostenlos.