Made in 10Docs
GuidesAPI
Characters

Memories

A character remembers a returning person across calls, as short facts it learns after each call and uses in the next.

With memories on, a character remembers the people it talks to: short facts such as "Prefers to be called Sam" or "Asked about the price of the Pro plan on 5 November 2026", learned after each call and used the next time it talks with the same person.

Turn them on

Memories are off until you turn them on for a character, in its analysis settings (in the dashboard's Memories page, or through the API):

PATCH /v1/characters/{id}/analysis
{ "memories": true }

A character with memories on and its analysis otherwise off still remembers; its calls' analysis shows off.

Who a call is with

A character can only remember someone it can recognise. Each call says who it's with by a memory key:

Calls fromMemory key
Your server (POST /v1/calls)memory_key: your own id for the person, such as user_42
A meeting (POST /v1/meetings)memory_key, the same way
The website widgetvisitor:<id>: a random id the call page keeps in the visitor's browser
The dashboardNone: nothing is remembered

A memory key is 1 to 200 letters, digits and _ - : . @ + (400 invalid_field otherwise). Leave it out and nothing is remembered.

curl https://talk.madein10.com/v1/calls \
  -H "Authorization: Bearer $SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V", "memory_key": "user_42" }'

The widget's visitors

On the website widget, the memory key is the browser's visitor id. Whoever uses that browser, a shared computer for one, is "the same person" to the character.

One character, one person

What a character learns about a person, only that character uses. If Alex learns something about user_42, Sara meeting the same person starts from nothing.

Test calls keep memories of their own: trying an integration with a test key never changes what the live character remembers.

How it learns

After a call with a memory key, while the call is analysed, the character learns at most 5 new facts about the person, and drops facts the call shows are wrong or out of date.

A fact is one short sentence about the person. Never:

  • instructions to the assistant, or what only the AI said;
  • passwords, card or account numbers, or government ids;
  • health, religion, politics, sexuality or ethnicity;
  • anything about other people.

Facts about who the person is (their name, role, company, where they are based, the language they prefer, how they like to be spoken to) are kept apart from what happened on a call. When the person updates something, such as a new job, the old fact is replaced.

A fact over 300 characters, an empty one, or one already known (whatever its case, punctuation or spelling of the same letters) is left out. A character keeps at most 50 facts per person; past that, the oldest facts about calls go first, so who the person is stays.

How it uses them

When a call starts, what the character knows about the person goes last in what it reads: who they are first, then the newest facts, at most 4,000 characters. It uses them naturally and never reads them out as a list. Facts count as used when a call starts with them.

Seeing and forgetting

The dashboard's Memories page lists who each character remembers. Through the API:

MethodPathWhat
GET/v1/memoriesWho is remembered, by which character, most recently used first. character_id filters; q searches memory keys
GET/v1/memories/{memory_key}One person's facts, newest first: one character's, or every character's
DELETE/v1/memories/{memory_key}Forget this person: for one character with character_id, or for all
DELETE/v1/memories/{memory_key}/{fact_id}Forget one fact
A fact
{
  "id": "mem_9Pk3Wx6TbQ1nLv8RcH2d",
  "fact": "Prefers to be called Sam",
  "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",
  "call_id": "call_2Gx7Mb9KpQ4sVn1ZrT6e",
  "created_unix": 1793300110,
  "last_used_unix": 1793390000
}

A key sees and forgets its own env's memories only. Facts no call has used for 180 days are deleted. More in Memories and forgetting.

On this page