All Agent API Endpoints

Start a new conversation with your AI agent. Returns a conversation ID and the initial greeting message.

Send a message in an existing conversation. The AI agent processes the message and returns the reply on this same request. There is no separate stream.

Retrieve the full conversation history including all messages exchanged.

Close a live conversation, save its transcript, and remove the session.

Returns aggregated conversation statistics for a given period scoped to your agent. Use the ?month= parameter to fetch a full calendar month (e.g. March 2026). Includes total conversations, messages, completion rate, channel breakdown, lead count, and escalation count. For organization-owned agents this is served from a pre-aggregated table — fast even for large volumes.

Returns a day-by-day breakdown of conversations for the requested period. Every calendar day in the range is included — days with no activity return zeros. Useful for building charts or automating periodic reports.

Returns a paginated list of conversation transcripts for your agent — metadata only (no message history). Use the ?month= or start/end date parameters to narrow by period, and ?channel= or ?status= to filter further. To retrieve the full message history for a conversation, use the Get Transcript endpoint.

Fetch a single conversation transcript including the full turn-by-turn message history, extracted lead data, and form responses. The transcript must belong to the agent identified by your API key.

Retrieve leads captured by your AI agent(s). Supports pagination, search (including booking confirmation codes), date range filtering, and CRM status filtering. Use your agent API key (pk_live_) to scope results to a single agent, or your Search API key (sk_live_) to pull leads across all agents in your account.

Fetch a single lead by its ID. Returns the full lead object including all extracted fields, form responses, and CRM push details.

Webhooks are outbound — AskHandle calls YOUR server, not the other way around. Open Tools → Integrations & Actions, choose HTTP, pick When events, and enter your endpoint URL. AskHandle will POST a JSON payload when those events fire. You can also set an optional signing secret so your server can verify that requests genuinely come from AskHandle.