Overview
Talki answers your phone, books appointments, and writes down who called and why. This API exists so another system — usually a CRM — can read that and act on it.
What you can do
Section titled “What you can do”| Resource | Read | Write |
|---|---|---|
| Calls | Yes, including the agent’s summary | No |
| Appointments | Yes | Yes (narrowed scope) |
| Contacts | Yes | Yes (narrowed scope) |
| Services | Yes | Yes (narrowed scope) |
What it deliberately does not expose
Section titled “What it deliberately does not expose”These are policy, not gaps waiting to be filled:
- Verbatim call transcripts and audio. Not available through the API, and not planned. Any future access would be a separate, separately-granted scope.
- Token counts and model costs. Internal accounting.
- Inbox state (read / archived flags) and refused-call rows. Dashboard concerns, not contract concerns.
Availability
Section titled “Availability”The API is a Business plan feature. A request made with a valid credential
on a lower plan fails with a distinct plan_upgrade_required error, so you can
tell the customer to upgrade rather than showing them a permission error.
Webhooks are separate and remain available from Pro upward.
Base URL
Section titled “Base URL”https://api.talki.it/v1