Contacts

Get a contact's sentiment history

Returns the contact's conversation sentiment over the last 30 days, merged into a single series across every channel in the company and keyed off the addresses in the contact's email array.

One point per day, oldest first. score is the average of the day's streams — each stream contributes one score, so a long conversation does not outweigh a short one — rounded to a whole number on a 0-100 scale. overall is the recency-weighted average across the window: today counts fully, a day at the edge of the window counts half. totalStreams counts the distinct conversations in the window, so a conversation spanning several days is counted once.

A contact with no email addresses, or with no scored conversations in the window, returns overall: null and an empty history.

get/api/contacts/{contactId}/sentiment

Request

Path parameters

contactIdstring required

The contact's _id.

Response

Sentiment history for the contact.

overallinteger nullable

Recency-weighted average score (0-100) across the window.

totalStreamsinteger

Distinct conversations behind the window.

Changes

No recorded changes to this operation across all 1 revision of this API.