Bandeja de entrada

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.

Todos los comandos aceptan las 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.

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`

Ejemplos

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

so-me inbox:messages <thread-id>

string

requerido

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

Ejemplos

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

so-me inbox:read <thread-id>

string

requerido

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

Ejemplos

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

so-me inbox:resolve <thread-id> --status <status>

string

requerido

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

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

Ejemplos

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

so-me inbox:delete <thread-ids...> [options]

string[]

requerido

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

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

Ejemplos

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

so-me inbox:reply <thread-id> [options]

string

requerido

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

Ejemplos

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

so-me inbox:subscribe <id-or-platform>

string

requerido

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

Ejemplos

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

so-me inbox:unsubscribe <id-or-platform>

string

requerido

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

Ejemplos

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

so-me inbox:enable <id-or-platform>

string

requerido

ID de la cuenta (UUID) o nombre de la plataforma.

Ejemplo

so-me inbox:enable instagram

inbox:disable

Alias de inbox:unsubscribe.

so-me inbox:disable <id-or-platform>

string

requerido

ID de la cuenta (UUID) o nombre de la plataforma.

Ejemplo

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.

so-me inbox:saved-replies [id]

string

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

Ejemplos

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

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)

Ejemplos

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

so-me inbox:edit-reply <id> [options]

string

requerido

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)

Ejemplos

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

so-me inbox:delete-reply <ids...> [options]

string[]

requerido

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

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

Ejemplos

# 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

Primeros pasos

Publicación

AI Studio