> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Posteingang

> Konversationen, Antworten und gespeicherte Antworten plattformübergreifend verwalten

Mit den Posteingangsbefehlen bearbeitest du den einheitlichen Social-Posteingang im Terminal: Konversationen auflisten, Nachrichtenverläufe lesen, sie als gelesen/erledigt markieren, mit Text und Medien antworten, Posteingangs-Abonnements je Konto umschalten und wiederverwendbare gespeicherte Antworten verwalten.

> [!NOTE]
>
> Alle Befehle akzeptieren die [globalen Flags](/de/cli/overview.md#globale-optionen): `--json` (Standard) / `--table`, `--verbose`, `--api-key <key>` und `--api-url <url>`. Du kannst außerdem `SOME_API_KEY` und `SOME_API_URL` in deiner Umgebung setzen.

## Konversationen

### inbox:list

Listet Posteingangs-Konversationen auf.

```bash theme={null}
so-me inbox:list [options]
```

Der API-Endpunkt (`GET /v1/inbox/conversations`) paginiert nur — jeder andere Filter (`--status`, `--platform`, `--type`, `--read`, `--unread`, `--search`) wird clientseitig auf die aktuelle Seite angewendet. Erhöhe `--limit`, wenn die Filter mehr Konversationen abdecken sollen.

| Option | Beschreibung | Standard |
| - | - | - |
| `--status <status>` | Nach Status filtern: `resolved`, `unresolved`, `archived` | — |
| `--platform <platform>` | Nach Plattform filtern: `facebook`, `instagram`, `twitter`, `linkedin`, `tiktok`, `youtube`, `threads`, `whatsapp` | — |
| `--type <type>` | Nach Typ filtern: `message`, `comment`, `mention` | — |
| `--read` | Nur gelesene Konversationen anzeigen | — |
| `--unread` | Nur ungelesene Konversationen anzeigen | — |
| `--search <query>` | Nach Absendername, Nachrichtentext oder Seitenname suchen | — |
| `--limit <number>` | Konversationen pro Seite | `50` |
| `--page <number>` | Seitennummer | `1` |

```bash Beispiele theme={null}
# Ungelöste Konversationen
so-me inbox:list --status unresolved

# Nur Facebook-Kommentare
so-me inbox:list --platform facebook --type comment

# Nur ungelesene Konversationen
so-me inbox:list --unread

# Filter kombinieren: ungelesene Instagram-Nachrichten
so-me inbox:list --platform instagram --unread --type message

# Nach Absender / Nachricht / Seitenname suchen
so-me inbox:list --search "john"

# Die Seite vergrößern, damit clientseitige Filter mehr Verläufe abdecken
so-me inbox:list --limit 100

# Ergebnisse seitenweise durchgehen, Tabellenansicht
so-me inbox:list --page 2 --limit 50 --table
```

### inbox:messages

Ruft die Nachrichten eines Konversationsverlaufs ab.

```bash theme={null}
so-me inbox:messages <thread-id>
```

**thread-id** `string` *required*

Thread-ID der Konversation, deren Nachrichten du abrufen möchtest.

```bash Beispiele theme={null}
# Die Nachrichten eines Verlaufs abrufen
so-me inbox:messages 550e8400-e29b-41d4-a716-446655440000

# Nur die Nachrichtentexte per jq herausziehen
so-me inbox:messages 550e8400-... | jq '.[].message'
```

### inbox:read

Markiert eine Konversation als gelesen (setzt `isSeen: true`).

```bash theme={null}
so-me inbox:read <thread-id>
```

**thread-id** `string` *required*

Thread-ID der Konversation, die als gelesen markiert werden soll.

```bash Beispiele theme={null}
# Eine einzelne Konversation als gelesen markieren
so-me inbox:read 550e8400-e29b-41d4-a716-446655440000

# Jede ungelesene Konversation als gelesen markieren
so-me inbox:list --unread --limit 100 \
  | jq -r '.[].id' \
  | xargs -I {} so-me inbox:read {}
```

### inbox:resolve

Markiert eine Konversation als erledigt, nicht erledigt oder archiviert.

```bash theme={null}
so-me inbox:resolve <thread-id> --status <status>
```

**thread-id** `string` *required*

Thread-ID der zu aktualisierenden Konversation.

| Option | Beschreibung |
| - | - |
| `--status <status>` | Neuer Status: `resolved`, `unresolved`, `archived` **(erforderlich)** |

```bash Beispiele theme={null}
# Eine Konversation als erledigt markieren
so-me inbox:resolve 550e8400-... --status resolved

# Eine Konversation wieder öffnen
so-me inbox:resolve 550e8400-... --status unresolved

# Eine Konversation archivieren
so-me inbox:resolve 550e8400-... --status archived
```

### inbox:delete

Löscht eine oder mehrere Konversationen. Fragt nach einer Bestätigung, sofern nicht `--yes` übergeben wird. Jeder Verlauf wird einzeln gelöscht, Teilfehler werden gemeldet.

```bash theme={null}
so-me inbox:delete <thread-ids...> [options]
```

**thread-ids** `string[]` *required*

Eine oder mehrere zu löschende Thread-IDs (durch Leerzeichen getrennt).

| Option | Beschreibung |
| - | - |
| `-y, --yes` | Bestätigungsabfrage überspringen |

```bash Beispiele theme={null}
# Eine einzelne Konversation löschen (fragt nach Bestätigung)
so-me inbox:delete 550e8400-e29b-41d4-a716-446655440000

# Mehrere Konversationen ohne Bestätigung löschen
so-me inbox:delete 550e8400-... 660e8400-... 770e8400-... --yes

# Alle archivierten Konversationen löschen
so-me inbox:list --status archived --limit 100 \
  | jq -r '.[].id' \
  | xargs so-me inbox:delete --yes
```

***

## Antworten

### inbox:reply

Antwortet auf eine Konversation mit Text, Dateien oder beidem. Mindestens eines von `--message`, `--image`, `--video`, `--audio` oder `--file` ist erforderlich. Medien-Flags werden als typisierte Anhänge gesendet (`image`, `video`, `audio`, `document`).

```bash theme={null}
so-me inbox:reply <thread-id> [options]
```

**thread-id** `string` *required*

Thread-ID der Konversation, auf die geantwortet wird.

| Option | Beschreibung |
| - | - |
| `--message <text>` | Text der Antwort |
| `--image <urls...>` | Anzuhängende Bild-URL(s) (durch Leerzeichen getrennt) |
| `--video <url>` | Anzuhängende Video-URL |
| `--audio <url>` | Anzuhängende Audio-URL |
| `--file <url>` | Anzuhängende Dokument-URL |

```bash Beispiele theme={null}
# Antwort nur mit Text
so-me inbox:reply 550e8400-... --message "Thanks!"

# Text mit einem Bild
so-me inbox:reply 550e8400-... --message "Check this" --image https://cdn.example.com/photo.jpg

# Mehrere Bilder
so-me inbox:reply 550e8400-... --image https://cdn.example.com/1.jpg https://cdn.example.com/2.jpg

# Video-Anhang
so-me inbox:reply 550e8400-... --video https://cdn.example.com/clip.mp4

# Dokument-Anhang
so-me inbox:reply 550e8400-... --file https://cdn.example.com/doc.pdf

# Mit einem Emoji antworten
so-me inbox:reply 550e8400-... --message "Here you go 😊"
```

***

## Abonnements

Diese Befehle akzeptieren entweder eine Konto-ID (UUID) oder einen Plattformnamen (z. B. `twitter`, `facebook`). Passt ein Plattformname auf mehrere verbundene Konten, fordert die CLI dich auf, eines auszuwählen. Existiert kein passendes Konto, beenden sich `inbox:subscribe` / `inbox:unsubscribe` erfolgreich mit dem Hinweis, zuerst eines zu verbinden.

### inbox:subscribe

Aktiviert den Posteingang für ein Social-Konto, damit es Nachrichten, Kommentare und Erwähnungen empfängt.

```bash theme={null}
so-me inbox:subscribe <id-or-platform>
```

**id-or-platform** `string` *required*

Konto-ID (UUID) oder Plattformname (`twitter`, `facebook` usw.).

```bash Beispiele theme={null}
# Per Plattformname aktivieren
so-me inbox:subscribe facebook

# Per Konto-ID aktivieren
so-me inbox:subscribe 550e8400-e29b-41d4-a716-446655440000
```

### inbox:unsubscribe

Deaktiviert den Posteingang für ein Social-Konto.

```bash theme={null}
so-me inbox:unsubscribe <id-or-platform>
```

**id-or-platform** `string` *required*

Konto-ID (UUID) oder Plattformname (`twitter`, `facebook` usw.).

```bash Beispiele theme={null}
# Per Plattformname deaktivieren
so-me inbox:unsubscribe twitter

# Per Konto-ID deaktivieren
so-me inbox:unsubscribe 550e8400-e29b-41d4-a716-446655440000
```

### inbox:enable

Alias für [`inbox:subscribe`](#inboxsubscribe).

```bash theme={null}
so-me inbox:enable <id-or-platform>
```

**id-or-platform** `string` *required*

Konto-ID (UUID) oder Plattformname.

```bash Beispiel theme={null}
so-me inbox:enable instagram
```

### inbox:disable

Alias für [`inbox:unsubscribe`](#inboxunsubscribe).

```bash theme={null}
so-me inbox:disable <id-or-platform>
```

**id-or-platform** `string` *required*

Konto-ID (UUID) oder Plattformname.

```bash Beispiel theme={null}
so-me inbox:disable instagram
```

***

## Gespeicherte Antworten

Gespeicherte Antworten sind wiederverwendbare Antwortvorlagen, denen du Dateien anhängen und die du in den Posteingang übernehmen kannst.

### inbox:saved-replies

Listet alle gespeicherten Antworten auf oder ruft eine einzelne gespeicherte Antwort über ihre ID ab.

```bash theme={null}
so-me inbox:saved-replies [id]
```

**id** `string`

Optionale ID einer gespeicherten Antwort. Wenn angegeben, werden die Details dieser einzelnen Antwort zurückgegeben; andernfalls werden alle gespeicherten Antworten aufgelistet.

```bash Beispiele theme={null}
# Alle gespeicherten Antworten auflisten
so-me inbox:saved-replies

# Eine gespeicherte Antwort per ID abrufen
so-me inbox:saved-replies 7c2d4e8f-1234-5678-9abc-def012345678

# Als Tabelle auflisten
so-me inbox:saved-replies --table
```

### inbox:create-reply

Erstellt eine gespeicherte Antwort mit Text, Dateien oder beidem. Mindestens eines von `--text` oder `--file` ist erforderlich.

```bash theme={null}
so-me inbox:create-reply [options]
```

| Option | Beschreibung |
| - | - |
| `--text <text>` | Text der Antwort |
| `--file <file-ids...>` | Anzuhängende Datei-IDs (max. 4 Bilder, durch Leerzeichen getrennt) |

```bash Beispiele theme={null}
# Gespeicherte Antwort nur mit Text
so-me inbox:create-reply --text "Thanks for reaching out!"

# Text mit angehängter Datei
so-me inbox:create-reply --text "Check this out" --file 7c2d4e8f-...

# Mehrere Dateianhänge
so-me inbox:create-reply --file 7c2d4e8f-... 8d3e5f9a-...
```

### inbox:edit-reply

Bearbeitet eine gespeicherte Antwort. Mindestens eines von `--text` oder `--file` ist erforderlich.

```bash theme={null}
so-me inbox:edit-reply <id> [options]
```

**id** `string` *required*

ID der zu aktualisierenden gespeicherten Antwort.

| Option | Beschreibung |
| - | - |
| `--text <text>` | Neuer Antworttext |
| `--file <file-ids...>` | Neue Datei-IDs (ersetzen die vorhandenen, max. 4 Bilder, durch Leerzeichen getrennt) |

```bash Beispiele theme={null}
# Den Text aktualisieren
so-me inbox:edit-reply 7c2d4e8f-... --text "Updated response"

# Die angehängten Dateien ersetzen
so-me inbox:edit-reply 7c2d4e8f-... --file 8d3e5f9a-... 9e4f6a0b-...
```

### inbox:delete-reply

Löscht eine oder mehrere gespeicherte Antworten. Fragt nach einer Bestätigung, sofern nicht `--yes` übergeben wird. Jede Antwort wird einzeln gelöscht, Teilfehler werden gemeldet.

```bash theme={null}
so-me inbox:delete-reply <ids...> [options]
```

**ids** `string[]` *required*

Eine oder mehrere zu löschende IDs gespeicherter Antworten (durch Leerzeichen getrennt).

| Option | Beschreibung |
| - | - |
| `-y, --yes` | Bestätigungsabfrage überspringen |

```bash Beispiele theme={null}
# Eine einzelne gespeicherte Antwort löschen (fragt nach Bestätigung)
so-me inbox:delete-reply 7c2d4e8f-...

# Mehrere ohne Bestätigung löschen
so-me inbox:delete-reply 7c2d4e8f-... 8d3e5f9a-... --yes

# Jede gespeicherte Antwort löschen
so-me inbox:saved-replies \
  | jq -r '.[].id' \
  | xargs so-me inbox:delete-reply --yes
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.