Saltar para a documentação
API

Ler a atividade com um contacto

Os números por trás do separador Atividade de um contacto na app, ao longo de um período que termina agora: as mensagens recebidas do endereço e enviadas para ele por intervalo, as conversas que se mexeram, as conversas à espera de resposta da caixa, quando cada lado escreveu pela última vez e o tempo mediano que cada lado leva a responder.

GETapi.openemail.uk/contacts/{email}/activity

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

GET /contacts/{email}/activity

Os números por trás do separador Atividade de um contacto na app, ao longo de um período que termina agora: as mensagens recebidas do endereço e enviadas para ele por intervalo, as conversas que se mexeram, as conversas à espera de resposta da caixa, quando cada lado escreveu pela última vez e o tempo mediano que cada lado leva a responder.

Exemplo

Requer threads:read. minutes define até onde recua o período e vale 90 dias por omissão; grain é minute, hour ou day; offsetMinutes é o desvio do leitor em relação a UTC.

curl
curl "$OE/contacts/ada%40example.com/activity?minutes=43200&grain=day&offsetMinutes=120" -H "$AUTH"
Resposta
{  "object": "contact_activity",  "email": "[email protected]",  "since": "2026-08-24T22:00:00.000Z",  "until": "2026-09-23T10:30:00.000Z",  "grain": "day",  "buckets": [    { "bucket": "2026-09-21", "received": 2, "sent": 1 },    { "bucket": "2026-09-22", "received": 1, "sent": 0 }  ],  "totals": {    "received": 3,    "sent": 1,    "threads": 2,    "waiting": 1,    "lastReceivedAt": "2026-09-22T16:04:11.000Z",    "lastSentAt": "2026-09-21T09:40:00.000Z"  },  "replyTime": { "yours": 5400000, "theirs": 12600000 }}

buckets contém só os intervalos com correio, os mais antigos primeiro, na hora do leitor, para que um gráfico preencha as lacunas. waiting conta as conversas cuja mensagem mais recente é deste endereço.

replyTime é a mediana em milissegundos, yours para a caixa quando lhes responde e theirs para eles quando respondem à caixa, e null quando não há resposta para medir. O correio no lixo ou no spam fica de fora.