HTTP API

curl https://www.botai.ge/api/v1/knowledge \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const res = await fetch("https://www.botai.ge/api/v1/knowledge", {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/knowledge",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    timeout=30,
)
print(res.json())

curl -X POST https://www.botai.ge/api/v1/knowledge \
  -H "Authorization: Bearer $CORPORATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "description": "სილამაზის სალონი ვაკეში, 2011 წლიდან.",
      "services": [
        {"name": "თმის შეჭრა", "price": "40 ₾", "durationMinutes": 45},
        {"name": "მანიკური", "price": "30 ₾", "durationMinutes": 60}
      ],
      "documents": [
        {
          "id": "returns-policy",
          "label": "დაბრუნების წესები",
          "text": "დაბრუნება შესაძლებელია შეძენიდან 14 დღის განმავლობაში, ჩეკით."
        }
      ]
    }'

const res = await fetch("https://www.botai.ge/api/v1/knowledge", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CORPORATE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    description: "სილამაზის სალონი ვაკეში, 2011 წლიდან.",
    services: [
      { name: "თმის შეჭრა", price: "40 ₾", durationMinutes: 45 },
      { name: "მანიკური", price: "30 ₾", durationMinutes: 60 },
    ],
    documents: [
      {
        id: "returns-policy",
        label: "დაბრუნების წესები",
        text: "დაბრუნება შესაძლებელია შეძენიდან 14 დღის განმავლობაში, ჩეკით.",
      },
    ],
  }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.post(
    "https://www.botai.ge/api/v1/knowledge",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    json={
        "description": "სილამაზის სალონი ვაკეში, 2011 წლიდან.",
        "services": [
            {"name": "თმის შეჭრა", "price": "40 ₾", "durationMinutes": 45},
            {"name": "მანიკური", "price": "30 ₾", "durationMinutes": 60},
        ],
        "documents": [
            {
                "id": "returns-policy",
                "label": "დაბრუნების წესები",
                "text": "დაბრუნება შესაძლებელია შეძენიდან 14 დღის განმავლობაში, ჩეკით.",
            },
        ],
    },
    timeout=30,
)
print(res.status_code, res.json())

curl -X PATCH https://www.botai.ge/api/v1/knowledge \
  -H "Authorization: Bearer $CORPORATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "faq": [
        {
          "question": "ბარათით გადახდა შეიძლება?",
          "answer": "დიახ, ბარათითაც და ნაღდითაც."
        }
      ],
      "rules": ["სტუმარს ყოველთვის სახელით მიმართე"]
    }'

const res = await fetch("https://www.botai.ge/api/v1/knowledge", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.CORPORATE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    faq: [
      {
        question: "ბარათით გადახდა შეიძლება?",
        answer: "დიახ, ბარათითაც და ნაღდითაც.",
      },
    ],
    rules: ["სტუმარს ყოველთვის სახელით მიმართე"],
  }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.patch(
    "https://www.botai.ge/api/v1/knowledge",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    json={
        "faq": [
            {
                "question": "ბარათით გადახდა შეიძლება?",
                "answer": "დიახ, ბარათითაც და ნაღდითაც.",
            },
        ],
        "rules": ["სტუმარს ყოველთვის სახელით მიმართე"],
    },
    timeout=30,
)
print(res.status_code, res.json())

