Enviar anexos
Anexe arquivos a qualquer email incluindo o array attachments no payload de envio. Os arquivos precisam estar em base64, e você pode incluir vários anexos em uma única chamada.
https://mail.sendcorex.com/v3.0/send Os anexos usam o mesmo endpoint de Enviar email. Adicione o array attachments junto aos outros parâmetros do body.
Parâmetros do anexo
Cada item do array attachments é um objeto com os campos abaixo.
filenamestringobrigatórioO nome do arquivo exibido ao destinatário no cliente de email.
ex.
"invoice.pdf"contentstringobrigatórioO conteúdo do arquivo codificado como string base64.
ex.
"JVBERi0xLjQKJeLjz9MK..."encodingstringobrigatórioA codificação de content. Precisa ser "base64".
ex.
"base64"
Início rápido
import axios from 'axios';
import fs from 'fs';
const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');
try {
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Your Invoice #1042',
body: '<p>Please find your invoice attached.</p>',
attachments: [
{
filename: 'invoice.pdf',
content: fileContent,
encoding: 'base64',
},
],
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id, ids, recipients } = response.data;
console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
// Attachment blocked for security reasons. There is no quarantine record.
console.log('Blocked:', err.response.data.riskLevel);
} else {
throw err;
}
}Resposta
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"recipients": 1,
"scheduledAt": null
}Meu anexo foi bloqueado
Para proteger nossa plataforma e a reputação de envio de todos os clientes, os anexos são verificados antes de o email entrar na fila. Quando um arquivo é considerado inseguro, a requisição retorna 400 com o código DANGEROUS_ATTACHMENT e o email não é enviado.
Anexo bloqueado
{
"error": "One or more attachments were blocked for security reasons.",
"code": "DANGEROUS_ATTACHMENT",
"riskLevel": "high"
}errorUma mensagem legível explicando que um anexo foi bloqueado.
codeSempre DANGEROUS_ATTACHMENT nesta resposta.
riskLevelO nível de risco atribuído ao anexo bloqueado. Inclua-o ao falar com o suporte.
Não há registro de quarentena para este erro.Ao contrário dos emails marcados como spam, um anexo bloqueado não pode ser liberado com /quarantine/release. É uma proteção proposital contra spammers e remetentes abusivos, então o email nunca fica retido para entrega posterior.
O que devo fazer?
As verificações automáticas podem, às vezes, marcar um arquivo legítimo. Se você precisa enviar esse anexo, fale com nosso suporte. Nossa equipe conhece esse comportamento e, quando um bloqueio se revela um falso positivo, analisamos e aplicamos as atualizações necessárias.
Para resolvermos mais rápido, inclua:
- O nome e o tipo do arquivo anexado
- O riskLevel retornado pela API
- Para que o arquivo é usado no seu produto
Os erros retornam um objeto JSON com error e code.
- 401
MISSING_AUTH_HEADERNenhum header Authorization presente.
- 401
INVALID_API_KEYA API key é inválida ou foi revogada.
- 401
ACCOUNT_BLOCKEDA conta foi bloqueada.
- 401
NO_CREDITS_LEFTCréditos de email insuficientes para todos os destinatários. Cada endereço em to, cc e bcc usa 1 crédito.
- 401
DOMAIN_NOT_VALIDATEDDomínio do remetente não verificado.
- 401
LISTED_SPAM_HAUSO domínio do remetente está listado no Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDNão é permitido enviar de domínios conhecidos (gmail.com, outlook.com etc).
- 401
FROM_HEADER_DOMAIN_MISMATCHDomínio do header From não autorizado para este remetente.
- 401
USER_NOT_FOUNDUsuário não encontrado.
- 401
MISSING_USER_PRIVILEGESFaltam privilégios de usuário.
- 401
EMAIL_CREDITS_NOT_FOUNDErro ao buscar os créditos de email.
- 401
EMAIL_NOT_VALIDATEDO email da conta ainda não foi verificado.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key bloqueada temporariamente por violações repetidas da política.
- 429
IP_TEMPORARILY_BLOCKEDIP da requisição bloqueado temporariamente por violações repetidas da política.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSRequisições simultâneas demais deste IP. Tente de novo em instantes.
- 400
INVALID_JSONO corpo da requisição não é um JSON válido.
- 400
MISSING_FROMO campo from está ausente ou vazio.
- 400
INVALID_FROM_FORMATO campo from precisa ser um endereço de email válido.
- 400
MISSING_SENDERNAMEO campo senderName está ausente ou vazio.
- 400
INVALID_SENDERNAME_FORMATO campo senderName contém caracteres inválidos.
- 400
MISSING_SUBJECTO campo subject está ausente ou vazio.
- 400
MISSING_BODYO campo body está ausente ou vazio.
- 400
MISSING_TOADDRESSO campo to está ausente ou vazio.
- 400
MISSING_TOO campo to está ausente ou vazio.
- 400
INVALID_TOADDRESSUm ou mais endereços de destinatário estão malformados.
- 400
TOADDRESS_LIMIT_EXCEEDEDMais de 50 destinatários no array to.
- 400
INVALID_CCADDRESSUm ou mais endereços de cc estão malformados.
- 400
INVALID_BCCADDRESSUm ou mais endereços de bcc estão malformados.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc e bcc juntos têm mais de 50 destinatários únicos.
- 400
INVALID_SCHEDULED_ATscheduled_at não é uma data válida ou está no passado.
- 400
INVALID_SENDER_FORMATO formato do email do remetente é inválido.
- 400
HEADER_NOT_ALLOWEDA chave do header personalizado não está na lista permitida (List-Unsubscribe, List-Id, X-* etc).
- 400
INVALID_HEADER_VALUEO valor do header contém caracteres inválidos (CR/LF não são permitidos).
- 400
DANGEROUS_ATTACHMENTUm ou mais anexos foram bloqueados por motivos de segurança.
- 400
INVALID_ATTACHMENTO conteúdo de um anexo não é base64 válido.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe é true, mas o body não tem placeholder de descadastro ([unsubscribe_url], [unsubscribe], [unsub_url] ou [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDA conta está restrita temporariamente.
- 403
DAILY_LIMITLimite diário de envio de emails atingido.
- 403
MARKETING_LIMIT_REACHEDLimite diário de marketing do plano free atingido: 30 emails de marketing ou cold outreach por dia, contados por destinatário numa janela móvel de 24 horas. A resposta traz limit, used, recipients e upgradeUrl. Emails transacionais continuam saindo; nada fica na fila.
- 403
FORBIDDEN_HTML_CONTENTO HTML contém conteúdo ativo não permitido em emails (script, iframe, form, input, button, embed, object, svg, handlers on*, links javascript:, meta refresh…). A resposta lista o que foi encontrado. Use um <a> estilizado em vez de botões ou formulários.
- 403
SPAM_DETECTEDConteúdo do email marcado como spam. A resposta inclui o quarantine_id e as instruções de liberação.
- 403
SENDER_NAME_MISMATCHVários nomes de remetente detectados para o mesmo endereço.
- 403
FOLLOWUP_PATTERN_DETECTEDConteúdo do email marcado como padrão repetido de follow-up suspeito.
- 403
SCAM_PATTERN_DETECTEDConteúdo do email marcado como padrão de golpe.
- 403
ACCOUNT_SUSPENDED_SPOOFINGConta suspensa por tentativas repetidas de falsificação do header From.
- 409
IDEMPOTENCY_IN_PROGRESSUma requisição com a mesma Idempotency-Key ainda está sendo processada. Espere (Retry-After: 1) e repita com a mesma chave.
- 422
IDEMPOTENCY_KEY_REUSEDEsta Idempotency-Key já foi usada com outro corpo. Use uma chave nova para cada email novo.
- 500
INTERNAL_SERVER_ERRORErro inesperado no servidor. Tente de novo.
- 500
PARSE_ERRORFalha ao processar o conteúdo do email (falha no parse MIME).
- 500
PERSIST_FAILEDFalha ao enfileirar o email (falha ao gravar no banco de dados).
- 503
AUTH_UNAVAILABLENão foi possível validar a API key agora. Tente de novo.
- 503
UNSUBSCRIBE_UNAVAILABLEServiço de link de descadastro temporariamente indisponível. Tente mais tarde.