谈案宝 Logo
谈案宝

谈案宝 API 文档

Integrate 谈案宝 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 谈案宝 into web applications

npm install @tananbao/js-sdk

Python SDK

Build Python applications with 谈案宝

pip install tananbao-python

iOS SDK

Add 谈案宝 to iOS applications

pod '谈案宝-iOS-SDK'

React Native

Cross-platform mobile integration

npm install @tananbao/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 谈案宝 into your applications.

Visit Help CenterView Documentation