Хэрэгслийн жишээ

Хоёр түгээмэл хэрэгслийг алхам алхмаар тохируулна. Жишээн дэх api.demo.mn хаягийг өөрийн API-аар солино.

Хэрэгсэл яаж ажилладаг вэ

Agent ярианы явцад хэрэгслийн тайлбарыг уншаад хэзээ дуудахаа шийднэ. Харилцагчаас хэрэгтэй утгаа асууж авна, танай API руу хүсэлт илгээнэ, хариуг нь ойлгомжтой хэлээр буцааж хэлнэ.

Жишээ 1: Захиалгын төлөв шалгах

Мэдээлэл унших хэрэгсэл. GET хүсэлт тул харилцагчаас зөвшөөрөл асуухгүй шууд дуудна.

Нэр, тайлбар

Хэрэгсэл хуудасны Шинэ хэрэгсэл дараад HTTP Request-ийг сонгоно.

Талбар	Утга
Нэр	Захиалгын төлөв шалгах
Тайлбар	Захиалгын дугаараар төлөв, хүргэлтийн огноог буцаана. Харилцагч захиалга хаана яваа, хэзээ ирэхийг асуувал дууд.

Холболт

Method: GET
URL:    https://api.demo.mn/orders/{orderId}

{orderId}-г agent харилцагчийн хэлсэн дугаараар солино.

Parameters

Талбар	Утга
Нэр	`orderId`
Төрөл	`string`
Тайлбар	Захиалгын дугаар
Заавал	Асаалттай
Харилцагч хэлсэн байх	Асаалттай

Харилцагч хэлсэн байх асаалттай тул agent дугаар зохиохгүй, заавал асууна.

Authorization ба хариу

Bearer token сонгоод API түлхүүрээ оруулна. Хариу хэсэгт agent-д хэрэгтэй талбаруудыг сонгоно: status, eta.Танай API ингэж хариулна гэж үзье:

{
  "orderId": "4215",
  "status": "shipped",
  "eta": "2026-10-29",
  "items": [{ "name": "Galaxy A55", "qty": 1 }],
  "warehouse": { "code": "UB-03" }
}

Agent зөвхөн status, eta-г харна. Хариу богино байх тусам agent хурдан, зөв хариулна.

Турших ба холбох

Request табд orderId оруулаад Илгээх дарна. Ажиллаж байвал Хадгалах, дараа нь agent-ын Мэдлэг ба хэрэгсэл хэсгээс сонгоно.

Жишээ 2: Цаг захиалах

Өгөгдөл өөрчлөх хэрэгсэл. POST дээр Дуудахаас өмнө харилцагчаас зөвшөөрөл авах анхнаасаа асаалттай: agent юу хийхээ хэлж, харилцагч «тийм» гэсний дараа л дуудна.

Нэр, тайлбар

Талбар	Утга
Нэр	Цаг захиалах
Тайлбар	Сонгосон салбарт үйлчлүүлэх цаг товлоно. Харилцагч салбар, цагаа хэлж, зөвшөөрсний дараа дууд.

Холболт

Method: POST
URL:    https://api.demo.mn/bookings

Parameters

Нэр	Төрөл	Тайлбар
`branch`	`string`	Салбарын нэр
`time`	`datetime`	Үйлчлүүлэх цаг

Хоёуланд нь Заавал, Харилцагч хэлсэн байх-ыг асаана.URL-д ороогүй параметрүүд body-д JSON-оор явна:

{ "branch": "Хан-Уул", "time": "2026-11-01T11:00:00+08:00" }

Ярианд ингэж харагдана

Харилцагч: Бямба гарагт 11 цагт Хан-Уул салбарт очмоор байна. Agent: Бямба гараг 11:00-д Хан-Уул салбарт цаг захиалах уу? Харилцагч: Тийм. Agent: Захиаллаа. Бямба гарагт 11:00-д хүлээж байна.

Agent-ын зааварт нэмэх

Хэрэгслийг хэзээ ашиглахыг заавартаа бас бичвэл agent илүү найдвартай дуудна.

[Хэрэгсэл]
- Харилцагч захиалгаа асуувал «Захиалгын төлөв шалгах»-аар шалга.
- Цаг товлохдоо салбар, цагийг давтан хэлж баталгаажуулаад «Цаг захиалах»-ыг дууд.
- Хэрэгсэл алдаа өгвөл уучлал гуйж, ажилтан руу шилжүүл.

Танай серверийн жишээ

Raptora-аас ирэх хүсэлтийг хүлээж авах хамгийн энгийн сервер. Token-оо шалгаад JSON буцаана.

import express from "express";

const app = express();
app.use(express.json());

app.get("/orders/:orderId", (req, res) => {
  if (req.headers.authorization !== `Bearer ${process.env.RAPTORA_TOKEN}`) {
    return res.status(401).json({ error: "unauthorized" });
  }
  res.json({ orderId: req.params.orderId, status: "shipped", eta: "2026-10-29" });
});

app.post("/bookings", (req, res) => {
  const { branch, time } = req.body;
  res.json({ ok: true, branch, time });
});

app.listen(3000);

import os
from fastapi import FastAPI, Header, HTTPException

app = FastAPI()

@app.get("/orders/{order_id}")
def order_status(order_id: str, authorization: str = Header("")):
    if authorization != f"Bearer {os.environ['RAPTORA_TOKEN']}":
        raise HTTPException(status_code=401)
    return {"orderId": order_id, "status": "shipped", "eta": "2026-10-29"}

@app.post("/bookings")
def book(body: dict):
    return {"ok": True, **body}

Хүсэлт үнэхээр Raptora-аас ирснийг шалгах бол хүсэлтийн гарын үсэг асаана.

Эхлэх

Агент

Суваг

Дуудлага

Интеграц

Хяналт

Тохиргоо

Хэрэгслийн жишээ

Хэрэгсэл яаж ажилладаг вэ

Жишээ 1: Захиалгын төлөв шалгах

Жишээ 2: Цаг захиалах

Agent-ын зааварт нэмэх

Танай серверийн жишээ