# Circleback CLI (/docs/pt/support/platform/circleback-cli)

Acesse tudo pela linha de comando ou forneça aos seus agentes de IA o contexto de conversas de que eles precisam para realizar tarefas. Peça ao OpenClaw para dar andamento aos itens de ação do standup desta manhã. Deixe o Claude Code redigir uma especificação com base na sua última revisão de produto.

## Configuração

Comece instalando a [Circleback CLI](https://www.npmjs.com/package/@circleback/cli):

```
npm install -g @circleback/cli
```

Em seguida, faça login na sua conta do Circleback:

```
cb auth login
```

Isso abre uma janela do navegador para fazer login. Depois de fazer login, você já pode começar.

Para fazer login com uma chave de API:

```
cb auth login --api-key
```

O login com chave de API leva a [**Configurações → Chaves de API**](https://circleback.ai/settings?tab=api-access), verifica a chave e a armazena localmente no seu dispositivo.

Para automação sem estado, defina `CIRCLEBACK_API_KEY` em vez de fazer login:

```
CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
```

`CIRCLEBACK_API_KEY` tem precedência sobre as credenciais armazenadas.

Para sair neste dispositivo:

```
cb auth logout
```

## O que você pode fazer

A Circleback CLI tem comandos para pesquisar, acessar e atualizar dados da sua conta do Circleback, como reuniões, transcrições, eventos de calendário, e-mails, pessoas, empresas e muito mais.

| Comando                          | Descrição                                                                                   |
| -------------------------------- | --------------------------------------------------------------------------------------------- |
| `cb auth login`                  | Fazer login no Circleback pelo navegador                                                        |
| `cb auth login --api-key`        | Fazer login com uma chave de API                                                                        |
| `cb auth logout`                 | Sair neste dispositivo                                                                       |
| `cb update`                      | Atualizar a CLI para a versão mais recente                                                              |
| `cb meetings [search]`           | Pesquisar reuniões e transcrições                                                               |
| `cb meetings read <ids...>`      | Ler detalhes, notas e itens de ação de reuniões (até 50 reuniões)                             |
| `cb meetings update <id>`        | Atualizar uma reunião                                                                              |
| `cb meetings share <id>`         | Compartilhar uma reunião com uma pessoa, equipe, espaço de trabalho ou qualquer pessoa com o link, ou remover o acesso        |
| `cb transcripts read <ids...>`   | Obter a transcrição completa de uma ou mais reuniões, com identificação dos falantes e marcações de tempo          |
| `cb action-items [search]`       | Encontrar itens de ação por palavra-chave, status (pendente ou concluído), responsável, tag, empresa ou intervalo de datas |
| `cb action-items create <title>` | Criar um item de ação, atribuído a você, a menos que você defina `--assignee`                            |
| `cb action-items update <id>`    | Atualizar um item de ação                                                                         |
| `cb action-items delete <id>`    | Excluir um item de ação                                                                         |
| `cb calendar`                    | Pesquisar eventos de calendário futuros e passados, incluindo IDs de eventos, participantes e links de reunião   |
| `cb calendar update <id>`        | Atualizar um evento de calendário                                                                       |
| `cb emails [search]`             | Pesquisar threads nas contas de e-mail conectadas por palavra-chave, remetente, destinatário ou intervalo de datas      |
| `cb people <names...>`           | Procurar pessoas pelo nome para ver o perfil delas e o histórico de interações nas reuniões           |
| `cb companies <terms...>`        | Procurar empresas pelo nome ou domínio para encontrar o domínio e as reuniões relacionadas                 |
| `cb teams`                       | Listar seu espaço de trabalho e suas equipes, com os IDs para compartilhamento                                       |
| `cb tags`                        | Listar todas as tags do seu espaço de trabalho, útil para filtrar reuniões, transcrições ou itens de ação  |
| `cb tags create <name>`          | Criar uma tag, opcionalmente com descrição e cor                                         |
| `cb tags update <id>`            | Atualizar o nome, a descrição ou a cor de uma tag                                                    |
| `cb tags delete <id>`            | Excluir uma tag e removê-la de todas as reuniões                                                 |
| `cb folders`                     | Listar as pastas que você pode ver, com seus IDs                                                  |
| `cb folders read <ids...>`       | Obter os membros, as equipes e as regras de uma pasta                                                      |
| `cb folders create <name>`       | Criar uma pasta em um espaço de trabalho                                                                |
| `cb folders update <id>`         | Atualizar o nome, a descrição, o ícone, a cor, a visibilidade ou as regras de uma pasta                        |
| `cb folders delete <id>`         | Excluir uma pasta                                                                               |
| `cb folders share <id>`          | Compartilhar uma pasta com uma pessoa, equipe, espaço de trabalho ou qualquer pessoa com o link, ou remover o acesso         |
| `cb support [search]`            | Pesquisar na documentação de suporte do Circleback por ajuda e guias práticos                            |

## Exemplos

Sem um termo de pesquisa, `cb meetings` abrange os últimos 7 dias (a menos que você use `--folder`) e `cb action-items` os últimos 30. Adicione `--last`, `--from` ou `--to` para pesquisar outro intervalo.

### Reuniões

Encontrar reuniões e trechos de transcrições sobre um tema específico:

```
cb meetings search "product review"
```

Encontrar reuniões dos últimos 7 dias:

```
cb meetings search --last 7
```

Encontrar reuniões em um intervalo de datas:

```
cb meetings search --from 2026-04-01 --to 2026-04-18
```

Encontrar reuniões compartilhadas com você que incluem alguém da Acme:

```
cb meetings search --ownership Shared --domains acme.com
```

Ler todos os detalhes de uma reunião:

```
cb meetings read abc123
```

Ler várias reuniões de uma vez:

```
cb meetings read abc123 def456
```

Compartilhar uma reunião com pessoas por e-mail (separados por vírgula) ou ativar o acesso de visualização pelo link:

```
cb meetings share abc123 --email dana@acme.com,lee@acme.com --access Viewer --send-email
cb meetings share abc123 --link Viewer
```

Remover o acesso de alguém ou desativar o link da própria reunião:

```
cb meetings share abc123 --profile 42 --access none
cb meetings share abc123 --link none
```

Compartilhar uma reunião com uma equipe, usando o ID dela obtido com `cb teams`:

```
cb meetings share abc123 --team 7 --access Viewer
```

Renomear uma reunião:

```
cb meetings update abc123 --name "Pricing sync"
```

### Transcrições

Obter a transcrição completa de uma reunião:

```
cb transcripts read abc123
```

Obter as transcrições de várias reuniões:

```
cb transcripts read abc123 def456
```

### Itens de ação

Encontrar seus itens de ação não concluídos:

```
cb action-items search --status PENDING
```

Pesquisar itens de ação por palavra-chave:

```
cb action-items search "follow up"
```

Encontrar itens de ação concluídos:

```
cb action-items search --status DONE
```

Encontrar itens de ação de reuniões com a Acme, independentemente do responsável:

```
cb action-items search --assignee-type Anyone --domains acme.com
```

Encontrar itens de ação atribuídos a uma das suas equipes (use `cb teams` para encontrar o ID dela):

```
cb action-items search --team 7
```

Criar um item de ação e atribuí-lo a alguém (use `cb people` para encontrar o ID da pessoa). Sem `--assignee`, ele é atribuído a você; use `--assignee none` para deixá-lo sem responsável:

```
cb action-items create "Send the renewal quote" --description "Include 2027 pricing" --assignee 42
```

Vincular um item de ação a uma reunião que você pode editar (use `cb meetings` para encontrar o ID dela):

```
cb action-items create "Send the renewal quote" --meeting abc123
```

Marcar um item de ação como concluído ou remover o responsável:

```
cb action-items update 1234 --status DONE
cb action-items update 1234 --assignee none
```

Excluir um item de ação:

```
cb action-items delete 1234
```

### Calendário

Ver eventos de calendário em um intervalo de datas:

```
cb calendar search --from 2026-04-18 --to 2026-04-25
```

Definir notas de preparação em um evento futuro usando o ID dele obtido com `cb calendar`. Elas aparecem nas suas notas privadas quando a reunião é gravada:

```
cb calendar update event123 --private-notes "Ask about the 2027 pricing"
```

### E-mails

Pesquisar e-mails por palavra-chave:

```
cb emails search "quarterly report"
```

Pesquisar e-mails por participante:

```
cb emails search "participant:sarah@company.com"
```

Pesquisar e-mails de um remetente específico:

```
cb emails search "from:ceo@company.com"
```

Pesquisar e-mails em um intervalo de datas:

```
cb emails search "project update after:2026-01-01 before:2026-04-01"
```

### Pessoas

Procurar uma pessoa:

```
cb people search "Sarah Kerrigan"
```

### Empresas

Procurar uma empresa:

```
cb companies search "Acme"
```

### Tags

Listar todas as tags:

```
cb tags list
```

Criar uma tag e, em seguida, definir as tags de uma reunião por nome ou ID (separados por vírgula; substitui as tags atuais):

```
cb tags create Renewals --color emerald
cb meetings update abc123 --tags Renewals,7
```

Renomear uma tag ou remover todas as tags de uma reunião:

```
cb tags update 7 --name "Q3 renewals"
cb meetings update abc123 --tags ""
```

### Suporte

Pesquisar artigos de suporte do Circleback:

```
cb support search "recording in-person meetings"
```

## Acesso de escrita

Criar, atualizar e excluir exige acesso de escrita. Logins pelo navegador anteriores à v0.5.0 concediam apenas acesso de leitura, então execute `cb auth login` novamente. Chaves de API somente leitura não podem fazer alterações, então use uma chave de leitura e escrita de [**Configurações → Chaves de API**](https://circleback.ai/settings?tab=api-access).

## Opções

Todos os comandos aceitam `--json` para saída em JSON bruto, o que é útil para scripts, para encaminhar a saída a outras ferramentas ou para fornecer dados a agentes de IA.

```
cb meetings search "standup" --last 7 --json
```