← All integrations
⚡

REST API

Available

Full programmatic access to your Botkontor AI agent. Send messages, receive webhooks, sync conversations with your CRM, or build entirely custom chat frontends. The API gives you complete control.

Start using REST API →

How it works

  1. 1

    Generate an API key

    Create an API key in your Botkontor dashboard with the permissions you need.

  2. 2

    Send your first message

    Use our REST API to send a message to your agent and receive an AI-powered response.

  3. 3

    Set up webhooks

    Configure webhook URLs to receive real-time notifications when events occur.

  4. 4

    Build your integration

    Use the API to connect Botkontor with any system — CRM, helpdesk, mobile app, or custom frontend.

Features

  • ✓Send and receive messages programmatically
  • ✓Webhook notifications for new messages and events
  • ✓Retrieve conversation history and analytics
  • ✓Create and manage agents via API
  • ✓Sync conversations with your CRM or helpdesk
  • ✓Build custom chat UIs for web, mobile, or kiosk
  • ✓Authentication via API keys with scoped permissions
  • ✓Comprehensive API documentation with examples
  • ✓Rate limiting with generous free-tier quotas

Example request

bash
# Send a message to your agent
curl -X POST https://api.botkontor.com/v1/conversations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": "YOUR_BOT_ID",
    "message": "What are your opening hours?",
    "visitor": {
      "name": "Jane Doe",
      "email": "jane@example.com"
    }
  }'

Ready to get started?

Set up REST API in under 5 minutes. Free plan included.

Start free →
REST API Integration — Botkontor