# Samy

> Samy ist eine Handy-App (iOS und Android), die Nachrichten aus selbst gebauter Software als Push aufs Handy bringt. Ein Tool schickt mit einem HTTP-Aufruf eine Nachricht an Samy. Nachrichten können Knöpfe haben, deren Tipp per Webhook an das Tool zurückgemeldet wird. API-Adresse: https://api.packlets.app. Die Verbindung zu einem Tool heißt „Packlet“ und hat einen eigenen Schlüssel.

Die komplette Dokumentation in einer Datei: https://packlets.app/llms-full.txt

## Loslegen

- [Überblick](https://packlets.app/docs/ueberblick.md): Was Samy macht, wann du einen Kanal und wann eine App nimmst und wie diese Doku aufgebaut ist.
- [Schnellstart](https://packlets.app/docs/schnellstart.md): In fünf Minuten zur ersten Nachricht auf dem Handy.
- [So funktioniert Samy](https://packlets.app/docs/konzepte.md): Die Begriffe und das Zusammenspiel: dein Tool, Packlet, Schlüssel, Aufrufe hin und Webhook zurück.
- [Mit KI bauen](https://packlets.app/docs/ki.md): Die Doku als reiner Text, damit dein Coding-Assistent die Anbindung für dich schreibt.

## Kanal: Nachrichten schicken

- [Nachricht senden](https://packlets.app/docs/senden.md): Der eine Aufruf, mit dem dein Tool eine Nachricht schickt: Text, Titel, Formatierung, Link und Bild.
- [Knöpfe](https://packlets.app/docs/knoepfe.md): Mit Knöpfen unter einer Nachricht öffnest du Links oder antwortest deinem Tool mit einem Tipp.
- [Elemente in Nachrichten](https://packlets.app/docs/nachrichten-elemente.md): Schalter, Eingabefelder, Diagramme und Tabellen direkt in einer Nachricht.
- [Layout der Elemente](https://packlets.app/docs/layout.md): Das Raster mit sechs Spalten: Breiten, Höhen, Mindestgrößen und was die App selbst zurechtrückt.
- [Vorlagen](https://packlets.app/docs/vorlagen.md): Fertige Nachrichten zum Kopieren: Server-Alarm, Deploy, Bestellung, Tagesbericht und Rechnung.
- [Ohne Code: Slack-Adresse](https://packlets.app/docs/slack.md): Tools, die nur an Slack schicken können, schicken mit dieser Adresse an Samy. Ohne eine Zeile Code.
- [Ohne Code: Discord-Adresse](https://packlets.app/docs/discord.md): Tools mit Discord-Option schicken mit dieser Adresse an Samy. Ohne Code und ohne Discord-Konto.
- [Ohne Code: ntfy](https://packlets.app/docs/ntfy.md): Samy versteht die Aufrufe von ntfy: Server ist die Samy-Adresse, Topic dein Schlüssel.
- [Push, Ton und Ruhezeit](https://packlets.app/docs/push.md): Wann eine Nachricht als Push erscheint, wann mit Ton und wann sie still bleibt.

## Auf Eingaben reagieren

- [Webhook einrichten](https://packlets.app/docs/webhook.md): So erfährt dein Tool, was du in der App tust: Empfänger bauen, Signatur prüfen, testen.

## Antworten

- [Chat-Bot bauen](https://packlets.app/docs/chat.md): Mit deinem Tool schreiben: Deine Nachricht kommt per Webhook, die Antwort über den Senden-Aufruf.

## Apps

- [Eigene App bauen](https://packlets.app/docs/apps.md): Die App ist deine Webseite: im Look von Samy, mit samy.js und Anmeldung per Session-Token.

## Referenz

- [API-Grundlagen](https://packlets.app/docs/api.md): Adresse, Anmeldung, alle Aufrufe, Rate-Limit und alle Grenzen auf einen Blick.
- [POST /v1/push](https://packlets.app/docs/api-push.md): Eine Nachricht schicken: alle Felder, Antwort und Fehler.
- [PUT /v1/ui](https://packlets.app/docs/api-ui.md): Die Seite einer App setzen: Feld, Antwort und Fehler.
- [Elemente](https://packlets.app/docs/elemente.md): Text, Button, Schalter, Eingabefeld, Diagramm und Tabelle in Nachrichten: Felder, Werte und Größen.
- [Webhook-Ereignisse](https://packlets.app/docs/ereignisse.md): Was Samy an deine Webhook-URL schickt: Ereignisse, Header, Signatur und Wiederholungen.
- [samy.js, samy.css, Session-Token](https://packlets.app/docs/api-seiten.md): Alles für die Seite deiner App: die Brücke, das Stylesheet und das Token.
- [Fehlercodes](https://packlets.app/docs/fehler.md): Alle Fehler aller Aufrufe an einer Stelle, mit dem, was du tun kannst.

## Hilfe

- [Fehlersuche](https://packlets.app/docs/fehlersuche.md): Wenn etwas nicht ankommt: die häufigsten Ursachen und wo du nachsiehst.
- [Fertiger Code](https://packlets.app/docs/beispiele.md): Bausteine zum Kopieren: Client für Python und TypeScript, Webhook-Empfänger und Shell.
- [Schlüssel und Sicherheit](https://packlets.app/docs/sicherheit.md): Wie Samy mit deinem Schlüssel umgeht und was du selbst beachten solltest.