What is an AI avatar agent API?

An AI avatar agent API is a programmable interface that lets developers create, train, and deploy AI-powered video avatars that can conduct sales conversations, product demos, qualification calls, and customer support interactions autonomously. The avatar appears as a realistic video participant, speaks naturally, answers questions from a knowledge base, and can escalate to human agents when needed.

How many endpoints does V100's avatar agent API have?

V100's avatar agent API includes 55+ endpoints covering the full avatar lifecycle: creation, training, knowledge base management, persona configuration, deployment (widget, iframe, API), session management, escalation rules, analytics, CRM integration, and calendar sync.

Can AI avatars switch between different personas?

Yes. V100 avatars support persona switching, allowing a single avatar to adapt its communication style based on the audience. A technical persona uses detailed specifications and architecture language. An executive persona focuses on ROI, strategic value, and business outcomes. An SMB persona emphasizes simplicity, pricing, and quick time-to-value. Persona switching can be triggered automatically based on visitor data or manually via API.

55+ ENDPOINTS

AI Avatar Agent API
for Sales & Support

An AI avatar agent API lets developers create, train, and deploy autonomous AI video avatars that conduct sales conversations, product demonstrations, lead qualification, and customer support -- all through a programmable interface. V100 provides 55+ endpoints covering the complete avatar lifecycle: creation, knowledge base ingestion, persona switching, widget deployment, escalation rules, session management, and deep CRM integration with Salesforce and HubSpot. Your AI sales team works 24/7, speaks 40+ languages, and never forgets a product detail.

Get API Key View API Reference

55+ API endpoints

Knowledge base powered (RAG)

Persona switching (tech/exec/SMB)

The Complete Avatar Lifecycle

V100's avatar agent API covers every stage from creation to deployment to optimization. Each stage is fully programmable, allowing engineering teams to build custom avatar experiences tailored to their sales process, product complexity, and buyer personas.

Create and Train

Define an avatar's visual appearance, voice, personality, and communication style through the API. Upload training materials -- product documentation, FAQs, case studies, competitive battle cards -- to build the avatar's knowledge base. The avatar uses retrieval-augmented generation (RAG) to answer questions accurately using your actual content.

POST /v1/avatars -- create avatar with personality config

POST /v1/avatars/:id/knowledge -- ingest documents

POST /v1/avatars/:id/train -- trigger training pipeline

GET /v1/avatars/:id/status -- check training progress

Knowledge Base Ingestion

Feed your avatar everything it needs to know. V100 ingests documents, PDFs, URLs, website crawls, FAQ databases, and case studies. Content is chunked, embedded, and indexed for real-time retrieval during conversations. The avatar cites its sources and never hallucinates beyond its knowledge base.

PDF, DOCX, TXT, MD, HTML document ingestion

URL crawling with configurable depth and scope

Auto-sync: re-crawl on schedule to catch updates

Knowledge gap analysis: identify missing topics

Persona Switching

A single avatar can adapt its communication style to match the audience. Persona switching changes the avatar's vocabulary, depth of technical detail, talking speed, and focus areas. Switch personas programmatically based on visitor data or let the avatar auto-detect based on the conversation.

Technical: architecture details, specs, integrations, benchmarks

Executive: ROI, strategic value, competitive positioning

SMB: simplicity, pricing, quick-start, time-to-value

Custom personas with configurable tone and focus

Widget Deployment

Deploy avatars anywhere with a single script tag or iframe embed. The avatar widget handles video rendering, audio I/O, conversation UI, and escalation flows. Fully customizable with CSS variables and theming. Responsive across desktop, tablet, and mobile.

Script tag embed: one line of code to deploy

iFrame embed for sandboxed environments

API-only mode for custom UIs

White-label theming with your brand

Escalation Rules and Session Management

AI avatars handle the majority of initial interactions, but some conversations need a human. V100's escalation system lets you define exactly when and how the avatar hands off to a live agent, preserving full conversation context so the human picks up without the visitor repeating themselves.

Trigger-Based Escalation

Define escalation triggers: explicit human request, pricing negotiation detected, competitor mention, technical question outside knowledge base, sentiment drop below threshold, or custom keyword triggers. Each trigger can route to a different team or individual.

Context Preservation

When escalation triggers, the human agent receives the full conversation transcript, visitor profile, questions asked, knowledge base articles referenced, lead qualification score, and recommended talking points. Zero context loss during handoff.

Session Persistence

Sessions persist across page navigations and return visits. If a visitor leaves and comes back a week later, the avatar remembers the previous conversation and picks up where they left off. Session data is encrypted and configurable with custom TTLs.

