Configurar o recebimento de e-mails

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 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.
• 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. 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.

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, 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:

   Terminal

   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:

  Terminal

  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 ou encaminhe-os com uma automação.

Solução de problemas

Veja também