Overview

Conversational AI lets you deploy AI voice agents that hold natural conversations over the phone. An agent answers calls, speaks with callers using synthesised speech, understands their intent, and can carry out actions — all without human involvement.

This reference covers the Conversational AI API — the HTTP interface you use to create and configure agents, manage the knowledge they draw on, start text-only sessions, and receive conversation events.

Base path: https://api.simwood.com/convai/v1. Authentication, versioning, and error shapes follow the shared platform conventions.

When to use it

Reach for Conversational AI when you need AI-driven telephony: an agent that handles inbound calls on your SIP infrastructure, responds naturally to callers, and produces a full transcript and analysis on every call. You can also embed a text-only agent in a web or mobile application using the session endpoint.

Core concepts

The service is built from a small set of primitives. The Concepts page explains each one on its own terms; the guides and API reference link back here rather than re-explaining them.

• Agents — the core entity: a voice and a prompt that define how the agent speaks and behaves.
• Voices — the catalogue of speech synthesis voices an agent can use.
• Knowledge base — documents the agent can retrieve from during a conversation.
• Webhooks — HTTP callbacks that fire when a conversation starts or ends.
• SIP UAC — the SIP registration that connects an agent to your telephony infrastructure.
• Conversations — the record of what was said, by whom, and when, plus any analysis.