API Reference

Complete reference for JomBot AI REST APIs with examples, parameters, and response formats for all services.

99.9%

Uptime

<50ms

Avg Response

256-bit

SSL Encryption

26+

API Endpoints

Base URL

https://api.jombot.ai/v1

AI Core

Business

Education

Communication

Cloud

Content

System

POST/chat/message

Chat Bot API

Send messages to AI chatbots and receive intelligent, context-aware responses. Supports conversation history and custom personalities.

Parameters

Name	Type	Required	Description
`message`	string	Required	The user message to send to the chatbot
`bot_id`	string	Required	Unique identifier of the chatbot
`conversation_id`	string	Optional	ID to maintain conversation context
`user_id`	string	Optional	User identifier for personalization
`context`	object	Optional	Additional context for the conversation

Request Example

{
  "message": "Hello, I need help with my order",
  "bot_id": "bot_customer_support_001",
  "conversation_id": "conv_12345",
  "user_id": "user_67890",
  "context": {
    "customer_tier": "premium",
    "last_order": "ORD-2025-001"
  }
}

Response Example

{
  "response": "Hello! I'd be happy to help you with your order. Could you please provide your order number?",
  "conversation_id": "conv_12345",
  "bot_id": "bot_customer_support_001",
  "timestamp": "2025-01-15T10:30:00Z",
  "confidence": 0.95,
  "suggested_actions": [
    {
      "type": "quick_reply",
      "text": "Check order status",
      "payload": "check_order"
    }
  ]
}

cURL Example

curl -X POST https://api.jombot.ai/v1/chat/message \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello, I need help with my order",
    "bot_id": "bot_customer_support_001",
    "conversation_id": "conv_12345"
  }'

Authentication & Security

All API requests require authentication using your API key.

API Key Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

Starter Plan:1,000 requests/hour

Professional Plan:10,000 requests/hour

Enterprise Plan:Custom limits

AI Core

3 endpoints

Business

3 endpoints

Education

2 endpoints

Communication

8 endpoints

Cloud

4 endpoints

Content

3 endpoints

System

3 endpoints

Webhook Events

Real-time notifications for important events in your applications

message.received

New message received by chatbot

bot.response

Bot generated a response

transaction.completed

POS transaction completed

user.created

New user account created

payment.succeeded

Payment processed successfully

subscription.updated

Subscription status changed

voice.processed

Voice input processed

content.generated

AI content generation completed

integration.connected

Third-party integration established

SDKs & Libraries

Official SDKs for popular programming languages

JavaScript/Node.js

@jombot/ai-sdk

Stable

Python

jombot-ai

Stable

PHP

jombot/php-sdk

Stable

Java

com.jombot.ai

Stable

C#/.NET

JomBot.AI

Stable

Go

github.com/jombot/go-sdk

Beta

Ruby

jombot-ai

Beta

Rust

jombot_ai

Coming Soon