Boîte de réception

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.

Toutes les commandes acceptent les 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.

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`

Exemples

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

so-me inbox:messages <thread-id>

string

requis

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

Exemples

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

so-me inbox:read <thread-id>

string

requis

ID du fil de la conversation à marquer comme lue.

Exemples

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

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

string

requis

ID du fil de la conversation à mettre à jour.

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

Exemples

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

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

string[]

requis

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

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

Exemples

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

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

string

requis

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

Exemples

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

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

string

requis

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

Exemples

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

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

string

requis

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

Exemples

# 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

requis

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

Exemple

so-me inbox:enable instagram

inbox:disable

Alias de inbox:unsubscribe.

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

string

requis

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

Exemple

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.

so-me inbox:saved-replies [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.

Exemples

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

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)

Exemples

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

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

string

requis

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)

Exemples

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

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

string[]

requis

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

Exemples

# 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

Premiers pas

Publication

AI Studio