Contacts

Import names and useful background once, then Terri can recognize a phone number without leaking that context across accounts.

Import JSON or CSV

Upload the same CSV or JSON from Settings → Callers, or run terri contacts import ./contacts.csv or terri contacts import ./contacts.json. Imports are sent in batches of 500 and update the existing contact when the same E.164 number appears again.

CSV shape

CSV requires phone and name columns. Optional context or notes and semicolon-separated tags add the background the agent should know.

JSON shape

JSON accepts an array or an object with a contacts array. Each item uses phoneE164, name, optional context, optional tags, and optional agentMemoryEnabled.

Read and remove

List, edit notes, and delete callers on Settings → Callers. The CLI still has terri contacts list, terri contacts get +15550101234, and terri contacts delete +15550101234. The same operations are exposed as MCP tools for agents.

Tenant isolation and safety

Contact context is scoped to the authenticated account and treated as untrusted background. agentMemoryEnabled defaults to false; for outside callers, Terri can use contact memory only when the selected phone-number identity also has caller memory set to opt in.