Энэ бол Flow Studio-гийн сүүлийн хичээл. Flow үүсгэх, node тохируулах, тестлэхийг та өмнөх хичээлүүдээс мэдэж байгаа гэж үзнэ (Flow Studio: үндэс, Node-ууд, AI node-ууд, Тест ба алдаа засах).

Энд таван зүйл үзнэ: - AI апп: flow-ууд ба AI тохиргоогоо нэг хувилбартай багц болгох. - Marketplace: бусдын бэлтгэсэн аппыг суулгах, өөрийнхөө аппыг илгээх. - Гадны webhook: өөр систем мэдээлэл илгээхэд flow эхлүүлэх. - API дуудлага: өөрийн серверээс flow ажиллуулж хариуг авах. - JSON экспорт ба импорт: нэг flow-ийг файл болгож хадгалах, зөөх.

API хэсэг нь хөгжүүлэгчтэй ажилладаг админд зориулагдсан. Энгийн ажилтан эхний гурвыг мэдэхэд хангалттай.

Таван зам өөр өөр зорилготой:

• AI апп нь хамгийн том багц: хэд хэдэн flow, AI ажилтны зан төлөвийн тохиргоо, хүсвэл мэдлэгийн сан. Хувилбар бүр өөрчлөгдөхгүй тул "v2 сайн ажиллаж байсан" гэж буцаж суулгаж болно. Pro, VIP багцад.
• Marketplace нь бусдын нийтэлсэн AI апп-ууд. Үзэх нь бүх багцад, суулгах нь Pro, VIP.
• Гадны webhook нь flow-ийн эхлүүлэх нөхцөл: "Гадны webhook ирэх үед".
• API дуудлага нь мөн эхлүүлэх нөхцөл, Хөгжүүлэгчийн API-тай багцад.
• JSON экспорт/импорт нь нэг flow-ийн хуулбар. Бүх багцад.

Дүрэм: гаднаас ирж буй апп, импорт бүр ноорог болж орно. Таны амьд бот хэзээ ч өөрөө өөрчлөгдөхгүй.

AI апп нь таны AI ажилтны хэрхэн ярьдаг, ямар дүрэм баримталдаг, ямар flow ажиллуулдаг гэдгийг авч явна. Хэн бэ гэдгийг (бизнесийн нэр, утас, хаяг, данс, хүргэлтийн үнэ, төлбөрийн горим) хэзээ ч авч явахгүй: суулгасан workspace өөрийнхөөрөө үлдэнэ.

Орох зүйлс: - Flow-ууд: нэг апп-д 20 хүртэл. - AI тохиргоо: системийн заавар, мэндчилгээ, хариулахгүй үеийн мессеж, өнгө аяс, хэл, дүрэм, операторт шилжүүлэх түлхүүр үг, хориотой сэдэв, санал болгох хэллэг гэх мэт. - Workspace-ийн зан төлөв: бизнесийн чиглэл, мэдлэгийн сангийн хүрээнд хариулах эсэх зэрэг. - Мэдлэгийн сан: "Мэдлэгийн санг хамт багцлах" сонговол гараар бичсэн түгээмэл асуулт, бодлого, ерөнхий мэдээлэл орно. Энэ нь зөвхөн таны өөрийн workspace-ууд руу явна: Marketplace, файлаар хэзээ ч тархахгүй.

Webhook дуудах node-ийн header-т бичсэн нууц утга (API түлхүүр гэх мэт) багцаас хасагдана. Суулгасны дараа дахин оруулна.

1. Хажуугийн цэс, Автоматжуулалт, AI апп. Баруун дээд талд Шинэ AI апп.
2. Нэр (жишээ нь "Цаг захиалгын туслах"), Тайлбар (заавал биш), Урсгалууд жагсаалтаас flow-уудаа чагтална (20 хүртэл). Мэдлэгийн санг хамт багцлах сонголт. Үүсгэх дарахад "... v1 үүслээ" гэж гарна.
3. Flow эсвэл AI тохиргоогоо сайжруулсны дараа аппын карт дээрх Хувилбарууд товч, Шинэ хувилбар нийтлэх хэсэгт v2 нийтлэх. Энэ мөчийн flow ба тохиргоо хувилбар болж хадгалагдана.

Хувилбар бүр өөрчлөгдөхгүй хуулбар. v2 нийтлэхэд v1 устахгүй. Тиймээс шинэ хувилбар муу болвол хуучин хувилбарыг дахин суулгаж болно.

AI апп нь Pro, VIP багцад. Бусад багцад "AI апп нь Pro, VIP багцад нээлттэй" гэсэн тайлбар ба "Багц ахиулах" товч гарна. Апп үүсгэхэд урсгал удирдах эрх хэрэгтэй.

