Made in 10Docs
GuidesAPI
Characters

Characters

What a character is made of, the fields you set, the prompt every call runs on, and the ways to make one.

A character is who your visitors and customers talk to: a name, your instructions, what it knows, one of our faces (or none) and a voice. Every call, whether it comes from the website widget, your own server, a meeting or the dashboard, is a call with one character.

Ways to make one

The fields

Only name is required. Strings are trimmed. A change sends only the fields to change; the others stay.

Prop

Type

A character also answers its id (chr_…), created_unix, updated_unix, and the ids of what it takes, in order: document_ids, guardrail_ids, pronunciation_ids and tool_ids.

Character
{
  "id": "chr_4fT9kQ2mXw7LbN3pZs8V",
  "name": "Alex",
  "role": "support",
  "instructions": "…",
  "greeting": "Hi, I'm Alex, an AI assistant. How can I help?",
  "knowledge": "…",
  "language": "auto",
  "face_id": "red-office",
  "voice_id": null,
  "tier": "standard",
  "max_call_seconds": 300,
  "record": true,
  "silence_check_seconds": 10,
  "silence_end_seconds": 20,
  "document_ids": ["doc_…"],
  "guardrail_ids": ["grd_…"],
  "pronunciation_ids": ["prn_…"],
  "tool_ids": ["tool_…"],
  "created_unix": 1793300000,
  "updated_unix": 1793300000
}

Roles and templates

RoleTemplate
blankNothing: you write everything.
supportCustomer support
salesSales
interviewerInterviewer. Takes no success criteria in call analysis.
receptionistReceptionist

The catalog (Get the catalog) has each template's instructions and greeting. They fill only the words you leave out, and only when the character is made.

Languages

language takes one of these codes: auto (whatever the person speaks), en English, fa Persian, ar Arabic, tr Turkish, de German, fr French, es Spanish, it Italian, pt Portuguese, nl Dutch, ru Russian, zh Chinese, ja Japanese, ko Korean, hi Hindi.

With one language set, a character still answers in the person's language when they speak another.

What it takes

Beyond its own fields, a character takes things your organization keeps once and shares between characters. Each is attached as a whole ordered list.

WhatAttach withPer character
DocumentsPUT /v1/characters/{id}/documents50
Guardrail setsPUT /v1/characters/{id}/guardrails10
Pronunciation dictionariesPUT /v1/characters/{id}/pronunciations5
ToolsPUT /v1/characters/{id}/tools20
MCP serversPUT /v1/characters/{id}/mcp-servers5

A call already running keeps what it started with; a change applies from the next call.

What every call runs on

You write the instructions; we write the rest of what the character reads at the start of a call, so every character behaves on a live call the same safe way:

  • It's an AI, and says so. Its first sentence says it's an AI assistant, and if anyone asks whether it's a real person, it says no. See AI disclosure.
  • It talks like a person on a call. Two or three short sentences a turn, one question at a time, no lists. It stops when it's interrupted, asks again when it didn't catch something, and says numbers, dates and web addresses the way people say them.
  • It speaks the right language: the person's with auto, otherwise its own, switching when someone speaks another.
  • It never invents facts, names, prices or promises. When the answer isn't in what it knows, it says it doesn't know.

Then come, in order: your greeting, your instructions, its guardrails ("rules you never break"), and what it knows: its own knowledge, then its documents. Last, when the call is with someone it has met before, what it remembers about them.

On one of our faces, the character keeps your name: the face only lends its look.

When nobody speaks

A call nobody speaks on doesn't run, and bill, to its full length. On a one-to-one call, after silence_check_seconds (10 by default) with neither the person nor the character speaking, the character asks once, briefly, whether they're still there. If nobody answers within silence_end_seconds more (20 by default), it says a short goodbye and the call ends. A word from the person starts the count again. Set silence_check_seconds to 0 to turn this off. Characters on a speech-to-speech tier take their own turns and don't do this.

In a meeting silence is normal, so these settings don't apply: the character leaves when no other person has been in the meeting for 60 seconds.

Deleting one

Delete a character removes it from every list, and new calls with it answer 404. A call already running goes on. Its website deployments are taken down (their keys revoked). Its past calls keep their copy of it.

On this page