API Documentation

Complete API reference for AION Chatbot Backend with optimized streaming and enhanced caching

5
AI Agents
40+
Endpoints
REST
& WebSocket
v2.0
Optimized

Dynamic Chatbot Generator

Create custom chatbots from natural language prompts with AI-powered intent extraction, auto-mapped nodes, and Pinecone integration for product recommendations.

✨ AI Intent Extraction 🤖 Auto-mapped Nodes 📦 Pinecone Upload 🔄 Real-time WebSocket
Launch Generator

AI Chatbot Agents (v1.0 Legacy)

Riccio Agent

v1.0

Legacy main chatbot with direct graph integration

REST Endpoints:
POST /api/v1/riccio/query_bot
POST /api/v1/riccio/clean
POST /api/v1/riccio/feedback
POST /api/v1/riccio/rating
POST /api/v1/riccio/query_whatsapp
WebSocket Events:
curly_hair_ai_agent_stream_start
curly_hair_ai_agent_stream_response

Coffee Agent

v1.0

Legacy coffee agent with OpenAI formatting

REST Endpoints:
POST /api/v1/coffee/query_bot
POST /api/v1/coffee/clean
POST /api/v1/coffee/feedback
POST /api/v1/coffee/rating
POST /api/v1/coffee/query_whatsapp
GET /api/v1/coffee/conversations
WebSocket Events:
coffee_ai_agent_stream_start
coffee_ai_agent_stream_response

AionSoft Agent

v1.0

Legacy enterprise agent with direct implementation

REST Endpoints:
POST /api/v1/aionsoft/query_bot
POST /api/v1/aionsoft/clean
POST /api/v1/aionsoft/feedback
POST /api/v1/aionsoft/rating
POST /api/v1/aionsoft/query_whatsapp
WebSocket Events:
aionsoft_ai_agent_stream_start
aionsoft_ai_agent_stream_response

GBS Agent

v1.0

Legacy GBS agent with individual implementation

REST Endpoints:
POST /api/v1/gbs/query_bot
POST /api/v1/gbs/clean
POST /api/v1/gbs/feedback
POST /api/v1/gbs/rating
POST /api/v1/gbs/query_whatsapp
WebSocket Events:
gbs_ai_agent_stream_start
gbs_ai_agent_stream_response

Amati Agent

v1.0

Legacy Amati agent with standalone architecture

REST Endpoints:
POST /api/v1/amati/query_bot
POST /api/v1/amati/clean
POST /api/v1/amati/feedback
POST /api/v1/amati/rating
POST /api/v1/amati/query_whatsapp
WebSocket Events:
amati_ai_agent_stream_start
amati_ai_agent_stream_response

AI Chatbot Agents (v2.0 Optimized)

Riccio Agent

v2.0

Optimized main chatbot with unified service architecture

REST Endpoints:
POST /api/v2/riccio/query_bot
POST /api/v2/riccio/clean
POST /api/v2/riccio/feedback
POST /api/v2/riccio/rating
POST /api/v2/riccio/query_whatsapp
GET /api/v2/riccio/health
GET /api/v2/riccio/stats
WebSocket Events:
curly_hair_ai_agent_stream_start_v2
curly_hair_ai_agent_stream_response_v2

Coffee Agent

v2.0

Coffee-specialized agent with enhanced caching

REST Endpoints:
POST /api/v2/coffee/query_bot
POST /api/v2/coffee/clean
POST /api/v2/coffee/feedback
POST /api/v2/coffee/rating
POST /api/v2/coffee/query_whatsapp
GET /api/v2/coffee/health
GET /api/v2/coffee/stats
WebSocket Events:
coffee_ai_agent_stream_start_v2
coffee_ai_agent_stream_response_v2

AionSoft Agent

v2.0

Enterprise agent with optimized streaming

REST Endpoints:
POST /api/v2/aionsoft/query_bot
POST /api/v2/aionsoft/clean
POST /api/v2/aionsoft/feedback
POST /api/v2/aionsoft/rating
POST /api/v2/aionsoft/query_whatsapp
GET /api/v2/aionsoft/health
GET /api/v2/aionsoft/stats
WebSocket Events:
aionsoft_ai_agent_stream_start_v2
aionsoft_ai_agent_stream_response_v2

GBS Agent

v2.0

GBS-focused agent with unified service layer

REST Endpoints:
POST /api/v2/gbs/query_bot
POST /api/v2/gbs/clean
POST /api/v2/gbs/feedback
POST /api/v2/gbs/rating
POST /api/v2/gbs/query_whatsapp
GET /api/v2/gbs/health
GET /api/v2/gbs/stats
WebSocket Events:
gbs_ai_agent_stream_start_v2
gbs_ai_agent_stream_response_v2

Amati Agent

v2.0

Amati-specialized agent with error handling

REST Endpoints:
POST /api/v2/amati/query_bot
POST /api/v2/amati/clean
POST /api/v2/amati/feedback
POST /api/v2/amati/rating
POST /api/v2/amati/query_whatsapp
GET /api/v2/amati/health
GET /api/v2/amati/stats
WebSocket Events:
amati_ai_agent_stream_start_v2
amati_ai_agent_stream_response_v2

Builder APIs

Chatbot Builder
Create and manage chatbots
/api/v1/chatbots
State Builder
Manage chatbot states
/api/v1/states
Model Builder
Define data models
/api/v1/models
Node Builder
Create conversation nodes
/api/v1/nodes
Graph Builder
Build conversation graphs
/api/v1/graphs

Backoffice APIs

Settings
Application configuration
/api/v1/settings/
Conversations
Chat history management
/api/v1/conversations/
Prompts
Prompt templates
/api/v1/prompts/
Users
User management
/api/v1/users
Customer Care
Support management
/api/v1/customer-care/
Bots Management
Bot configuration
/api/v1/bots

Streaming API

Real-time communication with optimized WebSocket connections

Stream Health
Monitor streaming status
/api/v2/stream/health
Stream Connections
Active connections
/api/v2/stream/connections
Agent Stats
Performance metrics
/api/v2/{agent}/stats

Features

Unified Agent Service
Optimized Streaming
Enhanced Caching
Health Monitoring
CORS Enabled
Session Management