Хувилбаруудын жагсаалтад хувилбар бүрийн мөрөнд хоёр товч байна:

• Өөр workspace руу: таны эзэмшдэг, урсгал удирдах эрхтэй workspace-уудын жагсаалт гарна. Сонгоод Суулгах. "Мэдлэгийн санг хамт суулгах" сонголт энд бас бий.
• Татах: багцыг .json файл болгож татна. Өөр хүн эсвэл өөр бүртгэл дээр AI апп хуудасны гурван цэгтэй цэс, Импорт: файлаа сонгох эсвэл агуулгыг нь буулгана. Файлаар орж ирсэн апп мэдлэгийн сан хэзээ ч авчрахгүй.

Суулгасны дараах цонх: - "N урсгал ноорог болж орлоо", урсгал бүрд Нээх. - "AI тохиргоо ноорог руу орлоо: туршаад нийтлээрэй" ба AI тохиргооны ноорог руу линк. - Дахин сонгох шаардлагатай: өөр workspace-ийн бичлэг рүү заасан талбар цэвэрлэгдсэн (жишээ нь оноох ажилтан). Нээж дахин сонгоно. - Нууц утга дахин оруулах: header-ийн хасагдсан утгууд. Оруулахгүй бол тэр алхам юу ч дуудахгүй. - Багцад ороогүй node байвал: "Эдгээр node ажиллахын тулд багцаа ахиулна уу".

Энэ бол AI апп ба Marketplace-ийн хамгийн чухал дүрэм.

• Суулгасан flow бүр ноорог төлөвтэй орно. Тест хийгээд (Тест ба алдаа засах хичээл) Publish дарж, Идэвхжүүлнэ.
• AI тохиргоо нь AI ажилтны тохиргооны ноорог руу орно. AI ажилтан хэсэгт туршаад нийтэлнэ (AI ажилтан хичээл).

Анхаар: тухайн workspace-д нийтлээгүй AI тохиргооны ноорог аль хэдийн байвал суулгахын өмнө "Энэ workspace-д нийтлээгүй AI тохиргооны ноорог байна" гэж сануулна. Суулгавал аппын тохиргоо таны ноорог дээр нэгтгэгдэж, ижил талбарын таны засвар дарагдана. Тиймээс эхлээд өөрийн ноорогоо нийтэлж эсвэл хаяад дараа нь суулгаарай.

Нэг суулгалтыг давхар дарвал хоёр дахин суухгүй: "Энэ суулгалт өмнө нь хийгдсэн" гэж анхны үр дүнг харуулна.

1. Хажуугийн цэс, Автоматжуулалт, Marketplace.
2. Түвшнээр шүүх: Энгийн (бүх багцад ажиллана), AI (AI node-той, Lite ба түүнээс дээш багцад нийтлэгдэнэ), Төлбөртэй (цагийн хуваарьт). Чиглэлээр шүүх: Борлуулалт, Цаг захиалга, Ресторан, кафе, Эмнэлэг, шүд гэх мэт.
3. Карт бүр суулгалтын тоо, урсгалын тоотой. Дэлгэрэнгүй дарахад: урсгал бүрийн node ба холбоосын тоо, AI тохиргооны талбаруудын нэр (утга нь харагдахгүй), шаардах модуль, чиглэл.
4. Суулгах, workspace сонгоно. "Юу үүсэх вэ" жагсаалт: ноорог урсгалууд, AI тохиргоо ноорог руу хэдэн талбар.

Marketplace-аар мэдлэгийн сан, бараа хэзээ ч дамжихгүй. Жагсаалтыг үзэх нь бүх багцад нээлттэй. Суулгах нь Pro, VIP багцад ("Pro/VIP шаардана" гэж тэмдэглэгдэнэ).

Суулгасны дараа: flow бүрийн мессежийг өөрийн бизнест тохируулж засаад, тестлээд Publish.

Өөрийн аппаа бусад мерчантад санал болгох бол:

1. AI апп хуудас, аппын Хувилбарууд, доод хэсэгт Marketplace-д илгээх.
2. Хувилбар сонгоно. "Бусдад юу очих вэ" хэсэгт урсгалууд (node-ийн тоотой) ба AI тохиргооны талбарын нэрс харагдана.
3. Гарчиг, Товч тайлбар, Чиглэл (олныг сонгож болно). Илгээх.

Админ хянаж зөвшөөрсний дараа бүх мерчантад харагдана. Төлөв: Хянагдаж байна, Нийтлэгдсэн, Татгалзсан, Жагсаалтаас хасагдсан. Админы тайлбар бол хамт гарна.

