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.
https://g.sendcorex.com/v1command: replyO 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.
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 que você está respondendo.htmlstringopcionalCorpo HTML. Envie
htmloutext.textstringopcionalCorpo em texto simples.
reply_allbooleanopcionalTodos no To e no Cc da original vão em Cc, exceto você e a pessoa a quem você responde.
ccstring[]opcionalDestinatários extras em cópia.
bccstring[]opcionalDestinatários extras em cópia oculta.
template_idstringopcionalPreenche o corpo a partir de um template.
attachmentsobject[]opcionalArquivos em base64, mesmo formato de Enviar e-mail.
compose_uidstringopcionalAnexos enviados antes com
upload_attachment.followup_atstringopcionalLembra você se ninguém responder até essa data. Sem ele, um lembrete já definido na conversa é removido (você acabou de responder).
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.recipientstringopcionalSó 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_uidO id da resposta.
thread_idA mesma conversa da mensagem original.
message_idUm Message-ID provisório, substituído pelo SMTP real logo depois.
queuedtrue= 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' } },
]);
}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.
- 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
INVALID_RECIPIENTO destinatário está ausente ou não é um e-mail válido.
- 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
NO_RECIPIENTA conversa não tem destinatário para responder.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc e bcc juntos têm mais de 50 endereços.
- CMD
FILE_BLOCKEDUm arquivo foi bloqueado pela verificação de segurança.
- 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
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
SENDER_NO_DOMAINO remetente do token não tem domínio.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.