Skip to main content

BESS AI Documentation

BESS AI gives you voice + chat AI agents that don't just talk — they act. Agents answer your phone lines, your website widget, and your API; they look things up, book appointments, update your systems mid-conversation, and run follow-up workflows after it ends.

Where to start​

  • Documentation — task-by-task guides for the platform: building agents, connecting phone numbers, running batch campaigns, installing the website widget, monitoring conversations, and automating follow-ups. (Being ported — the section map mirrors the full platform capabilities.)
  • API Reference — the full REST API, generated from our live OpenAPI specification: request/response schemas, curl and raw HTTP samples, and a Python (bessai) SDK tab on every endpoint the SDK covers.
  • SDKs — pip install bessai / npm install bessai, plus the official n8n node; full per-method references for each published SDK.

The API in one minute​

Every API request authenticates with a bearer API key created in the console under Settings → API Keys:

curl https://api.bess-ai.com/v1/calls \
  -H "Authorization: Bearer sk_live_..."

Base URL: https://api.bess-ai.com · Keys are scoped (e.g. calls:write, chat:read) · Errors follow standard HTTP status codes with a JSON body.