Дүрэм: - Тайлбар, flow, AI тохиргоонд утас, имэйл, дансны дугаар, өөрийн сайт/сошиал линк, нууц түлхүүр бичихгүй. Илэрвэл аль хэсэгт байгааг заана. Засах: хасах эсвэл хувьсагчаар (жишээ нь {{name}}) солиод шинэ хувилбар нийтэлж түүнийгээ илгээнэ. - Мэдлэгийн сантай хувилбарыг илгээхгүй. Мэдлэгийн сангүй шинэ хувилбар нийтэлнэ. - Нэг хувилбарыг нэг л удаа илгээнэ. Өөрчлөлт хийсэн бол шинэ хувилбар.

Энэ нөхцөл нь таны сайт, өөр программ, Zapier, n8n гэх мэт систем мэдээлэл илгээхэд flow ажиллуулна.

1. Шинэ flow үүсгэхдээ эхлүүлэх нөхцөлд Гадны webhook ирэх үед сонгоно. Нөхцөлийг дараа нь солих боломжгүй.
2. Canvas дээр Эхлэл node-ийг сонгоход баруун самбарт Webhook URL гарна. Хуулах дарна.
3. Нөгөө систем тэр URL руу POST хүсэлт, JSON биетэй илгээнэ. Биеийн талбар бүр хувьсагч болно: жишээ нь {"phone": "..."} бол flow дотор {{vars.phone}}.
4. Publish, Идэвхжүүлэх. Идэвхгүй flow-ийн URL татгалзана.

Мэдэх зүйл: - Хүсэлтэд тэр дороо "хүлээж авлаа" гэж хариулаад flow-ийг ард нь ажиллуулна. Үр дүнг Flow-ийн тайлангийн гүйлтүүдээс харна. - Энэ гүйлт тодорхой харилцагчийн яриатай холбоогүй тул чатад мессеж илгээхгүй. Мэдээллийг боловсруулж, Webhook дуудах node-оор өөр систем рүү дамжуулахад тохиромжтой. - URL дотор нууц түлхүүр бий: нууц үг шиг хадгал. Алдагдсан бол Дахин үүсгэх дарна, хуучин URL ажиллахаа болино.

API дуудлага нь таны сайт, апп, CRM flow-оо "функц" шиг дуудаж хариуг шууд авах боломж. Хөгжүүлэгчтэй ажилладаг админд зориулсан.

1. Flow үүсгэхдээ эхлүүлэх нөхцөлд API дуудлага сонгоно. Багцад Хөгжүүлэгчийн API (Starter ба түүнээс дээш) байхгүй бол энэ сонголт идэвхгүй.
2. Canvas дээр Эхлэл node сонгоход API-аар дуудах самбар: Flow ID, жишээ дуудлага (curl), API-аар ажилладаг node-уудын жагсаалт. Ажиллахгүй node canvas дээр байвал "Эдгээр node API-аар ажиллахгүй" гэж урьдчилан нэрлэнэ.
3. Түлхүүр: цэс, API (Хөгжүүлэгч хуудас), Түлхүүр үүсгэх. sk_live_ гэж эхэлсэн түлхүүр зөвхөн үүсгэх үедээ нэг удаа харагдана, хадгалж ав.
4. Зурган дээрх Flow дуудах картын жишээ: POST /v1/flows/<flow_id>/invoke, Authorization толгойд түлхүүр, биед input.
5. Зөвхөн нийтлэгдсэн, идэвхтэй flow дуудагдана.

Дэлгэрэнгүй баримт: openbot.mn/developers/flows (төлбөртэй багцтай нэвтэрсэн хэрэглэгчид нээлттэй).

Хөгжүүлэгчид дамжуулах гол дүрмүүд (бүрэн тайлбар нь хөгжүүлэгчийн баримтад):

• Хариу: status нь completed (дууссан), waiting (асуулт тавьсан), failed (алдаатай). messages дотор flow-ийн "илгээх" байсан мессежүүд, output дотор Төгсгөл node-ийн гаралт. HTTP код хүсэлтийнх, status гүйлтийнх: гүйлт доторх алдаа 200 + status failed байдлаар ирнэ.
• Асуулттай flow: waiting + session_id ирнэ. Хэрэглэгчийн хариуг session_id-тэй 1 цагийн дотор илгээж үргэлжлүүлнэ.
• Idempotency-Key толгой: сүлжээ тасарч дахин илгээхэд flow хоёр удаа гүйхгүй, анхны хариу буцна.
• Ажиллахгүй node: харилцагч, яриа шаарддаг node-тэй flow-г дуудахад 422 flow_not_invokable гэж аль node болохыг нэрлэнэ. Мөн файл хүлээдэг асуулт API-аар ажиллахгүй.
• Квот: дуудлага өөрөө AI хариуд тоологдохгүй. AI боловсруулалт, санаа ангилах, мэдээлэл ялгах node амжилттай ажиллавал чатынхтай ижил нэгж зарцуулна.
• Гүйлт бүр Flow-ийн тайланд харагдана. Хөгжүүлэгч өөрийн серверт flow.completed, flow.failed эвентийг webhook-оор авч болно (Хөгжүүлэгч хуудас, Webhook таб).

