ZTeams

Showing 25 of 36 from the live probe.

• Listar Quadros

  Os quadros da comunidade. Cada canal do tipo `board` tem um; o id daqui é o que as outras tools pedem.

• Listar Colunas

  As colunas de um quadro, na ordem em que aparecem. Chame antes de criar ou mover tarefa: `criar_tarefa` e `mover_tarefa` pedem o **id** da coluna, e o nome dela ("A fazer") não serve.

• Listar Tarefas

  As tarefas de um quadro. Vem paginado. `search` filtra por título, do lado do servidor.

• Criar Tarefa

  Cria uma tarefa num quadro. `column` é o **id** da coluna, de `listar_colunas` — não o nome. `due_date` vai em `AAAA-MM-DD`. `assignee_ids` é uma **lista** de ids de conta, como `listar_membros` devolve: uma tarefa pode ser de várias pessoas. Para uma só, mande uma lista de um item; para ninguém, omita. A posição não se escolhe: a tarefa nasce no fim da coluna, e `mover_tarefa` reordena depois.

• Editar Tarefa

  Troca campos de uma tarefa — só os que você mandar. É o gesto de "renomear", "trocar os responsáveis", "pôr prazo": tudo aqui, porque na tela também é o mesmo painel. Campo ausente fica como está. `assignee_ids` é a lista **inteira** de responsáveis, e não quem entra ou sai: mandar `[3, 7]` numa tarefa que era do 3 acrescenta o 7; mandar `[7]` tira o 3. Para deixar sem ninguém, mande a lista vazia (`[]`) — que é diferente de omitir o campo, e é o que substituiu o antigo `0`. A coluna **não**

• Mover Tarefa

  Move a tarefa para uma coluna, opcionalmente depois de outra tarefa. `column` é o id da coluna de destino. `after` é o id da tarefa que deve ficar **acima** desta; sem ele, vai para o fim da coluna. É rota própria e não um `editar_tarefa` porque mover recalcula a posição das vizinhas — a mesma razão pela qual `position` é somente leitura no serializer.

• Comentar Tarefa

  Comenta numa tarefa. O comentário entra no histórico dela, com o seu nome. O comentário é uma linha de atividade, não um objeto próprio — na tela ele aparece na mesma lista das mudanças de coluna e de responsável, que é o que faz o painel contar a história da tarefa em ordem.

• Listar Canais

  Os canais da comunidade a que esta pessoa tem acesso. O que volta já é o recorte dela: canal privado de que ela não participa simplesmente não aparece. Não conclua que um canal não existe por não estar aqui — pode ser falta de acesso. `search` filtra por nome, e é do servidor.

• Criar Canal

  Cria um canal na comunidade desta chave. `kind` escolhe o que o canal é, e não se troca depois: text, dm, board, course, database, notes, showcase, group. Um canal `board` nasce com as colunas padrão; um `database` nasce com a base; um `notes` nasce como workspace vazio. `is_private` verdadeiro cria com lista de participantes — quem não estiver nela não vê o canal. `category` é o id de uma categoria existente; sem ele o canal nasce fora de categoria.

• Arquivar Canal

  Manda um canal para a lixeira, ou o traz de volta. Arquivado, o canal **sai do produto**: não aparece na barra, na busca, nos avisos nem nas listagens, para ninguém. Nada é apagado — mensagem, tarefa, nota e participante ficam onde estavam, e desarquivar devolve o canal exatamente como ele era. `archived=false` desarquiva. É o mesmo gesto nos dois sentidos, e por isso não há tool separada. Repetir é seguro: arquivar o que já está arquivado (ou desarquivar o que está vivo) responde o canal com

• Listar Bases

  As bases da comunidade. Cada canal do tipo `database` tem uma.

• Listar Propriedades

  As colunas de uma base: nome, tipo e, nas de escolha, as opções. **Chame antes de criar ou editar registro.** O valor de um registro é indexado pela `key` da propriedade (seis caracteres), não pelo nome dela — e numa propriedade de escolha o valor é o **id da opção**, não o texto. Sem esta chamada, o palpite erra nos dois.

• Listar Registros

  As linhas de uma base, paginadas. `search` filtra pelo título, do lado do servidor.

