# Receber o primeiro e-mail

> Adicione o registro MX de recebimento, envie uma mensagem de teste para o seu subdomínio de recebimento, encontre-a no painel e processe-a com um webhook email.received e com a API.

Este guia rápido configura um domínio para receber e-mails, para que a sua aplicação possa tratar respostas, pedidos de suporte ou mensagens encaminhadas. Você vai adicionar um registro DNS, enviar uma mensagem de teste e depois recebê-la com um webhook e buscar o conteúdo completo dela pela API.

## Antes de começar

- Um domínio de envio verificado, como `acme.com`. O recebimento de e-mails só funciona em domínios verificados no seu workspace. Consulte [Adicionar um domínio](/pt/docs/domains/add-a-domain/).
- Créditos no workspace. Cada e-mail recebido custa 1 crédito.

## Como funcionam os endereços de recebimento

O Emailit recebe e-mails em um subdomínio do seu domínio de envio, `inbound` por padrão. Qualquer endereço nesse subdomínio funciona, então `support@inbound.acme.com` e `reply-4821@inbound.acme.com` chegam ao mesmo workspace. Os registros MX do seu domínio principal, por exemplo, os do Google Workspace ou do Microsoft 365, continuam como estão.

## Adicionar o registro MX de recebimento

1. **Abra o domínio.** Acesse **Email API → Domains** e abra `acme.com`. O registro MX de `inbound.acme.com` aparece junto com os outros registros DNS. Ele é opcional, então o domínio continua verificado sem ele.

2. **Adicione o registro no seu provedor de DNS.**

   | Tipo | Nome | Valor | Prioridade |
   | --- | --- | --- | --- |
   | MX | `inbound.acme.com` | `inbound.emailitmail.com` | 10 |

   Alguns provedores de DNS querem só `inbound` no campo de nome. Outros querem o nome completo.

3. **Verifique o DNS.** Selecione **Check DNS** na página do domínio e espere até o registro de recebimento mostrar **OK**. As alterações de DNS costumam levar alguns minutos, mas podem levar até 48 horas.

Para receber em outro subdomínio, como `replies.acme.com`, defina `inbound_key` como `replies` ao [criar](/pt/docs/api-reference/domains/create/) ou [atualizar](/pt/docs/api-reference/domains/update/) o domínio pela API e publique o registro MX para esse nome. O painel mostra o subdomínio de recebimento, mas não permite alterá-lo.

## Enviar um e-mail de teste

Da sua caixa de e-mail pessoal, envie um e-mail para qualquer endereço no subdomínio de recebimento, por exemplo, `hello@inbound.acme.com`.

Acesse **Email API → Emails** e abra a aba **Incoming**. A mensagem aparece com o status **received**. Abra-a para ver o remetente, os cabeçalhos, o conteúdo e os anexos.

Se ela não chegar, confira se o registro MX mostra **OK** e se o domínio está verificado. Se o workspace estiver sem créditos, o Emailit recusa a mensagem com um erro temporário, e o servidor do remetente tenta de novo mais tarde.

## Receber notificações com um webhook

Para processar os e-mails recebidos na sua aplicação, inscreva-se no evento `email.received`.

1. **Crie o webhook.** Acesse **Email API → Webhooks**, selecione **Add webhook** e informe um nome e o seu endpoint HTTPS, por exemplo, `https://acme.com/webhooks/emailit`. Copie o segredo do webhook. Você vai precisar dele para verificar as assinaturas.

2. **Escolha o evento.** Um webhook novo recebe todos os eventos. Abra a aba **Settings** do webhook e selecione só `email.received`, ou mantenha todos os eventos e filtre no seu código.

3. **Envie outro e-mail de teste** para `hello@inbound.acme.com`.

O Emailit envia um `POST` assinado para o seu endpoint. O corpo é um array JSON, porque uma requisição pode levar até 100 eventos:

```json
[
  {
    "event_id": "evt_2pXb7Lw9QmKc4RtN8yVd3Hs",
    "type": "email.received",
    "data": {
      "object": {
        "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
        "object": "email",
        "from": "ada@example.com",
        "to": "hello@inbound.acme.com",
        "subject": "Question about my order",
        "created_at": "2026-10-01T09:30:12.418Z"
      }
    }
  }
]
```

O evento traz o remetente, o destinatário e o assunto, mas não o corpo. Verifique o cabeçalho `X-Emailit-Signature` antes de confiar na requisição. Consulte [Assinatura das requisições](/pt/docs/webhooks/request-signature/).

## Buscar o e-mail completo

Use o `id` do evento para buscar a mensagem com uma chave de API **Full Access**:

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

A resposta inclui os cabeçalhos interpretados, o corpo em texto e em HTML e os anexos:

```json
{
  "object": "email",
  "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
  "type": "inbound",
  "from": "ada@example.com",
  "to": "hello@inbound.acme.com",
  "subject": "Question about my order",
  "status": "received",
  "headers": { "...": "..." },
  "body": {
    "text": "Hi, where is my order #1042?",
    "html": "<p>Hi, where is my order #1042?</p>"
  },
  "attachments": []
}
```

Para obter a mensagem original, chame [`GET /emails/{id}/raw`](/pt/docs/api-reference/emails/raw/). O conteúdo das mensagens é mantido durante o período de retenção do seu plano, então busque-o logo depois que o evento chegar. Consulte [Retenção de dados](/pt/docs/data-retention/).

## Preços

Cada e-mail recebido custa 1 crédito, o mesmo que enviar um. Consulte [Créditos](/pt/docs/billing/credits/).

## Próximos passos

  - [Processar e-mails recebidos com webhooks](/pt/docs/inbound/process-with-webhooks/): Encaminhe respostas, interprete anexos e associe conversas.
  - [Encaminhar com automações](/pt/docs/inbound/forward-with-automations/): Encaminhe os e-mails recebidos para uma caixa de e-mail sem código.
  - [Configurar o recebimento](/pt/docs/inbound/set-up/): Subdomínios personalizados e DNS em detalhes.
  - [email.received](/pt/docs/webhooks/events/email/received/): A referência completa do evento.

---
Fonte: https://emailit.com/pt/docs/quickstart/inbound/