Getting Started with Customer Support AI Monitor

Welcome to Customer Support AI Monitor! This comprehensive getting started guide will walk you through everything you need to begin monitoring, optimizing, and proving ROI from your AI customer support chatbots in under 15 minutes.

🎯 What You'll Achieve

By the end of this guide, you'll have real-time visibility into your AI chatbot's CSAT scores, escalation rates, and performance metrics - with zero impact on your existing codebase.

Prerequisites

Before you begin, make sure you have the following ready:

✅ Required

A Customer Support AI Monitor account (sign up free)
An AI chatbot or virtual assistant in production
Basic familiarity with APIs

💡 Recommended

Admin access to Zendesk or your support platform
Access to modify your chatbot's code or webhooks
10-15 minutes of focused setup time

Step 1: Create Your Account (2 minutes)

Setting up your Customer Support AI Monitor account is quick:

Visit csaimonitor.com/signup
Enter your work email address (we recommend using your company domain)
Choose your plan:
- Free Plan: 50 conversations/month - great for testing
- Starter: 2,000 conversations/month with full features
- Professional: 8,500 conversations/month with advanced analytics
Check your email and click the verification link
Complete the quick onboarding wizard (company name, role, support platform)

💡 Pro Tip: During onboarding, select your current support platform (Zendesk, Freshdesk) to get customized integration instructions.

Step 2: Generate Your API Key (1 minute)

Your API key authenticates requests to the Customer Support AI Monitor platform. Here's how to get it:

From your dashboard, click Settings in the left sidebar
Navigate to API Keys tab
Click the "Generate New API Key" button
Give your key a descriptive name (e.g., "Production Chatbot")
Copy the API key immediately - you won't see it again!

# Your API key looks like this:

amo_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

⚠️ Security Warning: Never commit API keys to version control or expose them in client-side code. Use environment variables instead.

Step 3: Track Your First Conversation (3 minutes)

Customer Support AI Monitor uses a simple REST API. You can integrate it from any programming language. Here are examples in Python and Node.js:

Python Example

import requests
import os
from datetime import datetime

API_KEY = os.environ.get("CSAIMONITOR_API_KEY")
API_URL = "https://api.csaimonitor.com/api/v1"

def track_conversation(conversation_id, messages, csat_score=None, escalated=False, topic=None):
    """Track a customer support conversation"""
    response = requests.post(
        f"{API_URL}/conversations",
        headers={
            "X-API-Key": API_KEY,
            "Content-Type": "application/json"
        },
        json={
            "conversation_id": conversation_id,
            "platform": "custom",  # or "zendesk", "freshdesk", "sdk"
            "messages": messages,
            "csat_score": csat_score,
            "escalated": escalated,
            "ai_handled": True,
            "topic": topic
        }
    )
    return response.json()

# Example: After your AI handles a customer query
def handle_customer_query(user_message, customer_id):
    # Your existing AI logic
    ai_response = your_ai_model.generate_response(user_message)
    
    # Track the conversation
    track_conversation(
        conversation_id=f"conv_{int(datetime.now().timestamp())}",
        messages=[
            {
                "sender_type": "customer",
                "content": user_message,
                "timestamp": datetime.now().isoformat()
            },
            {
                "sender_type": "ai",
                "content": ai_response,
                "timestamp": datetime.now().isoformat()
            }
        ],
        csat_score=5,  # If you collect CSAT
        escalated=False,
        topic="general"
    )
    
    return ai_response

Node.js Example

const axios = require('axios');

const API_KEY = process.env.CSAIMONITOR_API_KEY;
const API_URL = 'https://api.csaimonitor.com/api/v1';

async function trackConversation(data) {
  const response = await axios.post(
    `${API_URL}/conversations`,
    {
      conversation_id: data.conversationId,
      platform: 'custom',
      messages: data.messages,
      csat_score: data.csatScore,
      escalated: data.escalated || false,
      ai_handled: true,
      topic: data.topic
    },
    {
      headers: {
        'X-API-Key': API_KEY,
        'Content-Type': 'application/json'
      }
    }
  );
  return response.data;
}

// Express.js example
app.post('/chat', async (req, res) => {
  const { query, customerId } = req.body;
  
  // Your existing AI logic
  const response = await yourAIModel.generateResponse(query);
  
  // Track the conversation
  await trackConversation({
    conversationId: `conv_${Date.now()}`,
    messages: [
      { sender_type: 'customer', content: query },
      { sender_type: 'ai', content: response }
    ],
    csatScore: null,  // Collect separately if available
    escalated: false,
    topic: 'general'
  });
  
  res.json({ response });
});

Using curl

curl -X POST https://api.csaimonitor.com/api/v1/conversations \
  -H "X-API-Key: amo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation_id": "ticket_12345",
    "platform": "zendesk",
    "messages": [
      {"sender_type": "customer", "content": "How do I reset my password?"},
      {"sender_type": "ai", "content": "Go to Settings > Security > Reset Password."}
    ],
    "csat_score": 5,
    "escalated": false,
    "ai_handled": true,
    "topic": "password_reset"
  }'

💡 Tip: See our complete API documentation for all available fields, including cost tracking, sentiment analysis, and more.

Step 4: Connect Zendesk (Optional - 5 minutes)

For automatic conversation tracking from Zendesk, set up a webhook. This allows CSAT scores and escalation data to sync automatically:

Zendesk Webhook Setup

Get your webhook URL from your Customer Support AI Monitor dashboard (Settings → Webhooks)
In Zendesk Admin Center, go to Apps and integrations → Webhooks
Click "Create webhook"
Enter your webhook URL: https://api.csaimonitor.com/api/v1/webhooks/zendesk?org_id=YOUR_ORG_ID
Set authentication to Bearer Token and add your API key
Create triggers for: Ticket Created, Ticket Updated, Ticket Solved
Test by creating a ticket - it should appear in your dashboard within 2-5 minutes

Note: If you don't use Zendesk, you can still track conversations manually using the REST API shown in Step 3. The webhook integration is optional but recommended for automatic CSAT collection.

Step 5: View Your Dashboard (1 minute)

Data typically appears within 2-5 minutes of your first tracked conversation. Here's what you'll see:

Overview Dashboard: Total conversations, CSAT score, escalation rate
Real-time Feed: Live stream of conversations as they happen
Analytics: Trends over time, peak hours, top topics
Alerts: Notifications when metrics change significantly

🎉 Congratulations! You've successfully set up Customer Support AI Monitor. Your AI chatbot is now being monitored in real-time!

What's Next?

Now that you're up and running, here are recommended next steps to maximize value:

Troubleshooting

Data not appearing?

Verify your API key is correctly set (must start with amo_)
Check that your HTTP request returns a 200 status code
Ensure your firewall allows outbound HTTPS to api.csaimonitor.com
Verify the request body matches the API schema (see docs)
Check the response for any error messages

Webhook integration issues?

Verify the webhook URL is correct and includes your organization ID
Check that your API key is set correctly in Zendesk webhook authentication
Ensure Zendesk triggers are configured correctly
Check Zendesk webhook logs for delivery status
See our Zendesk Integration Guide for detailed steps

Need Help?

Our team is here to help you succeed:

Documentation: docs.csaimonitor.com
Email Support: support@csaimonitor.com
Documentation: Browse our complete API documentation
Office Hours: Weekly live Q&A sessions - check your dashboard for schedule