> ## 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.

# Boîte de réception

> Gérez les conversations, les réponses et les réponses enregistrées sur toutes les plateformes

Les commandes de boîte de réception vous permettent de trier la boîte de réception sociale unifiée depuis le terminal : lister les conversations, lire les fils de messages, les marquer comme lus ou résolus, répondre avec du texte et des médias, activer ou désactiver la boîte de réception par compte et gérer des réponses enregistrées réutilisables.

> [!NOTE]
>
> Toutes les commandes acceptent les [options globales](/fr/cli/overview.md#options-globales) : `--json` (par défaut) / `--table`, `--verbose`, `--api-key <key>` et `--api-url <url>`. Vous pouvez aussi définir `SOME_API_KEY` et `SOME_API_URL` dans votre environnement.

## Conversations

### inbox:list

Liste les conversations de la boîte de réception.

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

L'endpoint de l'API (`GET /v1/inbox/conversations`) ne gère que la pagination — tous les autres filtres (`--status`, `--platform`, `--type`, `--read`, `--unread`, `--search`) sont appliqués côté client à la page courante. Augmentez `--limit` si vous voulez que les filtres couvrent davantage de conversations.

| Option | Description | Par défaut |
| - | - | - |
| `--status <status>` | Filtrer par statut : `resolved`, `unresolved`, `archived` | — |
| `--platform <platform>` | Filtrer par plateforme : `facebook`, `instagram`, `twitter`, `linkedin`, `tiktok`, `youtube`, `threads`, `whatsapp` | — |
| `--type <type>` | Filtrer par type : `message`, `comment`, `mention` | — |
| `--read` | Affiche uniquement les conversations lues | — |
| `--unread` | Affiche uniquement les conversations non lues | — |
| `--search <query>` | Recherche par nom de l'expéditeur, texte du message ou nom de la page | — |
| `--limit <number>` | Conversations par page | `50` |
| `--page <number>` | Numéro de page | `1` |

```bash Exemples theme={null}
# Unresolved conversations
so-me inbox:list --status unresolved

# Facebook comments only
so-me inbox:list --platform facebook --type comment

# Only unread conversations
so-me inbox:list --unread

# Combine filters: unread Instagram messages
so-me inbox:list --platform instagram --unread --type message

# Search by sender / message / page name
so-me inbox:list --search "john"

# Widen the page so client-side filters cover more threads
so-me inbox:list --limit 100

# Page through results, table view
so-me inbox:list --page 2 --limit 50 --table
```

### inbox:messages

Récupère les messages d'un fil de conversation.

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

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

ID du fil de la conversation dont vous souhaitez récupérer les messages.

```bash Exemples theme={null}
# Fetch a thread's messages
so-me inbox:messages 550e8400-e29b-41d4-a716-446655440000

# Pull only the message bodies via jq
so-me inbox:messages 550e8400-... | jq '.[].message'
```

### inbox:read

Marque une conversation comme lue (définit `isSeen: true`).

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

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

ID du fil de la conversation à marquer comme lue.

```bash Exemples theme={null}
# Mark a single conversation read
so-me inbox:read 550e8400-e29b-41d4-a716-446655440000

# Mark every unread conversation as read
so-me inbox:list --unread --limit 100 \
  | jq -r '.[].id' \
  | xargs -I {} so-me inbox:read {}
```

### inbox:resolve

Marque une conversation comme résolue, non résolue ou archivée.

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

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

ID du fil de la conversation à mettre à jour.

| Option | Description |
| - | - |
| `--status <status>` | Nouveau statut : `resolved`, `unresolved`, `archived` **(obligatoire)** |

```bash Exemples theme={null}
# Resolve a conversation
so-me inbox:resolve 550e8400-... --status resolved

# Re-open a conversation
so-me inbox:resolve 550e8400-... --status unresolved

# Archive a conversation
so-me inbox:resolve 550e8400-... --status archived
```

### inbox:delete

Supprime une ou plusieurs conversations. Une confirmation est demandée, sauf si `--yes` est passé. Chaque fil est supprimé individuellement et les échecs partiels sont signalés.

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

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

Un ou plusieurs ID de fils à supprimer (séparés par des espaces).

| Option | Description |
| - | - |
| `-y, --yes` | Ignore la demande de confirmation |

```bash Exemples theme={null}
# Delete a single conversation (prompts to confirm)
so-me inbox:delete 550e8400-e29b-41d4-a716-446655440000

# Delete several conversations without confirmation
so-me inbox:delete 550e8400-... 660e8400-... 770e8400-... --yes

# Delete all archived conversations
so-me inbox:list --status archived --limit 100 \
  | jq -r '.[].id' \
  | xargs so-me inbox:delete --yes
```

***

## Réponses

### inbox:reply

Répond à une conversation avec du texte, des fichiers, ou les deux. Au moins une des options `--message`, `--image`, `--video`, `--audio` ou `--file` est requise. Les options de médias sont envoyées comme pièces jointes typées (`image`, `video`, `audio`, `document`).

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

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

ID du fil de la conversation à laquelle répondre.

| Option | Description |
| - | - |
| `--message <text>` | Texte du message de réponse |
| `--image <urls...>` | URL d'image(s) à joindre (séparées par des espaces) |
| `--video <url>` | URL de la vidéo à joindre |
| `--audio <url>` | URL de l'audio à joindre |
| `--file <url>` | URL du document à joindre |

```bash Exemples theme={null}
# Text-only reply
so-me inbox:reply 550e8400-... --message "Thanks!"

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

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

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

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

# Reply with an emoji
so-me inbox:reply 550e8400-... --message "Here you go 😊"
```

***

## Abonnements

Ces commandes acceptent soit un ID de compte (UUID), soit un nom de plateforme (par ex. `twitter`, `facebook`). Lorsqu'un nom de plateforme correspond à plusieurs comptes connectés, la CLI vous demande d'en choisir un. Si aucun compte correspondant n'existe, `inbox:subscribe` / `inbox:unsubscribe` se terminent avec succès en vous suggérant d'en connecter un d'abord.

### inbox:subscribe

Active la boîte de réception pour un compte social afin qu'il commence à recevoir messages, commentaires et mentions.

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

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

ID du compte (UUID) ou nom de la plateforme (`twitter`, `facebook`, etc.).

```bash Exemples theme={null}
# Enable by platform name
so-me inbox:subscribe facebook

# Enable by account ID
so-me inbox:subscribe 550e8400-e29b-41d4-a716-446655440000
```

### inbox:unsubscribe

Désactive la boîte de réception pour un compte social.

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

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

ID du compte (UUID) ou nom de la plateforme (`twitter`, `facebook`, etc.).

```bash Exemples theme={null}
# Disable by platform name
so-me inbox:unsubscribe twitter

# Disable by account ID
so-me inbox:unsubscribe 550e8400-e29b-41d4-a716-446655440000
```

### inbox:enable

Alias de [`inbox:subscribe`](#inboxsubscribe).

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

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

ID du compte (UUID) ou nom de la plateforme.

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

### inbox:disable

Alias de [`inbox:unsubscribe`](#inboxunsubscribe).

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

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

ID du compte (UUID) ou nom de la plateforme.

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

***

## Réponses enregistrées

Les réponses enregistrées sont des modèles de réponse réutilisables auxquels vous pouvez joindre des fichiers et que vous pouvez insérer dans la boîte de réception.

### inbox:saved-replies

Liste toutes les réponses enregistrées, ou récupère une réponse enregistrée par son ID.

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

**id** `string`

ID facultatif d'une réponse enregistrée. Lorsqu'il est fourni, renvoie les détails de cette réponse ; sinon, liste toutes les réponses enregistrées.

```bash Exemples theme={null}
# List all saved replies
so-me inbox:saved-replies

# Get one saved reply by ID
so-me inbox:saved-replies 7c2d4e8f-1234-5678-9abc-def012345678

# List as a table
so-me inbox:saved-replies --table
```

### inbox:create-reply

Crée une réponse enregistrée avec du texte, des fichiers, ou les deux. Au moins une des options `--text` ou `--file` est requise.

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

| Option | Description |
| - | - |
| `--text <text>` | Contenu texte de la réponse |
| `--file <file-ids...>` | ID de fichiers à joindre (4 images max., séparés par des espaces) |

```bash Exemples theme={null}
# Text-only saved reply
so-me inbox:create-reply --text "Thanks for reaching out!"

# Text with an attached file
so-me inbox:create-reply --text "Check this out" --file 7c2d4e8f-...

# Multiple file attachments
so-me inbox:create-reply --file 7c2d4e8f-... 8d3e5f9a-...
```

### inbox:edit-reply

Modifie une réponse enregistrée. Au moins une des options `--text` ou `--file` est requise.

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

**id** `string` *required*

ID de la réponse enregistrée à mettre à jour.

| Option | Description |
| - | - |
| `--text <text>` | Nouveau texte de la réponse |
| `--file <file-ids...>` | Nouveaux ID de fichiers (remplacent les existants, 4 images max., séparés par des espaces) |

```bash Exemples theme={null}
# Update the text
so-me inbox:edit-reply 7c2d4e8f-... --text "Updated response"

# Replace the attached files
so-me inbox:edit-reply 7c2d4e8f-... --file 8d3e5f9a-... 9e4f6a0b-...
```

### inbox:delete-reply

Supprime une ou plusieurs réponses enregistrées. Une confirmation est demandée, sauf si `--yes` est passé. Chaque réponse est supprimée individuellement et les échecs partiels sont signalés.

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

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

Un ou plusieurs ID de réponses enregistrées à supprimer (séparés par des espaces).

| Option | Description |
| - | - |
| `-y, --yes` | Ignore la demande de confirmation |

```bash Exemples theme={null}
# Delete a single saved reply (prompts to confirm)
so-me inbox:delete-reply 7c2d4e8f-...

# Delete several without confirmation
so-me inbox:delete-reply 7c2d4e8f-... 8d3e5f9a-... --yes

# Delete every saved reply
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.