# Configurar o recebimento de e-mails

> Publique o registro MX de recebimento do seu domínio verificado, escolha o subdomínio de recebimento, verifique o registro e envie uma mensagem de teste.

Este guia conecta um subdomínio do seu domínio ao Emailit para que ele possa receber e-mails. Isso exige um único registro DNS e não muda a forma como os e-mails para o seu domínio principal são entregues.

## Antes de começar

- Um [domínio de envio verificado](/pt/docs/domains/verification/) no seu workspace, por exemplo `acme.com`. O recebimento só funciona em domínios verificados. Se você ainda não adicionou um, siga [Adicionar um domínio](/pt/docs/domains/add-a-domain/).
- Acesso às configurações de DNS desse domínio.
- Créditos disponíveis. Cada mensagem recebida custa 1 crédito.
- Os domínios são criados com o recebimento de e-mails ativado (o campo `incoming` é `true` por padrão). Deixe-o assim; não há uma opção no painel para ele.

## Escolher o subdomínio de recebimento

O Emailit aceita e-mails para um subdomínio por domínio. Por padrão, ele é `inbound`, então os endereços ficam como `anything@inbound.acme.com`. Você pode ver o valor atual na página do domínio, em **Custom Subdomains** > **Inbound Subdomain**. O campo é somente leitura no painel.

Para usar outro subdomínio, defina `inbound_key` com [Atualizar um domínio](/pt/docs/api-reference/domains/update/). O valor pode conter letras minúsculas, dígitos e hífens, pode ter de 1 a 63 caracteres e não pode começar nem terminar com hífen.

```bash
curl -X POST https://api.emailit.com/v2/domains/dom_2xGk5Pz8QwR1mT4vLsB7nY3cK9a \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_key": "mail"}'
```

Com `"inbound_key": "mail"`, os endereços passam a ser `anything@mail.acme.com` e o registro MX passa para `mail.acme.com`. Alterar a chave faz o status do registro de recebimento voltar a pendente, e os e-mails enviados para o subdomínio antigo deixam de ser aceitos. Defina `inbound_key` como `null` para voltar a `inbound`.

## Adicionar o registro MX

1. **Abra o domínio.** No painel, acesse **Email API → Domains**, selecione o seu domínio e abra a aba **DNS Setup**.

2. **Encontre o registro de recebimento.** É o registro MX opcional cujo nome é `inbound` (ou o seu subdomínio personalizado) e cujo valor é `inbound.emailitmail.com`. Use os botões de copiar para evitar erros de digitação.

3. **Crie o registro no seu provedor de DNS.** Adicione um novo registro com estes valores:

   | Campo | Valor |
   | --- | --- |
   | Tipo | `MX` |
   | Nome / Host | `inbound` (alguns provedores pedem o nome completo, `inbound.acme.com`) |
   | Servidor de e-mail / Valor | `inbound.emailitmail.com` |
   | Prioridade | `10` |
   | TTL | Automático, ou o padrão do seu provedor |

   Não altere os registros MX do domínio raiz (`acme.com`). Eles continuam encaminhando os seus e-mails normais para o seu provedor de e-mail.

   Se o seu domínio usa a [configuração em um clique do Cloudflare](/pt/docs/domains/cloudflare/), você pode selecionar o registro **Inbound** na caixa de diálogo de configuração em vez de adicioná-lo manualmente.

4. **Verifique o DNS.** De volta à página do domínio, selecione **Check DNS**. O registro de recebimento mostra **OK** quando um registro MX com prioridade 10 aponta para `inbound.emailitmail.com`. A maioria dos provedores publica os registros em minutos, mas pode levar até 48 horas.

   Você também pode verificar pelo terminal:

```bash
dig MX inbound.acme.com +short
# 10 inbound.emailitmail.com.
```

## Enviar uma mensagem de teste

