Receber e-mails: Rascunhos

Salvar rascunho

Salve um e-mail em Rascunhos sem enviá-lo. Ele abre no webmail como qualquer outro rascunho, e você pode enviá-lo depois com send_draft.

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

Um rascunho pode estar incompleto: todos os campos são opcionais. O que você envia é verificado (um to que não é e-mail falha), o que você deixa de fora, não.

!

Para editar um rascunho, envie o draft_id dele. Os campos que você deixar de fora são mantidos (corpo, destinatários, assunto, anexos, follow-up). Cada salvamento retorna um NOVO draft_id e o antigo para de funcionar, então guarde sempre o último.

i

Se track_opens ou track_clicks for omitido, o rascunho mantém a escolha que já tinha. O send_draft e o envio agendado usam essa escolha.

i

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

Argumentos

  • draft_idstringopcional

    Edita este rascunho em vez de criar um novo.

  • modestringopcional

    new (padrão), reply ou forward. Na edição, o rascunho mantém o modo.

  • idstringopcional

    A mensagem original, para reply e forward. O assunto padrão é Re: / Fwd: original.

  • tostring | string[]opcional

    Destinatário, ou uma lista de até 30 para new (planos pagos). Ignorado em reply: vai para o remetente do original.

  • ccstring[]opcional

    Cópias visíveis.

  • bccstring[]opcional

    Cópias ocultas.

  • subjectstringopcional

    Assunto.

  • htmlstringopcional

    Corpo HTML. Ou text, ou template_id.

  • textstringopcional

    Corpo em texto simples, transformado em HTML simples.

  • template_idstringopcional

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

  • variablesobjectopcional

    Valores para as variáveis do template, como { "first_name": "Ana" }.

  • followup_after_hoursnumber | nullopcional

    Lembra você se ninguém responder em tantas horas após o envio (até 8760). null remove o lembrete.

  • attachmentsobject[]opcional

    Arquivos a anexar: [{ file_name, content, content_type }], content em base64. São adicionados aos arquivos que o rascunho já tem.

  • compose_uidstringopcional

    Arquivos enviados antes com upload_attachment ou Upload de arquivo grande.

  • attachment_idsstring[]opcional

    Quais dos arquivos 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.

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "save_draft",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</p>"
        }
      }
    ]
  },
  { 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": "save_draft",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "draft_id": "Vj0xRFJBRlQx",
        "thread_id": "thr_9a1c4e72"
      }
    }
  ]
}

Campos da resposta

  • draft_id

    O rascunho. Use-o para editar, ler, enviar ou excluir. Muda a cada salvamento.

  • thread_id

    A conversa à qual o rascunho pertence.

Editar um rascunho

Aqui só o assunto muda. O corpo, os destinatários e os anexos ficam como estavam.

Body da requisição

{
  "commands": [
    {
      "command": "save_draft",
      "args": {
        "draft_id": "Vj0xRFJBRlQx",
        "subject": "Proposal (v2)"
      }
    }
  ]
}

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.

  • CMDINVALID_ARGS

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

  • CMDPAID_PLAN_REQUIRED

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

  • CMDTOO_MANY_RECIPIENTS

    `to` tem mais de 30 endereços.

  • CMDDRAFT_NOT_FOUND

    O rascunho não existe mais: foi enviado, excluído ou salvo de novo (cada salvamento retorna um novo draft_id).

  • CMDMISSING_TARGET

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

  • CMDINVALID_RECIPIENT

    O destinatário está ausente ou 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.

  • CMDINTERNAL

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