API de e-mail: changelog

O botão Retry em um e-mail retido agora funciona, e Tentar enviar um e-mail de novo aceita e-mails com o status held. Corrija antes o motivo da retenção, por exemplo uma pontuação de spam alta ou a falta de créditos, e depois tente de novo.

Uma nova tentativa cria um novo e-mail com um novo ID e custa créditos como qualquer outro envio. E-mails com mais de 30 dias, ou cujo conteúdo foi removido pela retenção de dados, não podem ser enviados de novo. Consulte Novas tentativas e encaminhamento.

O Emailit compara os endereços em Reply-To e From, ignorando os nomes de exibição e as diferenças entre maiúsculas e minúsculas. Quando são iguais, ele remove o Reply-To antes de assinar a mensagem. As respostas continuam chegando ao endereço From.

Quando os endereços são diferentes, o Reply-To é mantido sem alterações. Consulte Cabeçalhos de e-mail.

• A API e o SMTP comparam o domínio do From sem diferenciar maiúsculas de minúsculas, então ada@Acme.com envia pelo domínio verificado acme.com.
• Alterar o subdomínio de rastreamento ou de recebimento de um domínio no painel, ou com tracking_key e inbound_key em Atualizar um domínio, agora salva o novo valor. Publique o registro DNS do novo nome e verifique-o.

• As chaves de API criadas antes de as chaves terem o prefixo secret_ voltam a ser aceitas na /v2.
• Obter um e-mail retorna o objeto de e-mail completo, incluindo object, from e to.
• As respostas de domínios retornam track_loads e track_clicks como 0 ou 1, como documentado.

Uma requisição de envio com tracking ativado falhava com 422 quando o domínio de envio não tinha um CNAME de rastreamento verificado. Agora o Emailit aceita o e-mail e o envia sem reescrever os links nem adicionar o pixel de abertura.

Para rastrear aberturas e cliques, publique o registro CNAME de rastreamento do seu domínio e verifique-o. Consulte Domínio de rastreamento personalizado.

As falhas temporárias eram registradas na entrega, mas o e-mail mantinha o status anterior. Agora o próprio e-mail passa para attempted enquanto o Emailit faz novas tentativas, então a lista de e-mails e a API mostram quais e-mails estão atrasados.

Os status posteriores, como delivered, e os status finais não são sobrescritos. Consulte Status de e-mail.

• Compose, na página Emails ou em Quick Actions no painel, envia um e-mail avulso de um domínio verificado, por exemplo para testar a sua configuração. Em Advanced, você pode atribuir o envio a uma chave de API. O Compose permite 3 e-mails por minuto e 10 por hora por workspace. Consulte Compose.
• Cancel delivery retira da fila um e-mail aceito, agendado ou com falha temporária. O cancelamento funciona em regime de melhor esforço: um e-mail que já está sendo entregue ao servidor do destinatário ainda pode ser entregue. Consulte Cancelar um e-mail.

Selecione Forward na página de detalhes de um e-mail ou chame Encaminhar um e-mail com um endereço to. Por padrão, o destinatário recebe uma cópia simples. Ative os cabeçalhos encaminhados e adicione um comentário se quiser dar contexto.

Um encaminhamento é um novo e-mail: ele custa créditos e conta nos seus limites de envio. Você pode encaminhar 3 e-mails por hora por workspace. Consulte Novas tentativas e encaminhamento.

A regra do sandbox agora vale para a API, o SMTP, o Compose, as novas tentativas, as automações e as campanhas. Enviar para qualquer outra pessoa retorna 403 com o código unverified_workspace_recipient na API e 550 no SMTP, e os envios de campanha ficam bloqueados. Os workspaces com acesso de produção não são afetados.

Para remover a restrição, verifique um domínio e solicite o acesso de produção.

Antes, as chaves só de envio podiam listar e consultar e-mails e chamar alguns outros endpoints de leitura. Agora elas estão limitadas a Enviar um e-mail e às ações sobre um e-mail existente: reagendar, cancelar, tentar enviar de novo e encaminhar. Os outros endpoints rejeitam as chaves de envio.

Se a sua integração também lê e-mails, domínios ou outros recursos, use uma chave de acesso total nessas chamadas. Consulte Chaves de API.

• Listar e-mails: GET /v2/emails
• Obter o MIME bruto: GET /v2/emails/:id/raw
• Obter o corpo: GET /v2/emails/:id/body
• Obter os metadados: GET /v2/emails/:id/meta
• Listar anexos: GET /v2/emails/:id/attachments

Esses endpoints exigem uma chave de acesso total. O conteúdo fica disponível até o período de retenção de dados do seu plano removê-lo.

Os e-mails e as entregas existentes foram migrados para os novos nomes. Os eventos e as requisições de webhook criados antes da mudança mantêm os valores com que foram enviados. Consulte Status de e-mail para a lista atual.

Monte templates com o editor HTML, o editor de texto formatado ou o editor de arrastar e soltar Dragit. Os templates que compartilham um alias são versões de um mesmo template, e apenas a versão publicada é usada quando você envia pelo alias.

Gerencie os templates com a API de templates e envie um passando template e variables para Enviar um e-mail. Consulte Templates.

Retry duplica o e-mail original, dá um novo ID à cópia e a envia pelo fluxo normal. Ela é cobrada como qualquer e-mail novo. Para tentar de novo a partir do código, chame Tentar enviar um e-mail de novo.

• Enviar um e-mail: cada destinatário recebe o próprio ID de e-mail. Agende com uma data ISO 8601, um timestamp Unix ou linguagem natural, como “tomorrow at 9am”, e evite duplicatas com o cabeçalho Idempotency-Key.
• Obter um e-mail: status, cabeçalhos, conteúdo, configurações de rastreamento e metadados.
• Atualizar um e-mail agendado: altere o horário de envio até 3 minutos antes do previsto.
• Cancelar um e-mail: interrompa um e-mail agendado ou na fila.

Toda resposta de envio inclui os cabeçalhos ratelimit-*. Consulte Limites de requisições.

As requisições acima do limite são rejeitadas em vez de ir para a fila, então configure o seu cliente para enviar no máximo 2 e-mails por segundo ou para tentar de novo os envios rejeitados. A mudança foi liberada para os workspaces aos poucos.

Consulte Limites de requisições.