Receber e-mails: Agendamento

Agendar envio

Escreva o e-mail agora e envie depois. Ele fica na pasta Scheduled até a hora que você escolher.

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

Tudo o que pode ser verificado é verificado agora (destinatário, assunto, e-mail original, anexos), para você saber antes da hora chegar. Créditos e o limite diário são verificados no envio.

i

Se o envio for recusado nessa hora (sem créditos, limite diário, spam), nada se perde: o e-mail volta para Rascunhos com o motivo.

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

  • send_atstringobrigatório

    RFC 3339, YYYY-MM-DD ou epoch ms. No mínimo 1 minuto a partir de agora e até 1 ano.

  • modestringopcional

    new (padrão), reply ou forward.

  • idstringopcional

    A mensagem original, para reply e forward.

  • tostring | string[]opcional

    Destinatário. Obrigatório em new e forward. Em new pode ser uma lista de até 30 (planos pagos).

  • ccstring[]opcional

    Cópias visíveis.

  • bccstring[]opcional

    Cópias ocultas.

  • subjectstringopcional

    Obrigatório para new. Reply e forward usam por padrão Re: / Fwd: original.

  • htmlstringopcional

    Corpo HTML. Ou text, ou template_id.

  • template_idstringopcional

    Preenche o corpo (e o assunto de um e-mail novo) a partir de um template.

  • followup_after_hoursnumberopcional

    Lembra você se ninguém responder em tantas horas após o envio.

  • scheduled_idstringopcional

    Reagendar: o e-mail agendado antigo é substituído.

  • attachmentsobject[]opcional

    Arquivos a anexar: [{ file_name, content, content_type }], content em base64. Até 20 arquivos e 25 MB no total. Todo arquivo é verificado; um arquivo perigoso falha com FILE_BLOCKED.

  • compose_uidstringopcional

    Anexos que você enviou antes com upload_attachment.

  • attachment_idsstring[]opcional

    Quais dos anexos enviados usar. Sem ele, todos.

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

  • best_timebooleanopcional

    Envia para cada pessoa no horário em que ela costuma abrir ou clicar, ao longo do dia de send_at. Precisa de audience e mode: new. send_at é 00:00 desse dia no seu fuso, em UTC.

  • best_fallback_atstring | numberopcional

    Horário para quem não tem histórico (RFC 3339 ou epoch ms). Precisa ser no mesmo dia de send_at.

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "schedule_send",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</p>",
          send_at: "2026-10-27T09:00:00+08:00"
        }
      }
    ]
  },
  { 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": "schedule_send",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "scheduled_id": "Vj0xQUJDMTIz",
        "thread_id": "thr_9a1c4e72",
        "send_at": "2026-10-27T01:00:00Z"
      }
    }
  ]
}

Campos da resposta

  • scheduled_id

    A mensagem em Scheduled. Use-a para cancelar, reagendar ou enviar agora.

Listar o que está agendado

Os e-mails agendados ficam na pasta Scheduled, ordenados pela hora de envio.

Body da requisição

{
  "commands": [
    {
      "command": "list_messages",
      "args": {
        "folder": "Scheduled"
      }
    }
  ]
}

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.

  • CMDBEST_TIME_NEEDS_AUDIENCE

    `best_time` precisa de um `audience` e `mode: new`.

  • 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_TIME

    send_at está ausente, a menos de 1 minuto ou a mais de 1 ano de distância.

  • CMDINVALID_RECIPIENT

    O destinatário está ausente ou não é um e-mail válido.

  • CMDMISSING_SUBJECT

    Um e-mail novo precisa de assunto.

  • CMDMISSING_TARGET

    Reply e forward precisam do e-mail original, e ele ainda precisa existir.

  • CMDRECIPIENT_LIMIT_EXCEEDED

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

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

  • CMDINTERNAL

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