Pular para o conteúdo
Infrastructure
Como mandar e-mail de confirmação e de senha pelo meu app sem configurar servidor de e-mail

Como mandar e-mail de confirmação e de senha pelo meu app sem configurar servidor de e-mail

O e-mail que o app precisa mandar, do código de login ao recibo, sem servidor SMTP: uma chamada HTTP, o seu domínio verificado no DNS e o log de cada envio.

Ciro Cesar Maciel5 min de leituraFeito com ajuda de IA

Nesta página · 9 seções
  1. Antes: talvez você não precise do e-mail de senha
  2. O que é preciso para enviar
  3. O que acontece depois do envio
  4. O que costuma dar errado
  5. O que o Messages não faz
  6. Perguntas frequentes
  7. Para continuar lendo
  8. O e-mail do app, pelo seu domínio
  9. Fontes

O app precisa mandar e-mail: confirmar o cadastro, enviar um código, mandar o recibo, avisar que a assinatura venceu. O agente que escreveu o app costuma sugerir um servidor SMTP, uma senha de app do Gmail ou uma biblioteca que fala com algum provedor. A senha do Gmail é o atalho que mais dá problema: limite baixo, e-mail que sai com o seu endereço pessoal e mensagens que caem no spam. O caminho sem servidor é uma API de e-mail transacional, que envia pelo seu domínio com uma chamada HTTP.

Antes: talvez você não precise do e-mail de senha

Metade dos e-mails que um app manda existe por causa da senha: confirmação de cadastro, "esqueci a senha", "sua senha foi alterada". Se o login do app for por código no e-mail, como no Infrastructure Auth, nenhum deles existe. A pessoa digita o e-mail, recebe um código de 8 caracteres e entra, e quem manda esse código é o próprio Auth. Não há link de redefinição para construir, nem e-mail de senha para cair no spam.

O que sobra para o app mandar são os e-mails do negócio: o recibo, o aviso de que o relatório ficou pronto, o convite para um colega. É para eles que serve o Messages.

O que é preciso para enviar

1. Um projeto e a chave

O projeto guarda os domínios e os envios. A chave secreta do projeto começa com msk_, fica só no servidor e aparece uma única vez, na criação. Se ela se perder, não há como recuperar: cria-se outra credencial.

Se você ainda não tem conta, o agente que está construindo o app cria a conta e o projeto sozinho, pela documentação em https://myinfrastructure.click/products/messages/llms.txt. O passo humano é ler o código que chega no seu e-mail.

2. Verificar o domínio, o único passo que depende de você

Você informa o domínio, por exemplo suaempresa.com.br, e recebe os registros para criar no DNS:

  • três CNAME de DKIM, que assinam cada mensagem;

  • um TXT de SPF e um MX de retorno, ambos em send.suaempresa.com.br;

  • um TXT de DMARC, recomendado.

O detalhe que protege o e-mail que você já usa: o SPF e o MX ficam em send.<domínio>, não na raiz. Assim, o e-mail da empresa no Google Workspace ou em outro provedor continua funcionando igual. A propagação leva de minutos a algumas horas, e enquanto o domínio não estiver verificado, nenhum envio com aquele remetente sai.

3. A chamada de envio

POST https://messages.worker.myinfrastructure.click/emails
Authorization: Bearer msk_…

{
  "from": "oi@suaempresa.com.br",
  "to": "cliente@exemplo.com",
  "subject": "Seu recibo",
  "html": "<p>Obrigado pela compra.</p>",
  "text": "Obrigado pela compra.",
  "idempotencyKey": "recibo/pedido-123"
}

A chave de idempotência impede o e-mail duplicado quando o app repete a chamada depois de uma falha de rede. Ela precisa vir do fato, como o id do pedido, e não do relógio: uma chave que muda a cada tentativa não protege nada.

O que acontece depois do envio

Cada envio acumula eventos, que contam a história da mensagem: entregue, aberta, clicada, devolvida, marcada como spam. O painel mostra essa linha do tempo, e um webhook pode avisar o seu sistema a cada evento.

Quando um endereço devolve de forma permanente ou alguém reclama, ele entra sozinho na lista de supressão do projeto, e o app para de mandar para ele. Isso depende do MX de retorno: sem ele, a devolução não volta, e o app segue mandando para endereços mortos.

O que costuma dar errado

  • O envio é recusado. Quase sempre o domínio do from ainda não foi verificado nesse projeto.

  • A verificação nunca conclui. Um caractere a mais no valor de um CNAME de DKIM, copiado com espaço ou com o domínio repetido pelo painel do DNS.

  • O SPF da empresa quebrou. Alguém pôs o registro na raiz em vez de send.<domínio>.

O que o Messages não faz

Ele só manda e-mail: não manda SMS nem WhatsApp. Não guarda lista de contatos, segmentos nem automações. O envio em massa existe, mas recebe uma mensagem pronta por destinatário, e a lista e o descadastro ficam com quem chama. Não há SMTP para conectar um cliente de e-mail, nem agendamento: cada envio sai na hora. O pool de IP é compartilhado, e IP dedicado não existe.

Perguntas frequentes

Funciona com qualquer linguagem?

Sim. Não há SDK para instalar: o envio é uma rota HTTP comum, e qualquer backend em Node, Bun, Python ou PHP faz a chamada.

Quantos e-mails dá para mandar sem plano?

A conta sem plano tem 1 domínio e 2.000 envios por mês, contados por destinatário, com um teto de 130 a cada 24 horas. Quando o teto do dia é atingido, esperar resolve.

O e-mail vai cair no spam?

Com DKIM, SPF e DMARC no lugar, o e-mail sai assinado pelo seu domínio, que é o que os provedores conferem. O conteúdo e a lista de quem recebe também pesam, e isso continua sendo do app.

Um agente consegue mandar e ler esses e-mails?

Sim. O Messages tem um servidor MCP: o agente consulta envios, eventos e supressões, e lê as caixas de entrada, com o seu login no navegador.

Para continuar lendo

O e-mail do app, pelo seu domínio

O Messages envia o e-mail transacional do app pelo seu domínio verificado, com idempotência, log de eventos, supressão automática e caixas de entrada que viram conversas. Conhecer o Messages

Fontes

XLinkedInWhatsAppE-mail

Quem escreveu

Ciro Cesar Maciel

Sou marido, pai e trabalho com tecnologia há mais de duas décadas, construindo sistemas para grandes empresas e liderando times técnicos. Desde 2024 desenvolvo ferramentas digitais e aplico Inteligência Artificial para viver e trabalhar com mais clareza, e escrevo aqui sobre isso.

Todos os textos

Continue lendo

Comentários

Seu e-mail fica com Infrastructure para moderar e responder. O comentário aparece depois de aprovado.