AI API reference

curl -X GET "https://services.leadconnectorhq.com/conversations/"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Version: 2021-07-28"   -H "Content-Type: application/json"

const axios = require("axios");

const client = axios.create({
  baseURL: "https://services.leadconnectorhq.com",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Version": "2021-07-28",
    "Content-Type": "application/json"
  }
});

import requests

BASE_URL = "https://services.leadconnectorhq.com"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Version": "2021-07-28",
    "Content-Type": "application/json"
}

// Activate a bot
const response = await client.patch(
  "/conversations/bots/" + botId + "/status",
  { locationId: "loc_abc123", status: "active" }
);
console.log("Bot status: " + response.data.status);

# Activate a bot
response = requests.patch(
    f"{BASE_URL}/conversations/bots/{bot_id}/status",
    headers=HEADERS,
    json={"locationId": "loc_abc123", "status": "active"}
)
print(f"Bot status: {response.json()['status']}")

// Add a knowledge base entry
const response = await client.post(
  "/conversations/bots/" + botId + "/knowledge",
  {
    locationId: "loc_abc123",
    type: "text",
    title: "Pricing FAQ",
    content: "Our plans start at ninety-nine dollars per month..."
  }
);
console.log("Added knowledge entry: " + response.data.id);

# Add a knowledge base entry
response = requests.post(
    f"{BASE_URL}/conversations/bots/{bot_id}/knowledge",
    headers=HEADERS,
    json={
        "locationId": "loc_abc123",
        "type": "text",
        "title": "Pricing FAQ",
        "content": "Our plans start at ninety-nine dollars per month..."
    }
)
print(f"Added knowledge entry: {response.json()['id']}")

// Handle rate limiting with retry logic
async function apiRequestWithRetry(config, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await client.request(config);
    } catch (error) {
      if (error.response && error.response.status === 429) {
        const retryAfter = error.response.headers["retry-after"] || 5;
        console.log("Rate limited. Retrying in " + retryAfter + "s...");
        await new Promise(r => setTimeout(r, retryAfter * 1000));
      } else {
        throw error;
      }
    }
  }
  throw new Error("Max retries exceeded");
}

# Handle rate limiting with retry logic
import time

def api_request_with_retry(method, url, max_retries=3, **kwargs):
    for attempt in range(max_retries):
        response = requests.request(method, url, headers=HEADERS, **kwargs)
        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 5))
            print(f"Rate limited. Retrying in {retry_after}s...")
            time.sleep(retry_after)
        elif response.ok:
            return response
        else:
            response.raise_for_status()
    raise Exception("Max retries exceeded")