Receber e-mails: Envio e confiança

Encaminhar

Encaminhe uma mensagem para outra pessoa. Os anexos originais vão junto, e o e-mail é salvo na mesma conversa em Enviados.

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

O assunto vira Fwd: original e um bloco Forwarded message com o e-mail original é adicionado abaixo do seu texto. O encaminhamento não traz a conversa de volta para a Caixa de entrada.

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

  • idstringobrigatório

    O message_uid da mensagem a encaminhar.

  • tostringobrigatório

    Quem recebe o encaminhamento.

  • to_namestringopcional

    Nome do destinatário.

  • ccstring[]opcional

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

  • bccstring[]opcional

    Cópias ocultas.

  • htmlstringopcional

    Seu texto acima do e-mail encaminhado. Envie html ou text.

  • textstringopcional

    Versão em texto simples da sua nota.

  • include_attachmentsbooleanopcional

    Envia os anexos originais. O padrão é true.

  • quote_originalbooleanopcional

    Adiciona o bloco Forwarded message. O padrão é true.

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

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "forward",
        args: {
          id: "Vj0xQUJDMTIz",
          to: "finance@acme.com",
          html: "<p>Can you check this invoice?</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": "forward",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "message_uid": "Vj0xQUJDMTIz",
        "thread_id": "thr_9a1c4e72",
        "message_id": "5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90",
        "recipients": 1,
        "queued": true
      }
    }
  ]
}

Campos da resposta

  • message_uid

    O id do encaminhamento em Enviados.

  • recipients

    Quantas cópias entraram na fila (1 crédito cada).

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.

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

  • CMDINVALID_ARGS

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

  • CMDNOT_FOUND

    A mensagem, conversa ou pasta não existe para este token.

  • CMDINVALID_RECIPIENT

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

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

  • CMDFILE_BLOCKED

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

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

  • CMDINTERNAL

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