Um limite de armazenamento próprio para cada cliente

Quando você revende e-mail, todos os clientes usam o armazenamento da sua conta. Um cliente muito ativo pode gastar o espaço com que outro contava, e o administrador de cada cliente vê o total da sua conta como se fosse dele.

Um limite de armazenamento dá aos domínios de um cliente uma quantidade de espaço própria, por exemplo 50 GB. O e-mail e o Drive desses domínios contam para esse limite, e os administradores do cliente o dividem entre as caixas deles, do mesmo jeito que você divide a sua conta.

Por que definir um limite

• Um tamanho que você pode vender. Os tamanhos de caixa que o cliente distribui nunca somam mais do que o limite.
• Menos trabalho para você. Os administradores do cliente cuidam sozinhos do tamanho das caixas. Quando precisam de mais espaço, o painel pede que falem com o administrador deles, sem citar a sua empresa.
• O seu total continua privado. A visão geral deles mostra o limite deles, não a sua conta.
• Um único número para vários domínios. Um limite cobre todos os domínios de um cliente.

Definir um limite

Podem alterar limites o titular da conta e qualquer membro da equipe que gerencie pessoas e alcance todos os domínios. Quem está restrito a alguns domínios, como o administrador do próprio cliente, nunca vê essa configuração.

1. Abra Equipe e clientes.
2. Escolha Editar o acesso na linha do cliente, ou Convidar pessoas para alguém novo.
3. Escolha os domínios da pessoa. A seção Armazenamento aparece assim que ela fica restrita a pelo menos um domínio.
4. Escolha Limite próprio e digite um tamanho em GB, ou clique em 10, 25, 50 ou 100 GB.
5. Salve.

O limite cobre todos os domínios da lista dessa pessoa. Se outra pessoa da equipe tiver um desses domínios, ela aparece em Também vale para, porque divide o mesmo limite.

Uma barra mostra quanto os domínios já ocupam. O limite não pode ficar abaixo dos tamanhos fixos e dos convites pendentes desses domínios, nem abaixo do que eles já armazenam. Embaixo do campo, a janela explica qual dos dois vale, e os tamanhos rápidos abaixo desse mínimo ficam em cinza.

Nada do armazenamento é salvo se você não escolher: clique em um cartão, digite um tamanho ou escolha um tamanho rápido. Editar depois a função ou as permissões de alguém não mexe no limite dessa pessoa.

Se os domínios escolhidos estiverem em parte sob um limite e em parte não, nenhum cartão fica selecionado e um aviso informa isso. Escolha Limite próprio para colocar todos sob esse limite, ou Armazenamento da conta para remover o limite.

Quando você desmarca um domínio que está sob um limite, a janela informa o que vai acontecer ao salvar: o domínio sai do limite, ou continua nele porque outra pessoa ainda o tem.

Para remover um limite, escolha Armazenamento da conta e salve. Antes, a janela mostra os domínios e as pessoas afetadas. As caixas mantêm os tamanhos fixos, e as que usam armazenamento compartilhado voltam a usar o espaço livre da sua conta.

A lista de Equipe e clientes mostra uma coluna Armazenamento: o uso em relação ao limite, por exemplo "3.4 GB de 50 GB", Armazenamento da conta quando não há limite, ou Por domínio quando os domínios de alguém têm configurações diferentes. As mudanças de armazenamento feitas aqui aparecem na linha do tempo da equipe.

Um limite cujos domínios ninguém da sua equipe tem, por exemplo um criado pela API antes de você convidar o cliente ou um que ficou depois de você removê-lo, aparece abaixo da lista em Limites de armazenamento sem cliente, onde você pode alterar o tamanho dele ou removê-lo.

O que o administrador do cliente vê

Quando todos os domínios de uma pessoa dividem um único limite e esse limite não cobre nenhum outro domínio:

• Visão geral. O cartão Armazenamento traz o título Seu limite de armazenamento e mede o e-mail e o Drive dos domínios dele em relação a esse limite. Ele mostra Enchendo em 75% e Quase cheio em 90%, e sugere liberar espaço ou pedir mais ao administrador.
• Tamanho das caixas. Em Editar armazenamento, e ao criar uma caixa ou convidar alguém, o espaço disponível mostrado é o que ainda resta no limite, nunca mais do que resta na sua conta.
• Grande demais. Um tamanho que não cabe mostra "Isso é mais do que o seu limite de armazenamento permite. Para ter mais espaço, fale com o seu administrador."
• Drive. A função Cliente não inclui mais o Drive da conta, então o Drive não aparece no menu do painel dele. Cada caixa continua com o próprio Drive no webmail.

