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

# Bandeja de entrada

> Gestiona conversaciones, respuestas y respuestas guardadas en todas las plataformas

Los comandos de la bandeja de entrada te permiten clasificar la bandeja de entrada social unificada desde la terminal: listar conversaciones, leer hilos de mensajes, marcarlos como leídos o resueltos, responder con texto y multimedia, activar o desactivar las suscripciones de la bandeja por cuenta y gestionar respuestas guardadas reutilizables.

> [!NOTE]
>
> Todos los comandos aceptan las [opciones globales](/es/cli/overview.md#opciones-globales): `--json` (por defecto) / `--table`, `--verbose`, `--api-key <key>` y `--api-url <url>`. También puedes definir `SOME_API_KEY` y `SOME_API_URL` en tu entorno.

## Conversaciones

### inbox:list

Lista las conversaciones de la bandeja de entrada.

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

El endpoint de la API (`GET /v1/inbox/conversations`) solo pagina: cualquier otro filtro (`--status`, `--platform`, `--type`, `--read`, `--unread`, `--search`) se aplica en el cliente a la página actual. Aumenta `--limit` si necesitas que los filtros abarquen más conversaciones.

| Opción | Descripción | Por defecto |
| - | - | - |
| `--status <status>` | Filtra por estado: `resolved`, `unresolved`, `archived` | — |
| `--platform <platform>` | Filtra por plataforma: `facebook`, `instagram`, `twitter`, `linkedin`, `tiktok`, `youtube`, `threads`, `whatsapp` | — |
| `--type <type>` | Filtra por tipo: `message`, `comment`, `mention` | — |
| `--read` | Muestra solo las conversaciones leídas | — |
| `--unread` | Muestra solo las conversaciones no leídas | — |
| `--search <query>` | Busca por nombre del remitente, texto del mensaje o nombre de la página | — |
| `--limit <number>` | Conversaciones por página | `50` |
| `--page <number>` | Número de página | `1` |

```bash Ejemplos 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

Obtiene los mensajes de un hilo de conversación.

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

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

ID del hilo de la conversación cuyos mensajes quieres obtener.

```bash Ejemplos 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

Marca una conversación como leída (establece `isSeen: true`).

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

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

ID del hilo de la conversación que se marca como leída.

```bash Ejemplos 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

Marca una conversación como resuelta, no resuelta o archivada.

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

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

ID del hilo de la conversación que se actualiza.

| Opción | Descripción |
| - | - |
| `--status <status>` | Nuevo estado: `resolved`, `unresolved`, `archived` **(obligatorio)** |

```bash Ejemplos 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

Elimina una o más conversaciones. Pide confirmación a menos que se pase `--yes`. Cada hilo se elimina de forma individual y se informa de los fallos parciales.

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

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

Uno o más ID de hilo que se eliminan (separados por espacios).

| Opción | Descripción |
| - | - |
| `-y, --yes` | Omite la confirmación |

```bash Ejemplos 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
```

***

## Respuestas

### inbox:reply

Responde a una conversación con texto, archivos o ambos. Se requiere al menos una de las opciones `--message`, `--image`, `--video`, `--audio` o `--file`. Las opciones multimedia se envían como adjuntos tipados (`image`, `video`, `audio`, `document`).

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

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

ID del hilo de la conversación a la que se responde.

| Opción | Descripción |
| - | - |
| `--message <text>` | Texto de la respuesta |
| `--image <urls...>` | URL de imágenes que se adjuntan (separadas por espacios) |
| `--video <url>` | URL del vídeo que se adjunta |
| `--audio <url>` | URL del audio que se adjunta |
| `--file <url>` | URL del documento que se adjunta |

```bash Ejemplos 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 😊"
```

***

## Suscripciones

Estos comandos aceptan un ID de cuenta (UUID) o el nombre de una plataforma (p. ej. `twitter`, `facebook`). Cuando un nombre de plataforma coincide con varias cuentas conectadas, la CLI te pide que elijas una. Si no existe ninguna cuenta coincidente, `inbox:subscribe` / `inbox:unsubscribe` terminan correctamente con una indicación para conectar una primero.

### inbox:subscribe

Activa la bandeja de entrada de una cuenta social para que empiece a recibir mensajes, comentarios y menciones.

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

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

ID de la cuenta (UUID) o nombre de la plataforma (`twitter`, `facebook`, etc.).

```bash Ejemplos 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

Desactiva la bandeja de entrada de una cuenta social.

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

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

ID de la cuenta (UUID) o nombre de la plataforma (`twitter`, `facebook`, etc.).

```bash Ejemplos 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 de la cuenta (UUID) o nombre de la plataforma.

```bash Ejemplo 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 de la cuenta (UUID) o nombre de la plataforma.

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

***

## Respuestas guardadas

Las respuestas guardadas son plantillas de respuesta reutilizables a las que puedes adjuntar archivos y usar en la bandeja de entrada.

### inbox:saved-replies

Lista todas las respuestas guardadas, u obtiene una respuesta guardada concreta por ID.

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

**id** `string`

ID opcional de una respuesta guardada. Si se indica, devuelve los detalles de esa respuesta; si no, lista todas las respuestas guardadas.

```bash Ejemplos 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

Crea una respuesta guardada con texto, archivos o ambos. Se requiere al menos una de las opciones `--text` o `--file`.

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

| Opción | Descripción |
| - | - |
| `--text <text>` | Texto de la respuesta |
| `--file <file-ids...>` | ID de archivos que se adjuntan (máx. 4 imágenes, separados por espacios) |

```bash Ejemplos 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

Edita una respuesta guardada. Se requiere al menos una de las opciones `--text` o `--file`.

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

**id** `string` *required*

ID de la respuesta guardada que se actualiza.

| Opción | Descripción |
| - | - |
| `--text <text>` | Nuevo texto de la respuesta |
| `--file <file-ids...>` | Nuevos ID de archivos (sustituyen a los existentes, máx. 4 imágenes, separados por espacios) |

```bash Ejemplos 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

Elimina una o más respuestas guardadas. Pide confirmación a menos que se pase `--yes`. Cada respuesta se elimina de forma individual y se informa de los fallos parciales.

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

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

Uno o más ID de respuestas guardadas que se eliminan (separados por espacios).

| Opción | Descripción |
| - | - |
| `-y, --yes` | Omite la confirmación |

```bash Ejemplos 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.