Receber e-mails: Envio e confiança
Enviar e-mail
Envie um novo e-mail a partir do remetente do seu token. A mensagem é salva em Enviados na hora e entregue em segundo plano.
https://g.sendcorex.com/v1command: send_emailqueued: true significa salvo e aguardando na fila, não entregue. O message_id da resposta é provisório: o Message-ID SMTP real o substitui alguns segundos depois e aparece em get_messages.
Cada destinatário (to + cc + bcc) recebe sua própria cópia e usa 1 crédito. Endereços em bcc nunca aparecem nos headers. O corpo é limitado a 2 MB, e os anexos a 25 MB no total.
Destinatários que recusaram o rastreamento na página de preferências nunca são rastreados, mesmo com true.
E-mails enviados pela caixa não levam o cabeçalho List-Unsubscribe nem link de descadastro, a menos que você envie unsubscribe: true, porque são e-mails pessoais.
Toda pessoa que recebe um e-mail da caixa vira contato na lista “Webmail” da conta e passa a ser trusted nesta caixa: as respostas dela vão para a Inbox e o endereço aparece no autocomplete. Quem a caixa bloqueou continua bloqueado.
Com unsubscribe: true, destinatários que já cancelaram a inscrição desta caixa são recusados com RECIPIENT_UNSUBSCRIBED, e recipients lista quem são. Respostas nunca são bloqueadas.
Argumentos
tostring | string[]obrigatórioEndereço do destinatário, ou uma lista de até 30 endereços (planos pagos). Com
unsubscribe: truecada pessoa recebe a própria cópia; sem ele, todos emtoeccse veem.to_namestringopcionalNome do destinatário. O padrão é a parte antes do
@.subjectstringobrigatórioAssunto do e-mail.
htmlstringopcionalCorpo HTML. Envie
htmloutext.textstringopcionalCorpo em texto simples. É convertido para HTML com
<br>.ccstring[]opcionalCópias visíveis. to + cc + bcc até 50 endereços.
bccstring[]opcionalCópias ocultas. Nunca aparecem nos headers.
template_idstringopcionalPreenche o corpo (e um assunto vazio) a partir de um template. Os placeholders usam
to_nameevariables.variablesobjectopcionalSeus próprios placeholders do template:
{ "company": "Acme" }preenche{company}.attachmentsobject[]opcionalArquivos:
[{ file_name, content, content_type }],contentem base64. Até 20 arquivos, 25 MB no total. Todo arquivo é verificado.compose_uidstringopcionalAnexos enviados antes com
upload_attachment.attachment_idsstring[]opcionalQuais anexos enviados usar. Sem ele, todos.
followup_atstringopcionalLembra você se ninguém responder até essa data (RFC 3339,
YYYY-MM-DDou epoch ms).labelstringopcionalUm marcador para colocar na mensagem enviada. Vira
labels: [label].track_opensbooleanopcionalRastreia quando cada destinatário abre o e-mail (pixel invisível). Padrão
true.track_clicksbooleanopcionalRastreia cliques nos links (cada link passa por um redirecionamento). Padrão
true.unsubscribebooleanopcionalAdiciona um link de descadastro. Coloque
[unsubscribe]no corpo (nohrefde um link ou como texto) onde o link deve ficar; sem ele, uma linha padrão é adicionada no fim. Padrãofalse.audiencestringopcionalEnvia para um público em vez de endereços:
subscribed,opened,clicked,both,seg:<segment_id>oumsg:<message_uid>:opened|clicked|not_opened. Otofica opcional. Até 5.000 pessoas. O link de descadastro é ligado e o email sai como marketing. Planos pagos.
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "send_email",
args: {
to: "client@example.com",
to_name: "Client",
cc: [
"manager@example.com"
],
subject: "Quote",
html: "<p>Here is the quote.</p>",
attachments: [
{
file_name: "quote.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
],
followup_at: "2026-10-29T09:00:00+08:00",
label: "sales"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Resposta
{
"type": "SUCCESS",
"results": [
{
"command": "send_email",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"recipients": 2,
"queued": true
}
}
]
}Campos da resposta
message_uidO id da mensagem enviada. Ela aparece em
Sentimediatamente.thread_idA conversa da nova mensagem.
message_idUm Message-ID provisório. O SMTP real o substitui logo depois.
recipientsQuantas cópias entraram na fila (to + cc + bcc), 1 crédito cada.
queuedtrue= salvo e na fila de entrega. Não significa entregue.
Envios repetidos
A mesma escrita (mesmos args) repetida dentro de 1,5 segundo retorna o primeiro resultado em vez de enviar de novo. Um loop de polling que envia o mesmo e-mail duas vezes não o duplica.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
TOKEN_EXPIREDO access token expirou. Chame Refresh Token e repita a requisição.
- 401
INVALID_TOKENO token está malformado, é desconhecido ou foi revogado.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 em andamento para o mesmo IP + caixa de correio. Espere o número de segundos indicado em Retry-After.
- CMD
INVALID_AUDIENCEO público não é válido: grupo desconhecido, segmento de outra caixa ou mensagem que esta caixa não enviou.
- CMD
AUDIENCE_OVER_LIMITO público tem mais pessoas do que você pode enviar (até 5.000 por email e o seu limite diário). `total` e `allowed` dizem quantas.
- CMD
EMPTY_AUDIENCENinguém neste público agora.
- CMD
RECIPIENT_UNSUBSCRIBEDUm ou mais destinatários cancelaram a inscrição desta caixa. `recipients` lista quem são: remova-os ou envie de novo com `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDMais de um endereço em `to` exige um plano pago.
- CMD
TOO_MANY_RECIPIENTS`to` tem mais de 30 endereços.
- CMD
INVALID_ARGSUm argumento obrigatório está ausente ou é inválido.
- CMD
INVALID_TOADDRESSO endereço to não é um e-mail válido.
- CMD
INVALID_CCADDRESSUm dos endereços cc não é um e-mail válido.
- CMD
INVALID_BCCADDRESSUm dos endereços bcc não é um e-mail válido.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc e bcc juntos têm mais de 50 endereços.
- CMD
INVALID_ATTACHMENTO conteúdo de um anexo não é base64 válido.
- CMD
FILE_BLOCKEDUm arquivo foi bloqueado pela verificação de segurança.
- CMD
ATTACHMENTS_TOO_LARGEOs anexos do e-mail somam mais de 25 MB, ou a caixa de correio já tem 500 MB de uploads aguardando envio.
- CMD
ATTACHMENT_MISSINGUm anexo enviado não existe mais (uploads não enviados em 48 horas, e não usados por um rascunho ou e-mail agendado, são excluídos). Envie-o de novo.
- CMD
NO_CREDITSA conta tem menos créditos de e-mail do que destinatários (1 crédito por cópia).
- CMD
SENDER_NOT_FOUNDO remetente do token não está registrado.
- CMD
SENDER_NO_DOMAINO remetente do token não tem domínio.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.