Receber e-mails: Envio e confiança

Responder

Responda dentro da mesma conversa. A resposta é salva em Enviados e na INBOX, e o assunto vira Re: original.

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

O destinatário é o reply_to (ou from) da mensagem original. Se o id for uma mensagem que você enviou, a resposta vai para o último cliente que escreveu na conversa, não para você. Os marcadores da original são mantidos.

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 que você está respondendo.

  • htmlstringopcional

    Corpo HTML. Envie html ou text.

  • textstringopcional

    Corpo em texto simples.

  • reply_allbooleanopcional

    Todos no To e no Cc da original vão em Cc, exceto você e a pessoa a quem você responde.

  • ccstring[]opcional

    Destinatários extras em cópia.

  • bccstring[]opcional

    Destinatários extras em cópia oculta.

  • template_idstringopcional

    Preenche o corpo a partir de um template.

  • attachmentsobject[]opcional

    Arquivos em base64, mesmo formato de Enviar e-mail.

  • compose_uidstringopcional

    Anexos enviados antes com upload_attachment.

  • followup_atstringopcional

    Lembra você se ninguém responder até essa data. Sem ele, um lembrete já definido na conversa é removido (você acabou de responder).

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

  • recipientstringopcional

    Só em emails que esta caixa enviou: quem recebe o follow-up, na mesma conversa com “Re:”. A pessoa precisa ter recebido aquele email (senão INVALID_RECIPIENT). Sem ele, a resposta a um email enviado vai para quem recebeu, nunca de volta para a caixa.

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "reply",
        args: {
          id: "Vj0xQUJDMTIz",
          text: "Received, thank you!",
          reply_all: true
        }
      }
    ]
  },
  { 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": "reply",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "message_uid": "Vj0xQUJDMTIz",
        "thread_id": "thr_9a1c4e72",
        "message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
        "queued": true
      }
    }
  ]
}

Campos da resposta

  • message_uid

    O id da resposta.

  • thread_id

    A mesma conversa da mensagem original.

  • message_id

    Um Message-ID provisório, substituído pelo SMTP real logo depois.

  • queued

    true = salvo e na fila, não entregue.

Responder ao último e-mail de um remetente

Busque pelo remetente e responda ao resultado mais recente. A busca retorna a mensagem mais recente primeiro.

Node.js

const [s] = await call({
  command: 'search',
  args: { query: 'ana@client.com', field: 'from', limit: 5 },
});

const last = s.data.messages[0]; // newest first
if (last) {
  const [r] = await call({
    command: 'reply',
    args: { id: last.message_uid, html: '<p>Hi Ana, received!</p>' },
  });
  console.log(r.data); // { message_uid, thread_id, message_id, queued: true }
}

Responder a todas as conversas não lidas

Responda e marque a conversa como lida na mesma requisição, para o próximo polling não respondê-la de novo.

Node.js

const [l] = await call({ command: 'list_threads', args: { is_read: false, limit: 20 } });

for (const t of l.data.threads) {
  await call([
    { command: 'reply', args: { id: t.last_message_uid, text: 'We got your message and will get back to you.' } },
    { command: 'set_flags', args: { id: t.last_message_uid, is_read: true, scope: 'thread' } },
  ]);
}
i

Você também pode encadear list_threads e reply em uma requisição com $ref, usando o last_message_uid de cada thread.

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_RECIPIENT

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

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

  • CMDNO_RECIPIENT

    A conversa não tem destinatário para responder.

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

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