curl "https://www.botai.ge/api/v1/conversations?limit=50&offset=0" \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const params = new URLSearchParams({ limit: 50, offset: 0 });
const res = await fetch(`https://www.botai.ge/api/v1/conversations?${params}`, {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/conversations",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    params={"limit": 50, "offset": 0},
    timeout=30,
)
print(res.json())

curl "https://www.botai.ge/api/v1/conversations/website/w_8fa2c41e?limit=100" \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const params = new URLSearchParams({ limit: 100 });
const res = await fetch(`https://www.botai.ge/api/v1/conversations/website/w_8fa2c41e?${params}`, {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/conversations/website/w_8fa2c41e",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    params={"limit": 100},
    timeout=30,
)
print(res.json())

curl "https://www.botai.ge/api/v1/contacts?limit=50&offset=0" \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const params = new URLSearchParams({ limit: 50, offset: 0 });
const res = await fetch(`https://www.botai.ge/api/v1/contacts?${params}`, {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/contacts",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    params={"limit": 50, "offset": 0},
    timeout=30,
)
print(res.json())

curl "https://www.botai.ge/api/v1/handoffs?limit=100&open=true" \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const params = new URLSearchParams({ limit: 100, open: "true" });
const res = await fetch(`https://www.botai.ge/api/v1/handoffs?${params}`, {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/handoffs",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    params={"limit": 100, "open": "true"},
    timeout=30,
)
print(res.json())

curl "https://www.botai.ge/api/v1/bookings?from=2026-09-01&to=2026-09-07" \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const params = new URLSearchParams({ from: "2026-09-01", to: "2026-09-07" });
const res = await fetch(`https://www.botai.ge/api/v1/bookings?${params}`, {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/bookings",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    params={"from": "2026-09-01", "to": "2026-09-07"},
    timeout=30,
)
print(res.json())

curl "https://www.botai.ge/api/v1/bookings/busy?from=2026-09-01&to=2026-09-07" \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const params = new URLSearchParams({ from: "2026-09-01", to: "2026-09-07" });
const res = await fetch(`https://www.botai.ge/api/v1/bookings/busy?${params}`, {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/bookings/busy",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    params={"from": "2026-09-01", "to": "2026-09-07"},
    timeout=30,
)
print(res.json())

curl -X POST https://www.botai.ge/api/v1/bookings \
  -H "Authorization: Bearer $CORPORATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "userId": "crm-4471",
      "service": "თმის შეჭრა",
      "date": "2026-09-01",
      "time": "12:00",
      "customerName": "ნინო",
      "customerPhone": "5xx xx xx xx"
    }'

const res = await fetch("https://www.botai.ge/api/v1/bookings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CORPORATE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    userId: "crm-4471",
    service: "თმის შეჭრა",
    date: "2026-09-01",
    time: "12:00",
    customerName: "ნინო",
    customerPhone: "5xx xx xx xx",
  }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.post(
    "https://www.botai.ge/api/v1/bookings",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    json={
        "userId": "crm-4471",
        "service": "თმის შეჭრა",
        "date": "2026-09-01",
        "time": "12:00",
        "customerName": "ნინო",
        "customerPhone": "5xx xx xx xx",
    },
    timeout=30,
)
print(res.status_code, res.json())

curl -X POST https://www.botai.ge/api/v1/bookings/91/cancel \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const res = await fetch("https://www.botai.ge/api/v1/bookings/91/cancel", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(res.status, await res.json());

import os
import requests

res = requests.post(
    "https://www.botai.ge/api/v1/bookings/91/cancel",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    timeout=30,
)
print(res.status_code, res.json())

curl https://www.botai.ge/api/v1/assistants \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const res = await fetch("https://www.botai.ge/api/v1/assistants", {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/assistants",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    timeout=30,
)
print(res.json())

curl -X POST https://www.botai.ge/api/v1/assistants \
  -H "Authorization: Bearer $CORPORATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"clientId": "demo-salon-2", "name": "დემო სალონი 2"}'

const res = await fetch("https://www.botai.ge/api/v1/assistants", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CORPORATE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ clientId: "demo-salon-2", name: "დემო სალონი 2" }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.post(
    "https://www.botai.ge/api/v1/assistants",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    json={"clientId": "demo-salon-2", "name": "დემო სალონი 2"},
    timeout=30,
)
print(res.status_code, res.json())

curl -X PATCH https://www.botai.ge/api/v1/assistants/demo-salon-2 \
  -H "Authorization: Bearer $CORPORATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active": true}'

const res = await fetch("https://www.botai.ge/api/v1/assistants/demo-salon-2", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.CORPORATE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ active: true }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.patch(
    "https://www.botai.ge/api/v1/assistants/demo-salon-2",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    json={"active": True},
    timeout=30,
)
print(res.status_code, res.json())

curl "https://www.botai.ge/api/v1/usage?from=2026-08-01&to=2026-08-22" \
  -H "Authorization: Bearer $CORPORATE_API_KEY"

const params = new URLSearchParams({ from: "2026-08-01", to: "2026-08-22" });
const res = await fetch(`https://www.botai.ge/api/v1/usage?${params}`, {
  headers: { Authorization: `Bearer ${process.env.CORPORATE_API_KEY}` },
});
console.log(await res.json());

import os
import requests

res = requests.get(
    "https://www.botai.ge/api/v1/usage",
    headers={"Authorization": f"Bearer {os.environ['CORPORATE_API_KEY']}"},
    params={"from": "2026-08-01", "to": "2026-08-22"},
    timeout=30,
)
print(res.json())

curl -X POST https://www.botai.ge/api/v1/products \
  -H "Authorization: Bearer $PRODUCTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "products": [
        {
          "id": "SKU-1041",
          "name": "ტყავის ჩექმა",
          "category": "ფეხსაცმელი",
          "variants": [
            {
              "id": "1041-42",
              "sku": "1041-42",
              "attributes": {"ზომა": "42", "ფერი": "შავი"},
              "priceTetri": 18999,
              "stock": 3
            },
            {
              "id": "1041-43",
              "sku": "1041-43",
              "attributes": {"ზომა": "43", "ფერი": "შავი"},
              "priceTetri": 18999,
              "stock": 0
            }
          ]
        },
        {
          "id": "SKU-2007",
          "name": "ტყავის ქამარი",
          "category": "აქსესუარი",
          "priceTetri": 4500,
          "stock": null
        }
      ]
    }'

const res = await fetch("https://www.botai.ge/api/v1/products", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PRODUCTS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    products: [
      {
        id: "SKU-1041",
        name: "ტყავის ჩექმა",
        category: "ფეხსაცმელი",
        variants: [
          {
            id: "1041-42",
            sku: "1041-42",
            attributes: { "ზომა": "42", "ფერი": "შავი" },
            priceTetri: 18999,
            stock: 3,
          },
          {
            id: "1041-43",
            sku: "1041-43",
            attributes: { "ზომა": "43", "ფერი": "შავი" },
            priceTetri: 18999,
            stock: 0,
          },
        ],
      },
      {
        id: "SKU-2007",
        name: "ტყავის ქამარი",
        category: "აქსესუარი",
        priceTetri: 4500,
        stock: null,
      },
    ],
  }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.post(
    "https://www.botai.ge/api/v1/products",
    headers={"Authorization": f"Bearer {os.environ['PRODUCTS_API_KEY']}"},
    json={
        "products": [
            {
                "id": "SKU-1041",
                "name": "ტყავის ჩექმა",
                "category": "ფეხსაცმელი",
                "variants": [
                    {
                        "id": "1041-42",
                        "sku": "1041-42",
                        "attributes": {"ზომა": "42", "ფერი": "შავი"},
                        "priceTetri": 18999,
                        "stock": 3,
                    },
                    {
                        "id": "1041-43",
                        "sku": "1041-43",
                        "attributes": {"ზომა": "43", "ფერი": "შავი"},
                        "priceTetri": 18999,
                        "stock": 0,
                    },
                ],
            },
            {
                "id": "SKU-2007",
                "name": "ტყავის ქამარი",
                "category": "აქსესუარი",
                "priceTetri": 4500,
                "stock": None,
            },
        ],
    },
    timeout=30,
)
print(res.status_code, res.json())

curl -X PATCH https://www.botai.ge/api/v1/products \
  -H "Authorization: Bearer $PRODUCTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "products": [
        {
          "id": "SKU-1041",
          "name": "ტყავის ჩექმა",
          "variants": [{"id": "1041-42", "priceTetri": 16999, "stock": 2}]
        }
      ]
    }'

