Skip to main content

​
Send Chat Message

Send a text message to an agent and receive an AI response (non-voice interaction). POST /chats/interaction Authentication: JWT cookie or API key 
curl -X POST "https://api.vaani.ai/chats/interaction" \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=YOUR_TOKEN" \
  -d '{
    "agent_id": "ag_550e8400",
    "message": "What are your business hours?",
    "session_id": "chat_session_001"
  }'
Chat interactions use the same system prompt and knowledge base as voice calls, providing consistent responses across channels.

​
Get Chat Logs

Retrieve chat conversation history. GET /chats/logs
ParameterTypeDefaultDescription
pageinteger1Page number
page_sizeinteger25Items per page
agent_idstring—Filter by agent
session_idstring—Filter by session
curl -X GET "https://api.vaani.ai/chats/logs?agent_id=ag_550e8400&page=1" \
  -H "Cookie: access_token=YOUR_TOKEN"

​
Get Single Chat

GET /chats/{chat_id} Returns full chat history for a specific conversation session.