De qualquer caixa de e-mail pessoal, envie um e-mail para um endereço do subdomínio, por exemplo `test@inbound.acme.com`.

## Confirmar que funcionou

- **Painel:** acesse **Email API → Emails** e abra a aba **Incoming**. A mensagem aparece com o status **Received** em segundos. Abra-a para ver os cabeçalhos, o conteúdo e os anexos.
- **Eventos:** **Email API → Events** mostra um evento `email.received`. O payload dele contém o ID do e-mail.
- **API:** liste as mensagens recebidas com [Listar e-mails](/pt/docs/api-reference/emails/list/):

```bash
curl "https://api.emailit.com/v2/emails?type=inbound" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Em seguida, [processe os e-mails recebidos com um webhook](/pt/docs/inbound/process-with-webhooks/) ou [encaminhe-os com uma automação](/pt/docs/inbound/forward-with-automations/).

## Solução de problemas

<details>
<summary>O registro aparece como Missing ou Invalid</summary>

A mensagem de status informa o que o Emailit encontrou. “There are no MX records at inbound.acme.com” significa que o registro ainda não foi publicado ou foi criado no nome errado (por exemplo `inbound.acme.com.acme.com`, quando o provedor acrescenta o domínio automaticamente). Um status “Invalid” lista os registros encontrados e o valor esperado, `10 inbound.emailitmail.com`. Corrija a prioridade ou o valor, espere o DNS ser atualizado e selecione **Check DNS** de novo.

</details>

<details>
<summary>Apontei o MX do meu domínio raiz para o Emailit</summary>

O Emailit só aceita e-mails para o subdomínio de recebimento. Se os registros MX de `acme.com` apontarem para `inbound.emailitmail.com`, os e-mails para `you@acme.com` são rejeitados com `530 Authentication required`. Restaure os registros MX raiz que o seu provedor de e-mail forneceu e adicione o registro MX apenas em `inbound.acme.com`.

</details>

<details>
<summary>O registro aparece como OK, mas os e-mails vão para outro lugar</summary>

Outro registro MX no mesmo nome pode ter prioridade. Os servidores de e-mail usam primeiro o registro com o menor número de prioridade, então um registro extra como `5 mx.example.net` em `inbound.acme.com` prevalece sobre o `10` do Emailit. Um registro MX curinga (`*.acme.com`) também pode capturar o subdomínio se o registro de recebimento estiver faltando. Execute `dig MX inbound.acme.com +short` e confira se `inbound.emailitmail.com` é a única resposta. Um CNAME no mesmo nome também bloqueia os registros MX; remova-o.

</details>

<details>
<summary>Os remetentes recebem “530 Authentication required”</summary>

O Emailit não reconheceu o domínio do destinatário. Confira se o endereço usa o subdomínio de recebimento atual (depois de alterar `inbound_key`, o subdomínio antigo para de funcionar), se o domínio está escrito corretamente e se ele continua verificado em **Email API → Domains**.

</details>

<details>
<summary>Os remetentes recebem “452 Insufficient credits to receive inbound email”</summary>

O workspace está sem créditos. `452` é um erro temporário, então a maioria dos servidores remetentes continua tentando por horas ou dias. [Compre créditos](/pt/docs/billing/credits/) ou ative a [recarga automática](/pt/docs/billing/auto-refill/), e as mensagens reenviadas serão aceitas.

</details>

<details>
<summary>Os remetentes recebem “535 Mail server has been suspended” ou “552 Message too large”</summary>

`535` significa que o workspace está suspenso; consulte [Saúde de envio](/pt/docs/deliverability/sending-health/) ou fale com o suporte. `552` significa que a mensagem tem mais de 40 MB.

</details>

## Veja também

  - [Processar com webhooks](/pt/docs/inbound/process-with-webhooks/)
  - [Registros DNS](/pt/docs/domains/dns-records/)

---
Fonte: https://emailit.com/pt/docs/inbound/set-up/