Хөгжүүлэгчийн API-ийн бусад боломжийг Developer API хичээлээс үзнэ.

Нэг flow-ийг хадгалах, өөр workspace руу хуулах, хөгжүүлэгчид илгээх энгийн арга.

Экспорт: Автоматжуулалт хуудасны жагсаалтад flow-ийн мөрийн гурван цэгтэй цэс: - JSON экспорт (OpenBot .json): OpenBot руу дахин импортлох файл. - JSON экспорт (n8n): n8n workflow болгож татна, n8n editor руу оруулна. Webhook дуудах node-ийн header-ийн нууц утга файлд орохгүй: "N header-ийн нууц утга файлд ороогүй" гэж сануулна. Header-ээс өөр талбарт нууц түлхүүр бичсэн бол экспорт татгалзаж аль талбар гэдгийг жагсаана: тэр утгыг header руу зөөх эсвэл хасна.

Импорт: жагсаалтын баруун дээд талын гурван цэгтэй цэс, Импорт. "Flow импорт" цонхонд JSON файл сонгох эсвэл JSON текст буулгах. Шинэ нэр заавал биш. Оруулах дармагц шинэ flow-ийн canvas нээгдэнэ. n8n workflow бас оруулж болно: тохирохгүй хэсгийг анхааруулгаар жагсаана.

Импортлогдсон flow заавал Draft. Нууц утгуудыг дахин оруулаад, тестлээд Publish хийнэ.

Олон flow ба AI тохиргоог хамт зөөх бол JSON биш AI апп ашиглана.

• Ноорог: суулгалт, импорт бүр ноорог. Шар "Нийтлэгдээгүй өөрчлөлт бий" мөр, Draft төлөвийг шалга.
• AI тохиргооны давхцал: суулгахын өмнөх сануулгыг анхааралтай унш.
• Нууц утга: экспорт, апп, Marketplace бүр нууц утгыг хасдаг. Суулгалтын үр дүнд "Нууц утга дахин оруулах" жагсаалт гардаг.
• Marketplace-ийн татгалзал: админы тайлбар ба олдсон хэсэг (Зарын текст, Апп-ын нэр, AI тохиргоо, Workspace тохиргоо) харагдана.
• API-ийн 422: Эхлэл node-ийн API самбар аль node ажиллахгүйг урьдчилан харуулдаг. Шошго, оператор шиг үйлдлийг API-аар биш, хариуг авсан тал өөрөө хийнэ.

Асуулт бүрт эхлээд өөрөө хариулаад, дараа нь хариултыг нээж шалгаарай.

1. AI апп-д бизнесийн утас, данс орох уу?

   Үгүй. Зөвхөн зан төлөв, дүрэм, flow-ууд. Бизнесийн мэдээлэл суулгасан workspace-ийнх хэвээр.

2. Marketplace-аас суулгасан flow хэзээ харилцагчид ажиллаж эхлэх вэ?

   Та туршаад Publish хийж Идэвхжүүлсний дараа. Суулгалт ноорог болж орно.

3. Мэдлэгийн сан Marketplace-аар дамжих уу?

   Үгүй. Зөвхөн өөрийн workspace-ууд руу шууд суулгахад, сонговол.

4. Гадны webhook-оор эхэлсэн flow харилцагч руу мессеж бичих үү?

   Үгүй. Тодорхой ярианд холбоогүй. Өгөгдөл боловсруулж өөр систем рүү дамжуулна.

5. API-аар дуудахад flow асуулт тавьвал юу болох вэ?

   status waiting + session_id. Хариуг 1 цагийн дотор session_id-тэй илгээнэ.

Flow Studio-гийн хичээлүүд дууслаа. Дараа нь: Developer API хичээл (түлхүүр, webhook эвент, гадаад бот) ба Тайлан хичээл.

Эргэж харах: flow үүсгэх Flow Studio: үндэс, node бүр Node-ууд, AI node-ууд, тест ба алдаа засах.