Visão geral
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
- Você publica um registro MX. O registro de
inbound.<your domain>aponta parainbound.emailitmail.comcom 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. - Alguém envia um e-mail para um endereço desse subdomínio. Qualquer parte local é aceita, por exemplo
support@inbound.acme.comoureply+4821@inbound.acme.com. Não há caixas de e-mail para criar. - O Emailit aceita e guarda a mensagem. Ela é salva como um e-mail com o tipo
inbounde o statusreceived, e custa 1 créditoCréditoA unidade de cobrança do Emailit. Cada ação custa um número fixo de créditos, por exemplo 1 por e-mail via API ou SMTP e 2 por e-mail de campanha.. - O Emailit cria um evento
email.received. Os webhooks inscritos nele recebem um payload pequeno com o ID do e-mail,from,to,subjectecreated_at. O corpo e os anexos não vêm no webhook. - A sua aplicação obtém o conteúdo. Chame Obter um e-mail 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 para a mensagem original.
- Opcionalmente, uma automação age sobre ela. O gatilho Email received das automações pode encaminhar a mensagem ou iniciar outras etapas.
As mensagens recebidas também aparecem no painel em Email APIEmails, 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
Limites e comportamento
| Item | Comportamento |
|---|---|
| Domínio | O domínio precisa ser um domínio de envioDomínio de envioUm domínio seu, verificado com registros DNS, para que o Emailit possa enviar e-mails a partir dele com SPF, DKIM e um return path personalizado. 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, 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 para enviar tudo, ou um subconjunto filtrado, para outra caixa de entrada.
Retenção
As mensagens recebidas seguem a retenção de dados 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 |