BotLance API

Base URL

All API requests use HTTPS and require authentication using a project-scoped API key.

https://api.botlance.com/v1

Authentication

Generate API keys from Settings → API Keys.

Authorization: Bearer bl_live_xxxxxxxxx
Content-Type: application/json

Social AI API

Use BotLance as an AI backend for platforms that support APIs and webhooks, including ManyChat, SendPulse, Zapier, Make.com, n8n, CRMs, and custom applications.

// Request
{
  "workspace_id": "ws_123",
  "session_id": "sess_456",
  "message": "I want to book an appointment."
}

// Response
{
  "reply": "I'd be happy to help you book an appointment.",
  "actions": [
    {
      "type": "BOOK_APPOINTMENT"
    }
  ]
}

Website Chatbot API

Query your chatbot directly from your own applications without using the embedded widget.

// Request
{
  "chatbot_id": "bot_123",
  "session_id": "sess_456",
  "message": "What services do you offer?"
}

// Response
{
  "reply": "We provide AI chatbots, Social AI automation, and integrations."
}

Knowledge Base API

Programmatically sync knowledge sources and keep your AI agents updated automatically.

{
  "type": "url",
  "url": "https://example.com/pricing"
}

Supported source types

• Website URLs
• Documents
• Raw text
• Additional source types coming soon

Conversations API

Retrieve conversation history and analytics.

GET /v1/conversations
GET /v1/conversations/{conversation_id}

Use cases

• Analytics
• CRM syncing
• Conversation exports
• Internal dashboards

Webhooks

Subscribe to workspace events and automate your workflows. Supported events: lead.captured, action.executed, conversation.started, conversation.handoff, conversation.closed.

{
  "url": "https://your-app.com/botlance",
  "events": [
    "lead.captured",
    "action.executed"
  ]
}

AI Actions API

Execute AI-powered actions programmatically.

// Request
{
  "action": "BOOK_APPOINTMENT",
  "payload": {
    "name": "Noor Hussain"
  }
}

// Response
{
  "status": "success"
}

Rate Limits

Error Format

Include the request_id when contacting support.

{
  "error": {
    "code": "invalid_request",
    "message": "chatbot_id is required",
    "request_id": "req_01HW..."
  }
}

Coming Soon

• WhatsApp API
• Telegram API
• Media Library API
• Workflow API
• Analytics API