Se os domínios de uma pessoa estiverem em limites diferentes, se alguns não tiverem limite ou se o limite dela também cobrir um domínio que ela não tem, a visão geral dela mostra o armazenamento da conta, como antes. Mantenha todos os domínios de um cliente em um único limite e dê aos administradores dele todos esses domínios.

Quando você, ou qualquer pessoa que possa alterar limites, escolhe um tamanho que não cabe, a mensagem informa quanto resta no limite e que você pode aumentá-lo em Equipe e clientes.

E-mails conforme o limite enche

Quando um limite chega a 75%, 90% e 100%, as pessoas do cliente que gerenciam caixas recebem um e-mail. Em 90% e 100%, você também recebe um. Os dois primeiros são os mesmos pontos em que a visão geral delas mostra Enchendo e Quase cheio.

Quem recebe do lado do cliente. Pessoas do lado do cliente, restritas aos domínios desse cliente, que têm todos os domínios do limite e podem gerenciar caixas: as funções Cliente e Operador de caixas, e uma função Personalizada que permita gerenciar caixas. Não recebem: pessoas com Administrador de domínio, Somente leitura ou Apenas webmail, quem ainda não aceitou o convite e quem está com o acesso suspenso. As pessoas da sua própria equipe que alcançam todos os domínios recebem, em vez disso, o e-mail para você, se puderem alterar limites.

O que ele diz. O assunto é "Seu armazenamento está 75% cheio", "Seu armazenamento está quase cheio" ou "Seu armazenamento está cheio". O e-mail:

• informa quanto está em uso, por exemplo "38 GB de 50 GB", e quais domínios dividem o espaço;
• lista até três caixas que mais ocupam espaço, com o tamanho de cada uma;
• em 90%, avisa que algumas caixas vão parar de receber e-mails novos quando o espaço acabar, e em 100%, que algumas podem não receber e-mails novos até que se libere espaço;
• explica como liberar espaço: excluir mensagens antigas e anexos grandes, esvaziar a Lixeira e remover arquivos do Drive que não são mais necessários;
• orienta a pedir mais espaço ao administrador, se precisar, sem citar a sua empresa;
• tem um botão Abrir caixas de e-mail que abre Caixas de e-mail no painel delas.

Com qual marca ele chega. O e-mail tem a aparência do painel para onde leva. Quando o domínio do cliente tem um endereço de painel ativo com a sua marca, o e-mail mostra o nome, o logotipo e as cores da sua marca, sai do seu Endereço de remetente, se você tiver definido um, e as respostas vão para o seu Endereço de resposta (reply-to). O botão abre o seu painel com a sua marca. Sem marca no domínio, é um e-mail comum do TrekMail, como o painel delas. Cada pessoa recebe o e-mail no próprio idioma ou, se não tiver escolhido um, no idioma do titular da conta.

O e-mail para você. O titular da conta, e qualquer pessoa da sua equipe que possa alterar limites, recebe um e-mail em 90% e 100%. É um e-mail do TrekMail, como o restante dos e-mails da sua conta. O assunto é "O armazenamento de um cliente está quase cheio" ou "O armazenamento de um cliente está cheio", seguido do domínio do cliente. Ele cita os domínios do limite, mostra o quanto o limite está cheio, por exemplo "47 GB de 50 GB", e quais pessoas do cliente foram avisadas. O botão Abrir Equipe e clientes leva você até onde dá para aumentar o limite.

Com que frequência.

• Um e-mail cada vez que o uso passa de 75%, 90% ou 100%. Não há lembretes semanais.
• Se o uso passar de mais de um desses pontos entre duas verificações, sai só um e-mail, sobre o mais alto.
• O mesmo e-mail só volta depois que o uso cai pelo menos 5 pontos abaixo desse ponto e sobe de novo. Por exemplo, depois do e-mail de 90%, o cliente libera espaço até 80%; se mais tarde o uso voltar a 90%, chega um novo e-mail.
• O uso é verificado algumas vezes por dia, depois que o espaço ocupado pelos e-mails é recalculado. Esse cálculo pode atrasar algumas horas, então um e-mail pode chegar algumas horas depois que o uso atinge esse ponto.
• Não é possível cancelar a inscrição nesses e-mails.

Armazenamento compartilhado e tamanhos fixos dentro de um limite

Dentro de um limite, as caixas funcionam como na sua conta, um nível abaixo:

• Tamanho fixo. Uma caixa com tamanho próprio reserva esse espaço no limite, para os e-mails e os arquivos do Drive dela. Tamanhos fixos e convites pendentes nunca somam mais do que o limite.
• Armazenamento compartilhado. Uma caixa com Armazenamento compartilhado marcado usa o espaço livre do limite: o limite menos os tamanhos fixos, nunca mais do que resta na sua conta.

