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

# Suporte

> Abra e gerencie tickets de suporte da central de ajuda pelo terminal

Os comandos de suporte encapsulam a API `/v1/support/*`. Pelo terminal você pode listar seus tickets
de suporte, abrir um novo ticket, buscar os detalhes de um ticket e ler ou enviar mensagens na
conversa de um ticket.

> [!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 se autenticar com
> as variáveis de ambiente `SOME_API_KEY` e `SOME_API_URL`.

## support:list-tickets

Lista os seus tickets de suporte.

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

| 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 support:list-tickets

# Visualização em tabela
so-me support:list-tickets --table

# Paginar
so-me support:list-tickets --page 2 --limit 50

# Mostrar apenas tickets abertos de alta prioridade via jq
so-me support:list-tickets --limit 100 | jq '.data[] | select(.priority == "HIGH")'
```

## support:create-ticket

Cria um novo ticket de suporte. As opções `--subject` e `--message` são obrigatórias; `--priority`
assume `MEDIUM` se for omitida.

```bash theme={null}
so-me support:create-ticket --subject <text> --message <text> [options]
```

| Opção | Descrição | Padrão |
| - | - | - |
| `--subject <text>` | Assunto do ticket **(obrigatório)** | — |
| `--message <text>` | Mensagem do ticket **(obrigatório)** | — |
| `--priority <level>` | Prioridade: `LOW`, `MEDIUM` ou `HIGH` | `MEDIUM` |

```bash Exemplos theme={null}
# Ticket mínimo (prioridade MEDIUM por padrão)
so-me support:create-ticket \
  --subject "Cannot connect Instagram account" \
  --message "OAuth fails with an invalid redirect error after granting access."

# Ticket de alta prioridade
so-me support:create-ticket \
  --subject "Posts stuck in queue" \
  --message "All scheduled posts have been pending for 2 hours." \
  --priority HIGH

# Capturar o ID do novo ticket para acompanhamento
TICKET_ID=$(so-me support:create-ticket \
  --subject "Billing question" \
  --message "I was charged twice this month." \
  --priority LOW | jq -r '.data.id')
echo "Created ticket $TICKET_ID"
```

## support:get-ticket

Obtém os detalhes e o status de um ticket de suporte.

```bash theme={null}
so-me support:get-ticket <id>
```

**id** `string` *required*

O UUID do ticket (obtido em [`support:list-tickets`](#supportlist-tickets)).

```bash Exemplos theme={null}
# Buscar um ticket pelo ID
so-me support:get-ticket 550e8400-e29b-41d4-a716-446655440000

# Visualização em tabela
so-me support:get-ticket 550e8400-e29b-41d4-a716-446655440000 --table

# Mostrar somente o status
so-me support:get-ticket 550e8400-e29b-41d4-a716-446655440000 | jq -r '.data.status'
```

## support:send-message

Envia uma mensagem para a conversa de um ticket existente. A opção `--message` é obrigatória.

```bash theme={null}
so-me support:send-message <id> --message <text>
```

**id** `string` *required*

O UUID do ticket (obtido em [`support:list-tickets`](#supportlist-tickets)).

| Opção | Descrição |
| - | - |
| `--message <text>` | Texto da mensagem **(obrigatório)** |

```bash Exemplos theme={null}
# Responder a um ticket
so-me support:send-message 550e8400-e29b-41d4-a716-446655440000 \
  --message "Thanks — the issue is resolved on my end now."

# Enviar uma atualização com várias linhas
so-me support:send-message 550e8400-e29b-41d4-a716-446655440000 \
  --message "Still seeing the error.
Steps to reproduce:
1. Open the composer
2. Attach an image"
```

## support:list-messages

Lista todas as mensagens da conversa de um ticket.

```bash theme={null}
so-me support:list-messages <id>
```

**id** `string` *required*

O UUID do ticket (obtido em [`support:list-tickets`](#supportlist-tickets)).

```bash Exemplos theme={null}
# Ler a conversa completa
so-me support:list-messages 550e8400-e29b-41d4-a716-446655440000

# Visualização em tabela
so-me support:list-messages 550e8400-e29b-41d4-a716-446655440000 --table

# Imprimir somente o corpo das mensagens, em ordem
so-me support:list-messages 550e8400-e29b-41d4-a716-446655440000 \
  | jq -r '.data[] | "\(.createdAt)\t\(.message)"'
```


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