# Recebimento de e-mails

> Receba e-mails em qualquer endereço de um subdomínio do seu domínio verificado, receba um webhook email.received e obtenha a mensagem completa com a API.

O recebimento de e-mails permite que a sua aplicação receba mensagens, e não apenas as envie. Você aponta para o Emailit um registro MX de um subdomínio como `inbound.acme.com`, e cada mensagem enviada para qualquer endereço desse subdomínio é guardada no seu workspace e anunciada com um webhook. Use-o para tratar respostas, caixas de entrada de suporte, extrair documentos de e-mails ou encaminhar e-mails para uma equipe.

## Como funciona

1. **Você publica um registro MX.** O registro de `inbound.<your domain>` aponta para `inbound.emailitmail.com` com prioridade 10. Os registros MX do seu domínio raiz continuam com o seu provedor de e-mail, então os seus e-mails normais continuam funcionando.
2. **Alguém envia um e-mail para um endereço desse subdomínio.** Qualquer parte local é aceita, por exemplo `support@inbound.acme.com` ou `reply+4821@inbound.acme.com`. Não há caixas de e-mail para criar.
3. **O Emailit aceita e guarda a mensagem.** Ela é salva como um e-mail com o tipo `inbound` e o status `received`, e custa 1 crédito.
4. **O Emailit cria um evento `email.received`.** Os webhooks inscritos nele recebem um payload pequeno com o ID do e-mail, `from`, `to`, `subject` e `created_at`. O corpo e os anexos não vêm no webhook.
5. **A sua aplicação obtém o conteúdo.** Chame [Obter um e-mail](/pt/docs/api-reference/emails/get/) com o ID para receber o corpo em texto e em HTML já interpretados, os cabeçalhos e os anexos, ou [Obter o MIME bruto](/pt/docs/api-reference/emails/raw/) para a mensagem original.
6. **Opcionalmente, uma automação age sobre ela.** O gatilho **Email received** das [automações](/pt/docs/automations/) pode encaminhar a mensagem ou iniciar outras etapas.

As mensagens recebidas também aparecem no painel em **Email API → Emails**, na aba **Incoming**, onde você pode abrir cada uma para ver os cabeçalhos, o conteúdo e os anexos.

## O que você pode fazer

  - [Configurar o recebimento](/pt/docs/inbound/set-up/): Publique o registro MX, escolha o subdomínio e envie uma mensagem de teste.
  - [Processar com webhooks](/pt/docs/inbound/process-with-webhooks/): Verifique o webhook, obtenha a mensagem e trate os anexos em Node.js, Python ou PHP.
  - [Encaminhar com automações](/pt/docs/inbound/forward-with-automations/): Encaminhe todos os e-mails recebidos, ou só alguns, para outro endereço sem código.
  - [Guia rápido de recebimento](/pt/docs/quickstart/inbound/): Receba o seu primeiro e-mail em poucos minutos.

## Limites e comportamento

| Item | Comportamento |
| --- | --- |
| Domínio | O domínio precisa ser um domínio de envio verificado no seu workspace (registros SPF, DKIM e de return path OK). |
| Endereços | Qualquer endereço em `<inbound subdomain>.<your domain>`. O subdomínio padrão é `inbound`; você pode alterá-lo com a API. Endereços no domínio raiz não são aceitos. |
| Tamanho da mensagem | Até 40 MB por mensagem, o mesmo limite do envio por SMTP. |
| Custo | 1 crédito por mensagem recebida. Se o workspace não tiver créditos, o Emailit responde `452 Insufficient credits to receive inbound email` e o servidor remetente tenta de novo mais tarde. |
| Payload do webhook | `email.received` traz apenas o ID e os campos do envelope. Obtenha o corpo, os cabeçalhos e os anexos com a API. |
| Filtragem de spam | O Emailit não pontua nem filtra as mensagens recebidas quanto a spam. Aplique as suas próprias verificações antes de agir sobre o conteúdo. |
| Análises | As mensagens recebidas não são contadas nas [análises](/pt/docs/analytics/), que cobrem os e-mails de saída. |

Não há uma interface de roteamento para os e-mails recebidos: nada de caixas de e-mail por endereço, regras ou configurações de catch-all no painel. Faça o roteamento das mensagens no seu próprio código lendo o endereço `to` do webhook, ou use a automação [Forward received email](/pt/docs/inbound/forward-with-automations/) para enviar tudo, ou um subconjunto filtrado, para outra caixa de entrada.

## Retenção

As mensagens recebidas seguem a [retenção de dados](/pt/docs/data-retention/) do seu workspace. O conteúdo das mensagens (corpo, cabeçalhos e anexos) é guardado por menos tempo do que o registro da mensagem, então obtenha e guarde o que precisar quando o webhook chegar. Depois que o conteúdo é apagado, a API retorna o e-mail sem o corpo nem os anexos.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Retenção do conteúdo das mensagens | 7 dias | 30 dias | 30 dias | Flexível |
| Retenção da atividade das mensagens | 30 dias | 365 dias | 365 dias | Flexível |

## Próximos passos

  - [Configurar o recebimento](/pt/docs/inbound/set-up/)
  - [Tipos de evento de webhook](/pt/docs/webhooks/event-types/)

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