ArtiSales Logo
ArtiSales

ArtiSales API Reference

Integrate ArtiSales AI sales coaching capabilities into your own applications. Build custom workflows, automate processes, and enhance your sales tools.

API Status: Operationalv1.0

Authentication

All API requests require authentication using an API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Note: Keep your API key secure. Do not share it or include it in client-side code.

API Endpoints

POST /api/v1/conversations/analyze

Analyze a sales conversation and receive AI-powered insights, coaching suggestions, and customer need extraction.

Request Body:

{
  "conversation_id": "conv_123",
  "audio_url": "https://example.com/audio.mp3",
  "language": "en",
  "industry": "real_estate",
  "participants": {
    "salesperson": "John Doe",
    "customer": "Jane Smith"
  }
}

Response:

{
  "conversation_id": "conv_123",
  "analysis": {
    "duration": 1800,
    "sentiment": 0.8,
    "key_phrases": ["budget conscious", "timeline important"],
    "objections": ["price"],
    "coaching_suggestions": [
      {
        "timestamp": 45,
        "suggestion": "Ask about specific budget constraints"
      }
    ]
  },
  "customer_needs": {
    "primary": ["cost_effective_solution", "quick_implementation"],
    "timeline": "within_3_months"
  },
  "confidence_score": 0.92
}
GET /api/v1/conversations/{conversation_id}/coaching

Get real-time coaching suggestions for an ongoing conversation.

Query Parameters:

last_message: string (optional) - The most recent message for context
timeout: number (optional) - Timeout in seconds (default: 30)

Response:

{
  "suggestions": [
    {
      "type": "question",
      "priority": "high",
      "content": "Ask about their budget timeline",
      "reasoning": "Customer mentioned price concerns earlier"
    }
  ],
  "risk_alerts": ["talking_too_much"],
  "sentiment_change": "negative_to_neutral"
}
GET /api/v1/users/{user_id}/training-plans

Retrieve personalized training plans and improvement recommendations.

Query Parameters:

timeframe: string (optional) - "week", "month", or "quarter"
industry: string (optional) - Filter by specific industry

Response:

{
  "user_id": "user_123",
  "timeframe": "week",
  "improvement_areas": [
    {
      "area": "question_technique",
      "current_score": 7.2,
      "target_score": 8.5,
      "exercises": ["open_ended_questions", "follow_up_techniques"]
    }
  ],
  "recommended_practice_scenarios": [
    {
      "scenario": "price_objection_handling",
      "difficulty": "intermediate",
      "estimated_time": 15
    }
  ]
}

SDKs & Libraries

JavaScript SDK

Integrate ArtiSales into web applications

npm install @artisales/js-sdk

Python SDK

Build Python applications with ArtiSales

pip install artisales-python

iOS SDK

Add ArtiSales to iOS applications

pod 'ArtiSales-iOS-SDK'

React Native

Cross-platform mobile integration

npm install @artisales/react-native

Rate Limits

100
Free Tier
requests per minute
1,000
Pro Tier
requests per minute
10,000
Enterprise
requests per minute

Need Help with Integration?

Our developer support team is here to help you integrate ArtiSales into your applications.