Суваг/МАКС
МАКС
v1.1.x · шинэчилсэн 2026-07-05
MAX бол Оросын мессенжер бөгөөд AiHummer үүнийг сувгаар холбодог. Төлөөлөгч нь MAX-д бот маягаар гарч ирдэг: ирсэн зурвасуудыг хүлээн авдаг, энгийн эргэлт ажиллуулдаг, хариуг буцаан илгээдэг — яг Telegram болон бусад сувгууд шиг.
MAX нь … болгон корабльд шилжинэ Зах зээлийн сувгийн холбогч мөн дээр суурилсан MAX Бот API. Энэ нь өөрөө бүтээдэг үйлчилгээ биш юм: та бүтээгдэхүүний доторх Маркетплейсээс залгуурыг суулгаж, бусад суваг шиг Админ UI-аас тохируулдаг.
Маркетплейсээс суулгана уу
Бүтээгдэхүүн дотроос нээх Зах зээл мөн суулгана МАКС модуль. Суулгасны дараа энэ суваг нь Админ UI-ийн сувгууд хэсэгт сувгийн id-тайгаар гарч ирдэг max — агентыг холбохдоо эсвэл яриаг эх үүсвэрээр шүүнэ үүсгэдэгдээ энэ ID-г ашигла.
[!NOTE]
MAX суваг идэвхтэй байхыг шаарддаг Эхлүүлэгч, Бизнес эсвэл Энтэрпрайз
эрх. Нийгэмлэгийн төлөвлөгөөнд, холбогчийг суулгах нь буцаалт өгдөг
HTTP 402 “шинэчлэлт шаардлагатай” (код plan_limit) — үзэх
Лицензийн олголт.
Админ UI-гаас тохируулна уу
- MAX ботыг үүсгээд түүний токеныг аваарай.
- Админ UI-д нээнэ үү МАКС суваг тохиргоо.
- Ботын токеныг оруулна уу
MAX_BOT_TOKEN (нууц, шаардлагатай)
- Сонголтоор MAX Bot API үндсэн URL-ийг тохируулна уу
MAX_API_BASE. Үүнийг анхдагчаар тохируулдаг
https://platform-api2.max.ru, тиймээс та ихэвчлэн үүнийг хоосон орхиж болно.
- Хадгалах — холбогч нь мессеж хүлээн авч илгээж эхэлнэ.
[!TIP]
MAX нь AiHummer-д танигдсан суваг юм max. Та үүнийг ашиглах үед тэр сувгийн ID-г хэрэглэнэ
нэг агенттай холбож эсвэл эх үүсвэрээр нь яриаг шүүх.
Дэмжигддэг зүйл юу вэ
MAX залгуур нь үндсэн ярианы урсгалуудыг хамардаг:
- Мессеж илгээх ба хүлээн авах агент ба MAX хэрэглэгчдийн хооронд.
- Удаан таталттай орж ирж буй — холбогч орж ирж буй шинэчлэлтүүдийг татдаг (дурдсан,
хариу, медиа, интерактив арга хэмжээ), тиймээс нээсэн олон нийтийн порт шаардагдахгүй.
- Өөр нутгийн хүн хариу өгнө тодорхой мессеж рүү.
- Анхан шатны нэг мөрийн гар харилцан идэвхтэй товчлууруудыг хурдан хийхэд.
- Медиа-URL-аар гадуур илгээх мессежүүдэд.
- Түлхүүрээр давхардлыг арилгах, тиймээс дахин хүргэх оролдлого хоёр дахин давтагдахаас сэргийлдэг.
Зурвасууд хэрхэн урсдаг
Бүх орж ирж буй MAX мессежүүд нь бусад сувгуудын адил орж ирэх замаар хаалганы руу ирдэг бөгөөд нийтийн хамгаалалттай байдаг ирж буй-HMAC нууц. Тэндээс эргэлтийн хөдөлгүүр үүнийг бусад сувгийн зурвасын адил боловсруулдаг.
[!NOTE]
Гэрэлтэх хаалган дээр дотоод орох утгыг тараахад зориулсан үндсэн ажлын орон зайг тохируулах ёстой
мессежүүд.
Дараа хаашаа явах вэ
**MAX бол Оросын мессенжер бөгөөд AiHummer үүнийг сувгаар холбодог.** Төлөөлөгч нь MAX-д бот маягаар гарч ирдэг: ирсэн зурвасуудыг хүлээн авдаг, энгийн эргэлт ажиллуулдаг, хариуг буцаан илгээдэг — яг Telegram болон бусад сувгууд шиг.
MAX нь ... болгон корабльд шилжинэ **Зах зээлийн сувгийн холбогч** мөн дээр суурилсан **MAX Бот API**. Энэ нь өөрөө бүтээдэг үйлчилгээ биш юм: та бүтээгдэхүүний доторх Маркетплейсээс залгуурыг суулгаж, бусад суваг шиг Админ UI-аас тохируулдаг.
## Маркетплейсээс суулгана уу
Бүтээгдэхүүн дотроос нээх [Зах зээл](/mn/v1.0/marketplace/overview-tiers) мөн суулгана **МАКС** модуль. Суулгасны дараа энэ суваг нь Админ UI-ийн сувгууд хэсэгт сувгийн id-тайгаар гарч ирдэг `max` — агентыг холбохдоо эсвэл яриаг эх үүсвэрээр шүүнэ үүсгэдэгдээ энэ ID-г ашигла.
> [!NOTE]
> MAX суваг идэвхтэй байхыг шаарддаг **Эхлүүлэгч**, **Бизнес** эсвэл **Энтэрпрайз**
> эрх. Нийгэмлэгийн төлөвлөгөөнд, холбогчийг суулгах нь буцаалт өгдөг
> **HTTP 402 "шинэчлэлт шаардлагатай"** (код `plan_limit`) — үзэх
> [Лицензийн олголт](/mn/v1.0/commercial/licensing).
## Админ UI-гаас тохируулна уу
1. MAX ботыг үүсгээд түүний токеныг аваарай.
2. Админ UI-д нээнэ үү **МАКС** суваг тохиргоо.
3. Ботын токеныг оруулна уу **`MAX_BOT_TOKEN`** (нууц, шаардлагатай)
4. Сонголтоор MAX Bot API үндсэн URL-ийг тохируулна уу **`MAX_API_BASE`**. Үүнийг анхдагчаар тохируулдаг
`https://platform-api2.max.ru`, тиймээс та ихэвчлэн үүнийг хоосон орхиж болно.
5. Хадгалах — холбогч нь мессеж хүлээн авч илгээж эхэлнэ.
> [!TIP]
> MAX нь AiHummer-д танигдсан суваг юм `max`. Та үүнийг ашиглах үед тэр сувгийн ID-г хэрэглэнэ
> нэг агенттай холбож эсвэл эх үүсвэрээр нь яриаг шүүх.
## Дэмжигддэг зүйл юу вэ
MAX залгуур нь үндсэн ярианы урсгалуудыг хамардаг:
- **Мессеж илгээх ба хүлээн авах** агент ба MAX хэрэглэгчдийн хооронд.
- **Удаан таталттай орж ирж буй** — холбогч орж ирж буй шинэчлэлтүүдийг татдаг (дурдсан,
хариу, медиа, интерактив арга хэмжээ), тиймээс нээсэн олон нийтийн порт шаардагдахгүй.
- **Өөр нутгийн хүн хариу өгнө** тодорхой мессеж рүү.
- **Анхан шатны нэг мөрийн гар** харилцан идэвхтэй товчлууруудыг хурдан хийхэд.
- **Медиа-URL-аар** гадуур илгээх мессежүүдэд.
- **Түлхүүрээр давхардлыг арилгах**, тиймээс дахин хүргэх оролдлого хоёр дахин давтагдахаас сэргийлдэг.
## Зурвасууд хэрхэн урсдаг
Бүх орж ирж буй MAX мессежүүд нь бусад сувгуудын адил орж ирэх замаар хаалганы руу ирдэг бөгөөд нийтийн хамгаалалттай байдаг **ирж буй-HMAC нууц**. Тэндээс эргэлтийн хөдөлгүүр үүнийг бусад сувгийн зурвасын адил боловсруулдаг.
> [!NOTE]
> Гэрэлтэх хаалган дээр дотоод орох утгыг тараахад зориулсан үндсэн ажлын орон зайг тохируулах ёстой
> мессежүүд.
## Дараа хаашаа явах вэ
- Адил чат сувгатай харьцуулна уу: [Телеграм](/mn/v1.0/channels/telegram).
- Холбогч суурилуулахад: [Зах зээл](/mn/v1.0/marketplace/overview-tiers).
- Зөвхөн эхлэж байна уу? Үүнийг үзнэ үү [Хурдан эхлэлт](/mn/v1.0/getting-started/quickstart).