Organizações
Convide pessoas e organize equipes.
Na Siglata, cada pessoa da organização tem uma função, como owner, admin ou member, e o agente dela trabalha só dentro dessa função e dos arquivos e pastas a que ela tem acesso. Proprietários e administradores convidam membros, mudam funções e organizam equipes pelo agente.
A organização tem quantos membros quiser. O agente convida, lista e remove membros e muda o papel de cada um com invitation_create, invitation_cancel, members_list, member_update_role e member_remove, e também renomeia a organização. Para sair da organização ou excluí-la, use a página Conta do Console.
Equipes
Proprietários e administradores agrupam membros em equipes e compartilham arquivos e pastas com a equipe inteira de uma vez.
- O agente cria, renomeia e exclui equipes e marca quem faz parte de cada uma com
teams_list,team_seteteam_delete. - Uma organização começa sem equipes, e cada membro pode estar em várias.
- Conceda uma pasta ou um arquivo a uma equipe com
grant_setegranteeType: "team". O acesso segue os membros atuais da equipe: quem entra passa a abrir o que ela recebeu, e quem sai deixa de abrir na requisição seguinte. Se não for possível confirmar de quais equipes alguém faz parte, a requisição é recusada.
Perguntas frequentes
O agente vê arquivos que eu não posso abrir?
Não. O agente usa a função e os acessos de quem aprovou a conexão. Um item restricted que você não pode ler também não aparece nas listagens do seu agente.
Quem pode convidar, remover membros ou mudar funções?
Proprietários e administradores, com o escopo members:write aprovado na conexão. Um membro com a função member não faz essas operações, mesmo que a conexão peça o escopo.
O que acontece quando alguém sai da organização?
Os arquivos ficam na organização, e as conexões dos agentes dessa pessoa param de funcionar na próxima requisição.
Como dou acesso a uma pasta para uma equipe inteira?
Peça ao agente para conceder a pasta à equipe. Ele usa grant_set com granteeType: "team", e quem entra na equipe depois passa a abrir a pasta. Veja Pastas e controle de acesso.