const res = await fetch("https://www.botai.ge/api/v1/products", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.PRODUCTS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    products: [
      {
        id: "SKU-1041",
        name: "ტყავის ჩექმა",
        variants: [{ id: "1041-42", priceTetri: 16999, stock: 2 }],
      },
    ],
  }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.patch(
    "https://www.botai.ge/api/v1/products",
    headers={"Authorization": f"Bearer {os.environ['PRODUCTS_API_KEY']}"},
    json={
        "products": [
            {
                "id": "SKU-1041",
                "name": "ტყავის ჩექმა",
                "variants": [{"id": "1041-42", "priceTetri": 16999, "stock": 2}],
            },
        ],
    },
    timeout=30,
)
print(res.status_code, res.json())

curl -X POST https://www.botai.ge/api/v1/payments \
  -H "Authorization: Bearer $PRODUCTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "variantId": "1041-42",
      "quantity": 1,
      "method": "online",
      "orderRef": "ORD-10482",
      "customer": {"name": "ნინო", "phone": "+995555100200"}
    }'

const res = await fetch("https://www.botai.ge/api/v1/payments", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PRODUCTS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    variantId: "1041-42",
    quantity: 1,
    method: "online",
    orderRef: "ORD-10482",
    customer: { name: "ნინო", phone: "+995555100200" },
  }),
});
console.log(res.status, await res.json());

import os
import requests

res = requests.post(
    "https://www.botai.ge/api/v1/payments",
    headers={"Authorization": f"Bearer {os.environ['PRODUCTS_API_KEY']}"},
    json={
        "variantId": "1041-42",
        "quantity": 1,
        "method": "online",
        "orderRef": "ORD-10482",
        "customer": {"name": "ნინო", "phone": "+995555100200"},
    },
    timeout=30,
)
print(res.status_code, res.json())