• Criar Registro

  Cria uma linha numa base. `values` é indexado pela `key` da propriedade — por exemplo `{"a1b2c3": "Contrato Acme", "d4e5f6": "aberto"}`. Numa propriedade de escolha, o valor é o **id da opção**; numa de data, `AAAA-MM-DD`. Use `listar_propriedades` primeiro. O servidor valida cada valor contra o tipo da propriedade e recusa a linha inteira se um deles não servir — não grava metade.

• Editar Registro

  Troca valores de uma linha — só as propriedades que você mandar. O que não vier em `values` fica como está. Para **limpar** um valor, mande `null` naquela chave.

• Quem Sou Eu

  Quem é a pessoa desta chave: nome, e-mail e se ela precisa resolver algo antes de usar o sistema. Use no começo de uma sessão para saber em nome de quem você está agindo. Se a resposta disser que a senha precisa ser trocada, **pare** e diga isso — nenhuma outra tool vai funcionar até lá.

• Minha Comunidade

  A comunidade desta chave, com as permissões que a pessoa tem nela. A chave vale para **uma** comunidade, escolhida quando ela foi emitida — não há como trocar de comunidade no meio da sessão, e não há parâmetro para isso. Se precisar agir em outra, a pessoa emite outra chave. O campo `my_permission_keys` diz o que ela pode fazer ali. Consulte-o antes de prometer uma ação.

• Ler Conversa

  As mensagens de um canal, das mais recentes para as mais antigas. `before` é o id de uma mensagem: devolve as anteriores a ela, e é assim que se sobe no histórico. Sem ele, vem o fim da conversa. Ler **não** marca como lida: quem marca é a tela de quem está olhando. Um agente lendo o canal não zera o contador de não-lidas de ninguém.

• Enviar Mensagem

  Envia uma mensagem num canal. A mensagem sai com o nome da pessoa desta chave — não há remetente "robô". Quem lê vai ver que foi ela, então diga a ela o que você está mandando antes de mandar. Menção a pessoa vai como `<@id-do-vínculo>` e a cargo como `<@&id-do-cargo>`; o texto cru aparece como o nome na tela. Mencionar todos exige a permissão `chat.mention_everyone`.

• Responder Mensagem

  Responde a uma mensagem, citando-a. `reply_to` é o id da mensagem citada. A citação aparece dentro da bolha, com o trecho do original — é o que faz a resposta se explicar sozinha três dias depois.

• Guia Do Workspace

  O dialeto markdown deste Workspace: propriedades, assuntos, [[links]], nomes, callouts, bases. **Leia antes de escrever a primeira nota.** O corpo é markdown, e várias construções daqui não são GFM padrão — escrever de memória produz nota que a tela mostra como texto cru. Sem `topico`, vem o índice com todos. A resposta lista os tópicos válidos.

• Buscar Notas

  Procura o termo no **título e no corpo** de todas as notas e devolve as mais relevantes com o trecho. Ignora acento e caixa, e exige **todas** as palavras do termo. Entre aspas, `"assim exato"`, casa a frase na ordem. Acerto no título vale mais que no corpo. Plural regular acha singular (`contratos` acha `contrato`). ⚠️ **Plural em `-ões` não**: `reuniões` e `reunião` são radicais diferentes — se o termo termina em `-ão` ou `-ões` e vier pouco, tente a outra forma. `total` diz quantas notas c

• Arvore Do Workspace

  A hierarquia como contorno indentado, com a chave de cada nota e quantas filhas cada uma tem. `sob` abre um ramo (nome, caminho ou chave); sem ele, começa na raiz. `profundidade` limita os níveis. ⚠️ Serve para **navegar**, não para despejar: um Workspace grande não cabe numa resposta. Onde parou, a linha diz `(N)` — o número de filhas que não desceram — e `completa` fica falsa.

• Mudancas No Workspace

  O que mudou desde uma data — responde "o que é novo desde ontem" sem reler o Workspace. `desde` em ISO: `2026-08-20` ou `2026-08-20T14:00:00Z`. Compara a data de atualização, então nota criada e nota editada aparecem igual e **não há como distinguir uma da outra** aqui. Comentário e anexo novos não contam como mudança da nota. Arquivada fica fora.

• Rascunhos Do Workspace

  Os rascunhos: nomes que alguém citou com [[…]] e que ainda não são nota. Uma linha por nome, com quem o cita — três notas pedindo a mesma coisa são um pedido, não três. É a lista de "o que falta escrever".