Receber e-mails: Contato e follow-up
Obter contato
Quem é esta pessoa na sua caixa de correio: conversas, confiança, sua nota, cancelamentos de inscrição, follow-ups, as regras que a pegam e o provedor de onde ela envia.
https://g.sendcorex.com/v1command: get_contactAs contagens olham os últimos 50 e-mails em cada sentido. capped: true significa que há mais.
Argumentos
emailstringobrigatórioO endereço do contato.
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "get_contact",
args: {
email: "ana@client.com"
}
}
]
},
{ 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": "get_contact",
"id": "0",
"type": "SUCCESS",
"data": {
"email": "ana@client.com",
"name": "Ana Costa",
"domain": "client.com",
"provider": "microsoft_365",
"free_email": false,
"received": 18,
"sent": 11,
"conversations": 9,
"capped": false,
"first_at": "2026-03-02T02:10:00Z",
"last_at": "2026-10-24T03:10:00Z",
"recent": [
{
"thread_id": "thr_9a1c4e72",
"subject": "Proposal",
"date": "2026-10-24T03:10:00Z",
"from_them": true,
"unread": false
}
],
"trust": "trusted",
"note": "VIP, prefers WhatsApp",
"followups": [
{
"thread_id": "thr_9a1c4e72",
"message_uid": "Vj0xQUJDMTIz",
"status": "pending",
"remind_at": "2026-10-29T01:00:00Z",
"sent_at": "2026-10-26T01:00:00Z",
"subject": "Proposal",
"to_email": "ana@client.com",
"created_at": "2026-10-26T01:00:00Z"
}
],
"matching_rules": [
{
"id": "Vj0xUlVMRTAx",
"name": "Clients always in Inbox"
}
]
}
}
]
}Campos da resposta
providerDe onde veio o último e-mail dela, verificado na entrega (veja Criar regra). Sem isso, um palpite a partir do domínio.
trusttrusted,untrustedoudefault.unsubscribedPresente quando você cancelou a inscrição na lista dela.
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_ARGSUm argumento obrigatório está ausente ou é inválido.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.