Documentation

Caller enrichment

Northsun (formerly Mnemix) combines remembered interaction history with real-world caller context in the same pre-interaction response. Enrichment is additive: your agent must remain useful when some or all enrichment fields are unavailable.

Public sources

The public enrichment vendors are:

  • Trestle for person and company context where available.
  • Twilio Lookup for phone intelligence such as carrier and line type.

No other vendor should appear in public Northsun documentation unless the claims registry is amended after that vendor is actually wired.

Response shape

POST /v1/recall_and_enrich returns three nullable enrichment branches:

{
  "enrichment": {
    "person": { "name": "...", "title": "...", "company": "..." },
    "company": { "name": "...", "address": {} },
    "phone": { "carrier": "...", "line_type": "..." }
  }
}

Each branch can be null. Fields within an available branch can also be null or absent. Treat values as context for the agent, not as unquestionable identity proof.

Cold and returning callers

For a caller Northsun has not seen, recall_and_enrich creates the caller record and attempts enrichment alongside memory lookup. For a returning caller, cached enrichment may be returned without calling a vendor on that request. The response's timing_ms and freshness fields describe that request; they are diagnostic fields, not public benchmark claims.

Use enrichment safely

  • Prefer neutral greetings until identity is sufficiently established.
  • Never reveal sensitive enrichment data merely because it is present.
  • Allow the caller to correct a name, company, or phone classification.
  • Keep platform consent, recording, and data-handling requirements separate from the enrichment lookup.
  • Do not block the conversation when enrichment is missing or late.

Enrichment versus memory

Enrichment answers, “What external context is available for this identifier?” Memory answers, “What has this tenant observed in prior interactions?” Northsun returns both because a first-time caller may have no memory, while a returning caller may need no new enrichment.

Next steps