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.
https://g.sendcorex.com/v1command: forwardO 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.
Destinatários que recusaram o rastreamento na página de preferências nunca são rastreados, mesmo com true.
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.
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.
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órioO
message_uidda mensagem a encaminhar.tostringobrigatórioQuem recebe o encaminhamento.
to_namestringopcionalNome do destinatário.
ccstring[]opcionalCópias visíveis. to + cc + bcc até 50 endereços.
bccstring[]opcionalCópias ocultas.
htmlstringopcionalSeu texto acima do e-mail encaminhado. Envie
htmloutext.textstringopcionalVersão em texto simples da sua nota.
include_attachmentsbooleanopcionalEnvia os anexos originais. O padrão é
true.quote_originalbooleanopcionalAdiciona o bloco Forwarded message. O padrão é
true.attachmentsobject[]opcionalArquivos a anexar:
[{ file_name, content, content_type }],contentem base64. Até 20 arquivos e 25 MB no total. Todo arquivo é verificado; um arquivo perigoso falha comFILE_BLOCKED.compose_uidstringopcionalAnexos que você enviou antes com
upload_attachment.attachment_idsstring[]opcionalQuais dos anexos enviados usar. Sem ele, todos.
track_opensbooleanopcionalRastreia quando cada destinatário abre o e-mail (pixel invisível). Padrão
true.track_clicksbooleanopcionalRastreia cliques nos links (cada link passa por um redirecionamento). Padrão
true.unsubscribebooleanopcionalAdiciona um link de descadastro. Coloque
[unsubscribe]no corpo (nohrefde um link ou como texto) onde o link deve ficar; sem ele, uma linha padrão é adicionada no fim. Padrãofalse.
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_uidO id do encaminhamento em Enviados.
recipientsQuantas 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.
- 401
TOKEN_EXPIREDO access token expirou. Chame Refresh Token e repita a requisição.
- 401
INVALID_TOKENO token está malformado, é desconhecido ou foi revogado.
- 429
RATE_LIMITEDMais 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.
- CMD
RECIPIENT_UNSUBSCRIBEDUm ou mais destinatários cancelaram a inscrição desta caixa. `recipients` lista quem são: remova-os ou envie de novo com `unsubscribe: false`.
- CMD
INVALID_ARGSUm argumento obrigatório está ausente ou é inválido.
- CMD
NOT_FOUNDA mensagem, conversa ou pasta não existe para este token.
- CMD
INVALID_RECIPIENTO destinatário está ausente ou não é um e-mail válido.
- CMD
ATTACHMENTS_TOO_LARGEOs anexos do e-mail somam mais de 25 MB, ou a caixa de correio já tem 500 MB de uploads aguardando envio.
- CMD
FILE_BLOCKEDUm arquivo foi bloqueado pela verificação de segurança.
- CMD
NO_CREDITSA conta tem menos créditos de e-mail do que destinatários (1 crédito por cópia).
- CMD
SENDER_NOT_FOUNDO remetente do token não está registrado.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.