As rotas API e SMTP do Mailjet podem gerar mensagens finais diferentes mesmo quando o rascunho visível é o mesmo. Compare o conteúdo MIME renderizado, as identidades do remetente e as referências de mensagem disponíveis antes de interpretar a Inbox Placement. Uma resposta bem-sucedida da API ou aceitação pelo SMTP não determina a pasta escolhida pela caixa de entrada receptora.
Defina entradas equivalentes para a mensagem
Escolha uma mensagem de aplicação não sensível e salve seu assunto, remetente, Reply-To, partes HTML e texto simples, links e comportamento de anexos. Use os mesmos dados de teste para ambas as rotas. Decida se está comparando duas submissões de transporte de uma mensagem já renderizada ou duas implementações completas da aplicação.
Essa distinção é importante porque um caminho via template API pode renderizar diferente de uma biblioteca SMTP que constrói seu próprio MIME. Se a aplicação usa renderizadores separados, o experimento inclui esses renderizadores. Não apresente como comparação apenas de transporte a menos que a paridade de conteúdo tenha sido estabelecida.
Identifique a versão e o contexto da conta
Registre a versão da API e o contexto da conta Mailjet ou da chave API usada por cada rota, sem registrar segredos. O exemplo atual do primeiro email do Mailjet usa Send API v3.1, enquanto documentação separada cobre a v3.0. Não misture nomes de propriedades de versões diferentes ao investigar um problema de payload.
A visão geral do SMTP atribui a responsabilidade pelos cabeçalhos, manipulação MIME e personalização à aplicação que submete. Verifique a saída real da biblioteca SMTP em vez de assumir que as rotas API e SMTP sintetizam automaticamente o mesmo texto alternativo ou codificação. Salve mensagens geradas representativas para uma comparação significativa.
Controle diferenças ocultas
Compare o remetente visível (From) e a identidade do envelope, codificação do assunto, nomes de anexos, alternativas de texto e HTML, e cabeçalhos obrigatórios de descadastramento para o tipo de mensagem. Faça inventário de rastreamento ou opções de template que possam ser aplicadas de forma diferente. Um URL de destino compartilhado não garante o mesmo comportamento de reescrita de links.
Use a mesma configuração de remetente validada onde suportado. Verifique a autenticação real nas cópias recebidas; login bem-sucedido ou autorização API apenas estabelece acesso ao serviço de submissão. Não prova que a mensagem resultante passou pela autenticação do destinatário ou chegou à Inbox.
Submeta mensagens originais delimitadas
Crie testes LDM para o remetente pretendido e obtenha os destinatários atuais de cada execução. Submeta um fixture claramente identificado pela implementação API relevante e outro via SMTP, mantendo a composição dos destinatários e o tempo de observação comparáveis. Use a lógica real da aplicação quando essa lógica for a questão.
Mantenha os identificadores de resposta da API e referências da transação SMTP junto com os identificadores de trabalho da sua aplicação. Não registre segredos da API, senhas SMTP ou cabeçalhos completos de autorização. Distinga uma tentativa de requisição de uma submissão bem-sucedida ao provedor e de um evento posterior de entrega.
Mantenha os destinatários de teste fora de trabalhos recorrentes e listas comuns de assinantes. Pare o fluxo delimitado após as mensagens planejadas. Este guia não realiza requisições nem envios e não pressupõe conexão nativa do Mailjet com LDM.
Reconcilie transporte e observação
Para cada cópia recebida, registre sua rota, referência da mensagem, pasta e horário da observação. Se o caminho API for observado e o SMTP estiver ausente, primeiro inspecione as evidências da submissão SMTP e da fila. A ausência isolada não determina que o destinatário classificou a mensagem SMTP como Spam.
Se ambos chegarem mas a Inbox Placement for diferente, compare o conteúdo final e os cabeçalhos antes de afirmar que o protocolo em si explica o resultado. Um painel pequeno de caixas de email de teste não pode ranquear API versus SMTP universalmente. Comportamento da aplicação, roteamento, histórico do remetente e contexto do destinatário continuam sendo limitações relevantes.
Perguntas frequentes
Sucesso na API significa entrega na Inbox?
Não. É evidência de submissão. Use eventos de envio subsequentes e observação real da caixa de email para as próximas camadas.
Posso comparar um template API com um rascunho SMTP diferente?
Sim, como comparação de duas configurações completas. Não atribua qualquer diferença exclusivamente a API versus SMTP sem controlar o conteúdo.
Devo imprimir credenciais durante a depuração?
Não. Rótulos da conta, estrutura da requisição sanitizada, timestamps e referências de mensagem não secretas fornecem dados úteis sem expor material de autenticação.
Referências oficiais
Revisado em 2026-11-05; não há reivindicação de benchmark de protocolo.