# API-Referenz Inbox (App-Kennung mitteilungen)

> 1 App-Tools. Aufruf immer mit `POST /api/app-tools`, Header `X-API-KEY`, Body `{"name": "<tool>", "input": {…}}`. Welche Tools ein Schlüssel nutzen darf, zeigt `GET /api/app-tools` der Instanz.

Quelle: https://support.unitedsynergy.com/api/referenz/mitteilungen/

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### mitteilungen.send

Sendet eine Chat-Nachricht an einen User des Tenants (löst Push aus). Absender ist der ausführende User, sofern "from" nicht gesetzt ist.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Mitteilung senden
- Datenklassen: B (intern)
- Datenschutz: Sendet eine Chat-Nachricht zwischen Tenant-Usern. Freitext wird nicht in Audit-Details gespeichert.
- Eingabe:
  - `to` (string, Pflicht): Empfänger: User-ID oder E-Mail (muss Tenant-Mitglied sein)
  - `body` (string, Pflicht): Nachrichtentext
  - `from` (string): Optional: Absender (User-ID/E-Mail). Default = ausführender User
- Beispiel: `{"name":"mitteilungen.send","input":{"to":"<to>","body":"<body>"}}`