Keeyo Offers — туроператорға арналған ЖИ жинайтын ұсыныстар

02 НЕ ІСТЕЙДІ

Брифтен келісілген бағдарламаға дейін — қайта терусіз.

Бір ұсыныс бүкіл жолды өзі жүріп өтеді: бір рет жазылады, өз мөлшерлемелеріңіз бойынша есептеледі, саяхатшы телефоннан оқитын құжат ретінде жарияланады және клиент бірдеңе істеген сәтте жүйелеріңізге жауап қайтарады.

01 · Бриф

Қысқа бриф

Қала, күндер, топ және саяхатшының шын мәнінде сұрағаны. Немесе брифсіз — бағдарламаны өзіңіз жазасыз.

02 · Бағдарлама

Күнбе-күн бағдарлама

Атауы, уақыты, түнейтін жері және барған орындары бар күндер — жобасы сіз үшін жиналады, соңғы жолына дейін өңделеді.

03 · Құжат

Бет және PDF

Бір сілтеме, бір басып шығаратын файл. Логотипіңіз, байланыстарыңыз, екпін түсіңіз — екеуінде де.

04 · Таңдау

Клиент таңдайды

Үшке дейін пакет, әрқайсысының ішінде қонақүйлер ауысады, ал баға айырмасы бір түнге емес, бүкіл сапарға көрсетіледі.

05 · Дабыл

Сіз бұл туралы білесіз

Ашты, салыстырды, таңдады, қабылдады — әр қадам қол қойылған вебхукпен келеді, ал өтініммен бірге топ құрамы мен байланыс келеді.

03 ТІРІ ҰСЫНЫС

Клиенттің қолына түсетіні — осы.

Демо-оператордың нақты ұсынысы — саяхатшы ашатын дәл сол бет: пакеттерді салыстыруға, қонақүйді ауыстыруға болады, ал төменде өтінім нысаны тұр. Оның артында сол құжаттың PDF-і.

Ұсыныс мысалын ашу

ДЕМО-ОПЕРАТОР · БРЕНДИНГ, БАҒА ЖӘНЕ СУРЕТТЕР — ОНЫҚІ

offers.treeple.kz/o/UvbD5nLCR9DcZsjwbn24N

Ұсыныс беті: бағдарлама күндері, пакет карточкалары және қонақүй таңдау

04 ҚАЛАЙ БАСТАУ КЕРЕК

Төрт қадам — және алғашқы ұсыныс жіберілді.

1-ҚАДАМ

Тіркелгі ашыңыз

Компания атауы, пошта, құпиясөз. Менеджердің қоңырауынсыз және хаттағы кілтсіз.

2-ҚАДАМ

Оны өзіңіздікі етіңіз

Логотип жүктеңіз, байланыстар мен екпін түсін қойыңыз, мөлшерлемелер мен қонақүйлерді енгізіңіз, суреттеріңізді қосыңыз.

3-ҚАДАМ

Ұсыныс жинаңыз

Шеберді қолмен толтырыңыз немесе брифтен бастаңыз. Баға өз баға кітабыңыздан алынады — демек, сомалар да сіздікі.

4-ҚАДАМ

Сілтемені жіберіңіз

Клиентке бір мекенжай, оның артында PDF, ал басқару панелі бұдан әрі не болғанын айтады.

Тіркелгі жасау

05 ӘЗІРЛЕУШІЛЕРГЕ

Басқару панелі — бір есік. API — екіншісі.

Басқару панелі істейтіннің бәрін кілт те істейді: екеуінің артында бір ғана серверлік код. Баптауларда кілт шығарыңыз, ұсыныс жіберіңіз, жауабына сілтеме алыңыз.

АвторизацияӨзіңіз шығарып, өзіңіз қайтарып алатын Bearer-кілттер. Бір рет көрсетіледі, хэш түрінде сақталады.

АсинхрондыГенерация минуттап жүреді, сондықтан жауап ретінде 202 және сұрап отыруға болатын тапсырма келеді.

ВебхуктарУақыт белгісі мен дене бойынша HMAC-SHA256, қайталап жіберумен және оқуға болатын жеткізу журналымен.

ҚұжаттарӘр ұсыныс — бір сілтеме бойынша бет, markdown түріндегі көшірме және PDF.

POST /api/v1/offers

curl -X POST https://offers.treeple.kz/api/v1/offers \
  -H "Authorization: Bearer $KEEYO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "contactName": "Anna Weber",
    "city": "Almaty",
    "startDate": "2026-11-05",
    "days": 4, "pax": 2,
    "brief": { "notes": "mountains, lakes, no long drives" }
  }'

# => 201
{
  "ok": true,
  "shareUrl": "https://offers.treeple.kz/o/iDQrqcgU5K…",
  "pdfUrl":   "https://offers.treeple.kz/o/iDQrqcgU5K…/pdf"
}

06 БАСТАУ

Келесі ұсынысыңыз бүгін кете алады.

Тіркелгі ашыңыз, мөлшерлемелеріңізді енгізіңіз және екінші рет ашылмайтын құжаттың орнына сілтеме жіберіңіз.

Бастау

Клиент ашатын, салыстыратын және қабылдайтын тур ұсыныстары.