CRM and Calendar Integration

Every avatar interaction is automatically logged to your CRM. When a visitor is ready to book a meeting with a human, the avatar accesses your team's calendar availability and schedules the meeting on the spot -- all within the same conversation.

CRM Integration

Salesforce and HubSpot native

Lead creation from avatar conversations

Activity logging with full transcripts

Qualification scoring to CRM fields

Bi-directional: CRM data enriches avatar context

Calendar Integration

Google Calendar and Outlook native

Real-time availability checking

Meeting scheduling within conversation

Round-robin and skill-based routing

Confirmation emails with meeting context

Integration Guide

Deploy an AI avatar on your website in under 10 minutes. Create the avatar, upload knowledge, and embed the widget.

1

Create Avatar

Define personality, voice, appearance, and default persona through the API.

2

Upload Knowledge

Ingest product docs, FAQs, case studies, and competitive battle cards into the knowledge base.

3

Deploy Widget

Add one script tag to your site. The avatar is live and ready to engage visitors.

create-avatar-agent.js

// npm install v100-sdk
import { V100 } from 'v100-sdk';

const v100 = new V100('YOUR_API_KEY');

// Step 1: Create an AI avatar agent
const avatar = await v100.avatars.create({
  name: 'Alex',
  role: 'Sales Engineer',
  voice: 'professional-male-1',
  language: 'en',
  personality: {
    tone: 'friendly-professional',
    greeting: 'Hi! I\'m Alex, a sales engineer. How can I help?',
    fallback: 'Great question. Let me connect you with a specialist.'
  },
  personas: {
    technical: { focus: ['architecture', 'APIs', 'benchmarks'] },
    executive: { focus: ['ROI', 'strategy', 'competitive'] },
    smb:       { focus: ['pricing', 'simplicity', 'quick-start'] }
  },
  escalation: {
    triggers: ['pricing_negotiation', 'human_request', 'knowledge_gap'],
    routeTo: 'sales-team@yourco.com',
    preserveContext: true
  }
});

// Step 2: Upload knowledge base
await v100.avatars.knowledge.upload(avatar.id, {
  sources: [
    { type: 'url', url: 'https://docs.yourco.com', crawlDepth: 3 },
    { type: 'pdf', path: './product-datasheet.pdf' },
    { type: 'faq', url: 'https://yourco.com/faq.json' }
  ],
  autoSync: { enabled: true, interval: 'daily' }
});

// Step 3: Get widget embed code
const widget = await v100.avatars.deploy(avatar.id, {
  type: 'widget',
  position: 'bottom-right',
  theme: { primaryColor: '#4F46E5', borderRadius: '16px' },
  crm: { provider: 'salesforce', connectionId: 'crm_xxx' },
  calendar: { provider: 'google', teamId: 'sales-east' }
});

// widget.embedCode → <script src="https://cdn.v100.ai/avatar/xxx.js"></script>

Pricing

AI avatar agents are usage-based. You pay for avatar session minutes and knowledge base storage. No per-seat fees, no minimums on Pro.

Free Tier

$0/mo

Test avatar agents in development.

1 avatar

60 session minutes

10 MB knowledge base

No CRM sync

RECOMMENDED

Pro

Usage-based

Production avatars with full features.

Unlimited avatars

$0.01/min avatar sessions

CRM + calendar integration

Persona switching

Enterprise

Custom

Custom avatar training and deployment.

Volume discounts

Custom voice cloning

Dedicated infrastructure

Priority support

AI Avatar Agent API
for Sales & Support

The Complete Avatar Lifecycle

Create and Train

Knowledge Base Ingestion

Persona Switching

Widget Deployment

Escalation Rules and Session Management

Trigger-Based Escalation

Context Preservation

Session Persistence

CRM and Calendar Integration

CRM Integration

Calendar Integration

Integration Guide

Create Avatar

Upload Knowledge

Deploy Widget

Pricing

Deploy Your First AI Avatar Agent Today

Related Resources

AI Knowledge Base API

CRM Integration API

AI Sales Avatar

AI Avatar Agent APIfor Sales & Support

The Complete Avatar Lifecycle

Create and Train

Knowledge Base Ingestion

Persona Switching

Widget Deployment

Escalation Rules and Session Management

Trigger-Based Escalation

Context Preservation

Session Persistence

CRM and Calendar Integration

CRM Integration

Calendar Integration

Integration Guide

Create Avatar

Upload Knowledge

Deploy Widget

Pricing

Deploy Your First AI Avatar Agent Today

Related Resources

AI Knowledge Base API

CRM Integration API

AI Sales Avatar

AI Avatar Agent API
for Sales & Support