Alias de e-mail

Vários endereços entregando na mesma caixa: como o alias funciona, a ordem de entrega no recebimento e o uso entre domínios da mesma conta.

Nesta página

Como funciona
Responder como o alias
No painel (admin.asender)
API (administrador do e-mail ou chave com `mail:admin`)

Alias de e-mail: vários endereços, uma caixa

Um alias é um endereço extra (vendas@empresa.com.br) que entrega na caixa de outra pessoa (ana@empresa.com.br). Quem escreve para o alias recebe resposta normal; você lê tudo numa caixa só e a mensagem mostra "recebido como vendas@…".

Como funciona

O alias aponta para uma caixa real (nunca para outro alias).
O alias pode estar em outro domínio seu, desde que seja da mesma conta.
Ordem no recebimento: caixa com aquele endereço, depois alias, depois catch-all, depois criação automática.
Se o alias e a caixa-destino estiverem entre os destinatários da mesma mensagem, ela chega uma vez só.
Não dá para criar alias num endereço que já é de uma caixa (inclusive de uma caixa que você removeu: restaure-a ou escolha outro), de outro alias, ou identidade de envio de outra caixa.
Caixa de atendimento (com assinatura ativa) ainda não recebe alias.
Para remover uma caixa que tem alias, apague os alias antes (a API responde 409 com o vínculo alias).
Cada caixa pode ter até 50 alias (o limite pode ser ajustado para a sua conta).

Responder como o alias

Ao criar, envie "responder_como": true para poder escolher o alias no campo "De". Isso só vale se o domínio do alias tem o DKIM publicado e é da mesma conta da caixa; caso contrário o alias é criado normalmente, sem a opção de envio, e a resposta explica o motivo (dominio_sem_dkim, org_diferente).

No painel (admin.asender)

Domínios: em cada domínio que recebe, a seção "Alias de recebimento" lista, cria, apaga e (em "Ver apagados") restaura alias, e mostra o limite por caixa. A caixa-destino pode ser de outro domínio da conta.
Caixas: sob cada caixa, "Alias de recebimento" mostra os alias que entregam nela e permite apagá-los.
Endereço apagado: ainda em Domínios, "Mensagem para endereço apagado" escolhe entre reter na quarentena (padrão) e recusar com 550. Ao criar uma caixa num endereço que já foi de uma caixa apagada, o painel pede para restaurar a caixa antiga ou recriar uma nova informando o motivo (fica na auditoria).

API (administrador do e-mail ou chave com `mail:admin`)

POST   /domains/{id}/aliases        {"local_part":"vendas","mailbox_id":"<uuid>","responder_como":false}
GET    /domains/{id}/aliases        [?apagados=1]
GET    /mailboxes/{id}/aliases
DELETE /aliases/{id}                {"motivo":"opcional"}      (apaga sem perder o histórico)
POST   /aliases/{id}/restaurar

Erros: 409 AliasColideCaixa / AliasRepetido / AliasColideIdentidade / AliasLimite; 422 AliasDeAlias / DestinoIndisponivel / CaixaAssinada; 429 criação rápida demais (aguarde 1 minuto). Detalhes: openapi.yaml do asender_mail_api e ADR-0142.