Resonaa Logo

Developer

API

Upload audio and text at scale. Consistent APIs, background processing, and clear results.

Auth
Audio: API key • Sheet/Tickets: API key or signed-in session
Content Types
Audio: multipart/form-data • Sheet/Tickets: application/json
Processing
Background worker streams results incrementally
Quickstart
Four main paths to integrate with Resona.
Audio Upload
  1. Send audio file via POST /api/add-calls or URL via POST /api/addcallurl
  2. Store + duration detection happens automatically
  3. Call queued for analysis; check Calls/Dashboard
Sheet Upload
  1. Create job with schema: POST /api/resona/upload
  2. Stream rows in batches; repeat
  3. Finalize; track progress under Resonaa Sort
Ticket Upload
  1. Send conversation text via POST /api/tickets/upload
  2. Assign to agent; customer names auto-detected
  3. Tickets queued for analysis; check Tickets page
Chat APIs
  1. Choose endpoint: chatbot, calls, tickets, or reports
  2. Send user message with context (agent/call/ticket ID)
  3. Receive AI responses with conversation history
Audio Upload API
Upload audio files, auto-detect duration, and create call records.
POST /api/add-calls
Auth: form-data field api_key
Audio URL API
Download audio from URL, bypassing Vercel payload limits for large files.
POST /api/addcallurl
Auth: JSON field api_key
Sheet Upload API
Create a job, stream rows, and finalize for background processing.
POST /api/resona/upload
Auth: use API key or signed-in company session
Ticket Upload API
Create conversation tickets from text-based customer interactions.
POST /api/tickets/upload
Auth: use API key or signed-in company session
Chat APIs
Interactive chat with chatbots, calls, tickets, and report agents.
POST /api/*/chat
Auth: use API key or signed-in company session
Endpoint & Auth
Multipart form-data with API key.
POST /api/add-calls
  • api_key (string, required)
  • call (File, required) — MP3/WAV/M4A/WebM ≤100MB
  • customer_name (string, optional)
  • user_id (string, optional)
Examples
cURL
curl -X POST   -F api_key=YOUR_COMPANY_API_KEY   -F call=@/path/to/call.mp3   -F customer_name="Acme Corp"   https://your-domain.com/api/add-calls