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

# Comentários

> Gerencie os comentários de posts pela CLI

Os comentários de post são a conversa de engajamento/anotações de cada post do Social media studio. Estes comandos permitem listar, adicionar, editar, excluir e marcar comentários como lidos.

> [!NOTE]
>
> Todos os comandos aceitam as [flags globais](/pt-BR/cli/overview.md#opções-globais): `--json` (padrão) / `--table`, `--verbose`, `--api-key <key>` e `--api-url <url>`. Você também pode definir `SOME_API_KEY` e `SOME_API_URL` no seu ambiente.

## comments:list

Lista os comentários de um post.

```bash theme={null}
so-me comments:list <post-id> [options]
```

**post-id** `string` *required*

UUID do post cujos comentários você quer listar.

| Opção | Descrição | Padrão |
| - | - | - |
| `--page <number>` | Número da página | `1` |
| `--limit <number>` | Itens por página | `20` |

```bash Exemplos theme={null}
# Saída JSON padrão
so-me comments:list 550e8400-e29b-41d4-a716-446655440000

# Visualização em tabela
so-me comments:list 550e8400-... --table

# Paginar
so-me comments:list 550e8400-... --page 2 --limit 50

# Somente comentários não lidos via jq
so-me comments:list 550e8400-... | jq '.[] | select(.isRead == false)'
```

## comments:add

Adiciona um comentário a um post.

```bash theme={null}
so-me comments:add <post-id> --content <text>
```

**post-id** `string` *required*

UUID do post a comentar.

| Opção | Descrição |
| - | - |
| `--content <text>` | Texto do comentário **(obrigatório)** |

```bash Exemplos theme={null}
# Comentário curto
so-me comments:add 550e8400-... --content "Great post!"

# Comentário com emoji
so-me comments:add 550e8400-... --content "Ship it 🚀"

# Comentário com várias linhas usando aspas do shell
so-me comments:add 550e8400-... --content "Line one
Line two"
```

## comments:update

Atualiza um comentário existente.

```bash theme={null}
so-me comments:update <comment-id> --content <text>
```

**comment-id** `string` *required*

UUID do comentário a atualizar.

| Opção | Descrição |
| - | - |
| `--content <text>` | Novo texto do comentário **(obrigatório)** |

```bash Exemplo theme={null}
so-me comments:update 7c2d4e8f-... --content "Edited: updated thoughts"
```

## comments:delete

Exclui um comentário.

```bash theme={null}
so-me comments:delete <comment-id>
```

**comment-id** `string` *required*

UUID do comentário a excluir.

```bash Exemplos theme={null}
# Excluir um único comentário
so-me comments:delete 7c2d4e8f-...

# Excluir todos os comentários de um post em um único pipeline
so-me comments:list 550e8400-... --limit 100 \
  | jq -r '.[].id' \
  | xargs -I {} so-me comments:delete {}
```

## comments:mark-read

Marca todos os comentários de um post como lidos, o que limpa o indicador de não lidos do seu espaço de trabalho.

```bash theme={null}
so-me comments:mark-read <post-id>
```

**post-id** `string` *required*

UUID do post cujos comentários devem ser marcados como lidos.

```bash Exemplos theme={null}
# Marcar como lidos os comentários de um único post
so-me comments:mark-read 550e8400-e29b-41d4-a716-446655440000

# Marcar como lidos os comentários de todos os posts agendados
so-me posts:list --status SCHEDULED \
  | jq -r '.[].id' \
  | xargs -I {} so-me comments:mark-read {}
```


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