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.

POSThttps://g.sendcorex.com/v1command: send_email
i

queued: 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.

i

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.

i

Destinatários que recusaram o rastreamento na página de preferências nunca são rastreados, mesmo com true.

i

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.

i

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.

i

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ório

    Endereço do destinatário, ou uma lista de até 30 endereços (planos pagos). Com unsubscribe: true cada pessoa recebe a própria cópia; sem ele, todos em to e cc se veem.

  • to_namestringopcional

    Nome do destinatário. O padrão é a parte antes do @.

  • subjectstringobrigatório

    Assunto do e-mail.

  • htmlstringopcional

    Corpo HTML. Envie html ou text.

  • textstringopcional

    Corpo em texto simples. É convertido para HTML com <br>.

  • ccstring[]opcional

    Cópias visíveis. to + cc + bcc até 50 endereços.

  • bccstring[]opcional

    Cópias ocultas. Nunca aparecem nos headers.

  • template_idstringopcional

    Preenche o corpo (e um assunto vazio) a partir de um template. Os placeholders usam to_name e variables.

  • variablesobjectopcional

    Seus próprios placeholders do template: { "company": "Acme" } preenche {company}.

  • attachmentsobject[]opcional

    Arquivos: [{ file_name, content, content_type }], content em base64. Até 20 arquivos, 25 MB no total. Todo arquivo é verificado.

  • compose_uidstringopcional

    Anexos enviados antes com upload_attachment.

  • attachment_idsstring[]opcional

    Quais anexos enviados usar. Sem ele, todos.

  • followup_atstringopcional

    Lembra você se ninguém responder até essa data (RFC 3339, YYYY-MM-DD ou epoch ms).

  • labelstringopcional

    Um marcador para colocar na mensagem enviada. Vira labels: [label].

  • track_opensbooleanopcional

    Rastreia quando cada destinatário abre o e-mail (pixel invisível). Padrão true.

  • track_clicksbooleanopcional

    Rastreia cliques nos links (cada link passa por um redirecionamento). Padrão true.

  • unsubscribebooleanopcional

    Adiciona um link de descadastro. Coloque [unsubscribe] no corpo (no href de um link ou como texto) onde o link deve ficar; sem ele, uma linha padrão é adicionada no fim. Padrão false.

  • audiencestringopcional

    Envia para um público em vez de endereços: subscribed, opened, clicked, both, seg:<segment_id> ou msg:<message_uid>:opened|clicked|not_opened. O to fica 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_uid

    O id da mensagem enviada. Ela aparece em Sent imediatamente.

  • thread_id

    A conversa da nova mensagem.

  • message_id

    Um Message-ID provisório. O SMTP real o substitui logo depois.

  • recipients

    Quantas cópias entraram na fila (to + cc + bcc), 1 crédito cada.

  • queued

    true = 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.

  • 401TOKEN_EXPIRED

    O access token expirou. Chame Refresh Token e repita a requisição.

  • 401INVALID_TOKEN

    O token está malformado, é desconhecido ou foi revogado.

  • 429RATE_LIMITED

    Mais 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.

  • CMDINVALID_AUDIENCE

    O público não é válido: grupo desconhecido, segmento de outra caixa ou mensagem que esta caixa não enviou.

  • CMDAUDIENCE_OVER_LIMIT

    O 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.

  • CMDEMPTY_AUDIENCE

    Ninguém neste público agora.

  • CMDRECIPIENT_UNSUBSCRIBED

    Um ou mais destinatários cancelaram a inscrição desta caixa. `recipients` lista quem são: remova-os ou envie de novo com `unsubscribe: false`.

  • CMDPAID_PLAN_REQUIRED

    Mais de um endereço em `to` exige um plano pago.

  • CMDTOO_MANY_RECIPIENTS

    `to` tem mais de 30 endereços.

  • CMDINVALID_ARGS

    Um argumento obrigatório está ausente ou é inválido.

  • CMDINVALID_TOADDRESS

    O endereço to não é um e-mail válido.

  • CMDINVALID_CCADDRESS

    Um dos endereços cc não é um e-mail válido.

  • CMDINVALID_BCCADDRESS

    Um dos endereços bcc não é um e-mail válido.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc e bcc juntos têm mais de 50 endereços.

  • CMDINVALID_ATTACHMENT

    O conteúdo de um anexo não é base64 válido.

  • CMDFILE_BLOCKED

    Um arquivo foi bloqueado pela verificação de segurança.

  • CMDATTACHMENTS_TOO_LARGE

    Os anexos do e-mail somam mais de 25 MB, ou a caixa de correio já tem 500 MB de uploads aguardando envio.

  • CMDATTACHMENT_MISSING

    Um 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.

  • CMDNO_CREDITS

    A conta tem menos créditos de e-mail do que destinatários (1 crédito por cópia).

  • CMDSENDER_NOT_FOUND

    O remetente do token não está registrado.

  • CMDSENDER_NO_DOMAIN

    O remetente do token não tem domínio.

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.