Receber o primeiro e-mail

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.
• 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 ou atualizar 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:

[
  {
    "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.

Buscar o e-mail completo

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

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:

{
  "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. 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.

Preços

Cada e-mail recebido custa 1 crédito, o mesmo que enviar um. Consulte Créditos.

Próximos passos