Aqui há duas regras mais rígidas. Uma caixa não pode ficar menor do que o que já guarda; aumentá-la é possível sempre que o limite tiver espaço. E um tamanho fixo que não cabe no limite é recusado para todos, inclusive para você.

Cada caixa com armazenamento compartilhado tem o próprio teto no espaço livre do limite, como na sua conta. Se várias crescerem ao mesmo tempo, o total delas pode passar do limite, e a coluna Armazenamento mostra isso. Para um teto rígido em uma caixa, dê a ela um tamanho fixo. O uso de e-mail é recontado a cada poucas horas, então os números podem ficar um pouco atrasados.

Drive dentro de um limite

Os arquivos do Drive das caixas de um domínio com limite contam para o limite. Além disso, essas caixas:

• não veem as pastas que você compartilha com todas as caixas, que podem conter arquivos de outros clientes;
• não podem compartilhar as próprias pastas com todas as caixas;
• não conseguem enviar arquivos por apps de sincronização (WebDAV) quando o espaço está cheio. Excluir continua funcionando, então um cliente sem espaço pode liberar espaço pelo app.

O seu próprio Drive da conta ocupa espaço da sua conta, não do limite de nenhum cliente.

API e MCP

Você também pode consultar e definir limites de armazenamento de clientes, e alterar o tamanho de uma caixa, pela API REST e pelo servidor MCP. A mesma regra vale: só quem gerencia pessoas e alcança todos os domínios pode alterar um limite. Veja Gerenciar equipes White Label com API e MCP e a visão geral da API REST.

Endpoints REST, em /api/v1. Os tamanhos são em MB e toda escrita exige o cabeçalho Idempotency-Key:

• GET /white-label/client-limits e GET /white-label/client-limits/{id}: listam os limites ou leem um, com o que está reservado, compartilhado e em uso (members:read).
• POST /white-label/client-limits: dá a domain_ids um limite de storage_limit_mb, ou altera o que eles já dividem (members:write).
• PATCH /white-label/client-limits/{id}: altera o tamanho, o conjunto completo de domínios ou os dois (members:write).
• DELETE /white-label/client-limits/{id}: remove um limite; os domínios dele voltam a usar o armazenamento da sua conta (members:write).
• PATCH /mailboxes/{id}/storage: define storage_allocation_mb com um tamanho fixo, ou null para armazenamento compartilhado (mailboxes:write).

Ferramentas MCP: list_client_limits, set_client_limit e remove_client_limit no conjunto de ferramentas White Label, e set_mailbox_storage. Em um servidor próprio, as três que alteram algo exigem TREKMAIL_ALLOW_DESTRUCTIVE=true, e remove_client_limit também confirm_remove=true.

Erros que você pode receber:

• client_storage_limit_exceeded (422): um tamanho fixo não cabe no que resta do limite; details.available_mb diz quanto cabe.
• client_storage_below_usage (422): a caixa ficaria menor do que o que já armazena; veja details.used_mb.
• client_storage_limit_too_low (422): o limite ficaria abaixo do que os domínios reservam ou armazenam; veja details.minimum_mb.
• client_storage_domains_conflict (409): os domínios estão em limites diferentes.

Perguntas frequentes

Como passo um domínio de um cliente para outro? Tire o domínio da lista do primeiro cliente e salve. A janela informa se o domínio sai do limite dele ou continua nele porque outra pessoa ainda o tem. Depois adicione-o ao segundo cliente. Se esse cliente tiver um limite, escolha Limite próprio e salve para colocar o domínio nesse limite; caso contrário, é só salvar. Siga essa ordem, porque domínios em dois limites diferentes não podem receber um só.

Posso diminuir um limite? Sim, até o maior dos dois valores: os tamanhos fixos e convites pendentes dos domínios dele, ou o que eles já armazenam. Para ir abaixo disso, o cliente precisa antes excluir e-mails ou arquivos, ou passar caixas de tamanho fixo para armazenamento compartilhado.

O que acontece quando o limite enche? Uma caixa com armazenamento compartilhado para de aceitar e-mails quando ocupa todo o espaço livre do limite, e uma caixa com tamanho fixo quando fica cheia. Os remetentes recebem uma mensagem de devolução, e os envios para o Drive são recusados. Ler, baixar e excluir continuam funcionando. E-mails avisam as pessoas do cliente que gerenciam caixas em 75%, 90% e 100%, e você em 90% e 100%, como explicado acima.

E os domínios que o cliente adiciona? Eles entram na lista de domínios do cliente e no limite que os domínios dele dividem.

Preciso do White Label Lite? O limite vale assim que você o salva. Seus clientes podem entrar no seu painel quando o White Label Lite estiver ativo.

Os limites dos meus clientes podem somar mais do que a minha conta tem? Sim. Um limite é um teto, não uma reserva, e nenhum cliente recebe mais do que resta na sua conta.