# Organizações

> URL: https://foura.ai/pt/docs/dashboard/teams-and-orgs
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

Uma organização agrupa credenciais sob um único proprietário para que várias pessoas possam compartilhá-las: API keys para a API JSON e usuários de proxy para a [proxy port](https://foura.ai/docs/api/proxy-port). Tudo o que as credenciais de uma organização consomem é cobrado no plano do proprietário da organização, não de quem disparou a request.

## Onde encontrar

Faça login no [dashboard](https://foura.ai/dashboard) e abra **Organizations** na barra lateral. Cada organização à qual você pertence é uma linha:

| Coluna | O que exibe |
|--------|---------------|
| Organization | O nome. Clique nele, ou em **Open**, para ir à página da organização. |
| Your role | Owner, Admin ou Member |
| Members | Quantas pessoas estão nela, incluindo o proprietário |
| Keys | Quantas API keys a organização possui |
| Created | Quando foi criada |
| Actions | **Open** |

## Como criar uma organização

Clique em **New organization**, insira um nome entre 2 e 60 caracteres e confirme. Você se torna o proprietário. O nome pode usar letras, números, espaços e . , & + ( ) - _ ', até oito palavras, sem endereço web, e a mesma regra se aplica ao renomeá-la. Ele deve conter pelo menos uma letra latina (a a z) ou dígito, e não pode coincidir com o nome de uma organização existente (apenas letras latinas e dígitos são comparados, ignorando maiúsculas e minúsculas; todo o resto é desconsiderado).

Criar uma organização requer um plano que cubra mais de uma pessoa. A linha **Organizations you own** em [Usage & Limits](https://foura.ai/docs/dashboard/quota) mostra se o seu plano permite.

## Funções

Existem três, e cada organização tem exatamente um proprietário.

| Função | O que pode fazer |
|------|----------------|
| Member | Criar e usar as API keys e usuários de proxy da organização, renomear suas API keys e ver os membros e times da organização |
| Admin | Tudo o que um membro pode fazer, além de adicionar e remover pessoas, alterar suas funções, gerenciar todas as credenciais da organização e renomear a organização |
| Owner | Tudo o que um admin pode fazer, além de transferir a organização para outra pessoa. O proprietário mantém o plano no qual todas as credenciais da organização são faturadas. |

O proprietário não pode ser removido, não pode sair e não pode ser rebaixado. A propriedade muda em apenas uma direção: por transferência.

Estar na organização é o que concede acesso às credenciais dela. Um membro sem direitos de admin ainda pode criar uma chave ou um usuário de proxy pago pela empresa, que é o objetivo: um desenvolvedor escrevendo coletores não deve precisar de uma credencial pessoal que cobre dele silenciosamente em vez da empresa.

## A página da organização

**Open** em qualquer linha leva você à página dessa organização. Seis cards ficam no topo: Members (com a divisão entre owner, admin e member abaixo), Your role, Owner, API keys, Proxy users e Teams. Abaixo deles, duas abas:

- **Members**: as pessoas na organização, além dos controles que a sua função permite.
- **Teams**: os times aos quais você pertence dentro desta organização, somente leitura.

Proprietários e admins também têm um botão **Rename** no cabeçalho da página.

## Como adicionar pessoas

Proprietários e admins veem um card **Add a member** acima da tabela Members. Digite um endereço de email, selecione **Member** ou **Admin** e confirme.

O que acontece a seguir depende do endereço, e o dashboard informa o caso correspondente:

- O endereço já tem uma conta FourA: a pessoa entra imediatamente e recebe um email informando a organização, quem a adicionou e o que a função dela permite fazer.
- O endereço não tem conta: o FourA envia um convite por email e ela entra assim que fizer login com esse endereço. Não é preciso clicar em nada, e o convite funciona tanto se ela criar uma conta nova quanto se já tiver uma conta que nunca abriu.

Os convites expiram após 14 dias. Adicionar o mesmo endereço novamente não acumula um segundo convite. O FourA envia um convite por endereço e organização a cada 24 horas (um convite cancelado também conta): uma segunda tentativa dentro dessa janela é recusada com **We already sent an invitation to this address today. Try again tomorrow.**, e o convite já enviado permanece válido. Cada pessoa pode enviar 20 convites em 24 horas considerando todas as suas organizações.

O proprietário recebe um email sempre que alguém entra, pois o novo integrante consome os créditos do proprietário. Ninguém recebe email confirmando a própria ação.

### Convites Pendentes

Enquanto houver pelo menos um convite aberto, uma tabela **Invitations** fica visível para proprietários e admins acima de Members. Ela lista o endereço, a função atribuída, quem convidou e a data. Convites expirados continuam listados e marcados para você identificar por que ninguém entrou. Use a ação na linha correspondente para cancelar um convite.

## Alterar uma Função

Proprietários e admins alteram a função de um membro entre **Member** e **Admin** usando o menu suspenso na coluna Role. Três regras:

- Você não pode alterar sua própria função. Peça a outro admin ou saia da organização.
- A função do proprietário não pode ser editada aqui. Use **Make owner** em vez disso.
- Toda alteração solicita confirmação prévia e descreve as permissões que a pessoa terá depois.

## Remover Alguém e Sair da Organização

Proprietários e admins têm o botão **Remove** em todas as linhas, exceto na sua própria e na do proprietário. Na sua própria linha é exibido **Leave**, a menos que você seja o proprietário: a linha do proprietário exibe **Carries the billing**.

Remover alguém também retira o usuário dos times da organização, interrompendo imediatamente o acesso às credenciais correspondentes. As credenciais em si não são afetadas: a chave ou o usuário proxy de uma organização pertence à organização, não a quem o criou.

O proprietário não pode ser removido nem pode sair. É necessário transferir a organização primeiro.

## Transferir a Organização

Apenas o proprietário pode fazer isso. Na aba Members, clique em **Make owner** na pessoa que vai assumir e confirme.

A organização migra para o plano dessa pessoa: a partir desse momento, cada request de suas chaves e cada túnel aberto por seus usuários proxy consome créditos, tráfego, limites e fatura dela. O proprietário anterior se torna admin e mantém todas as permissões dessa função.

## Quais Chaves Você Visualiza

Toda chave pertencente a uma organização fica visível para todos os membros da organização. O que varia é o que você pode fazer com ela:

| Ação | Membro | Admin | Proprietário |
|--------|--------|-------|-------|
| Usar a chave, revelá-la, criar novas chaves da organização | Sim | Sim | Sim |
| Renomeá-la, editar sua descrição | Sim | Sim | Sim |
| Gerar novamente, desativar, excluir | Não | Sim | Sim |
| Mover a chave para fora da organização | Não | Não | Sim |

Renomear uma chave é inofensivo. Gerar novamente ou desativar uma chave interrompe o uso por qualquer colega no mesmo instante, e é por isso que essas ações ficam com admins. Mover uma chave para fora remove o recurso da empresa e transfere seu uso para o plano do próprio destinatário, por isso essa ação fica exclusivamente com o proprietário.

Consulte [Managing API Keys](https://foura.ai/docs/dashboard/api-keys) para ver o passo a passo completo.

## Quais usuários de proxy você vê

Um usuário de proxy segue os mesmos três níveis, pelos mesmos motivos.

| Ação | Membro | Admin | Proprietário |
|--------|--------|-------|-------|
| Usar, ler a senha, criar novos | Sim | Sim | Sim |
| Nova senha, desativar, excluir, alterar o direcionamento salvo | Não | Sim | Sim |
| Transferir para fora da organização | Não | Não | Sim |

O direcionamento salvo fica com admins em vez de membros porque redirecioná-lo altera silenciosamente todas as conexões que a organização inteira faz usando essa credencial. Uma nova senha fica com admins porque quebra todos os arquivos de configuração onde a credencial já foi inserida.

O downloader de uma empresa deve usar um usuário de proxy da organização. Um usuário de proxy pessoal para de funcionar no dia em que a pessoa sai da empresa, além de ser faturado para ela. Consulte [Proxy Users](https://foura.ai/docs/dashboard/proxy) para ver o passo a passo.

## O filtro de proprietário

Assim que você passa a pertencer a uma organização, um menu suspenso de **Proprietário** é exibido acima de Overview, Metrics, Activity, API Keys e Proxy. Ele oferece três tipos de opção: **Tudo**, **Pessoal** e uma entrada para cada organização. A escolha permanece salva entre visitas e se aplica a todas essas cinco páginas.

[Usage & Limits](https://foura.ai/docs/dashboard/quota) e [Billing](https://foura.ai/docs/dashboard/billing) deliberadamente não recebem o filtro. Essas seções respondem a "o que é faturado para mim", o que é diferente de "o que posso visualizar": um membro nunca vê a cota do proprietário.

## Atribuição de faturamento

Toda request feita com uma chave da organização e todo túnel aberto com um usuário de proxy da organização são cobrados do **proprietário da organização**, não importa quem tenha disparado a ação. Esse é o principal motivo para transferir uma credencial para uma organização: isso define quem absorve o uso em termos de créditos, tráfego, limites do plano e faturas.

A página [Usage & Limits](https://foura.ai/docs/dashboard/quota) do proprietário contabiliza credenciais da organização ao lado das pessoais, tanto na guia de API keys quanto na de usuários de proxy, e separa os dois grupos para deixar claro de onde veio o gasto.

## Times

Toda organização recebe um time padrão chamado **Everyone**. Novas chaves são atribuídas a ele automaticamente e qualquer pessoa que entra na organização é adicionada a ele, permitindo que a associação conceda acesso às chaves.

A aba Teams lista as equipes às quais você pertence, com a sua função em cada uma, a contagem de membros e as chaves que ela permite usar (**Keys you can use**). A criação e a edição de equipes ainda não estão disponíveis no dashboard.

## Relacionados

- [Gerenciando API Keys](https://foura.ai/docs/dashboard/api-keys): Crie, transfira e gerencie chaves dentro de uma organização
- [Usuários de Proxy](https://foura.ai/docs/dashboard/proxy): Crie e transfira usuários de proxy dentro de uma organização
- [Uso e Limites](https://foura.ai/docs/dashboard/quota): Membros da equipe, organizações e o que o seu plano permite
- [Faturamento e Assinaturas](https://foura.ai/docs/dashboard/billing): Como o plano do proprietário cobre o uso de chaves da organização
- [Visão Geral do Dashboard](https://foura.ai/docs/dashboard/overview): Todas as seções do dashboard
