MAX-ը ռուսական մեսենջեր է, և AiHummer-ը միանում է դրան որպես ալիք։ Գործակալը
հայտնվում է MAX-ում որպես բոտ. այն ստանում է մուտքային հաղորդագրություններ, կատարում նորմալ turn,
և հետ ուղարկում պատասխանը — ճիշտ ինչպես Telegram-ը և մյուս ալիքները։
MAX-ը մատակարարվում է որպես Marketplace ալիքի կոնեկտոր և կառուցված է MAX Bot
API-ի վրա։ Այն ծառայություն չէ, որ դուք ինքներդ կառուցում եք. դուք տեղադրում եք կոնեկտորը
ապրանքի ներսում գործող Marketplace-ից և կարգավորում Admin UI-ից, ինչպես ցանկացած այլ
ալիք։
Տեղադրեք Marketplace-ից
Բացեք ապրանքի ներսում գործող Marketplace-ը և տեղադրեք
MAX մոդուլը։ Տեղադրվելուց հետո ալիքը հայտնվում է Admin UI-ի ալիքների բաժնում
max ալիքի id-ով — օգտագործեք այդ id-ն, երբ կապում եք գործակալ կամ
զտում զրույցները ըստ աղբյուրի։
Կարգավորեք այն Admin UI-ից
Ստեղծեք MAX բոտ և ստացեք դրա token-ը։
Admin UI-ում բացեք MAX ալիքի կարգավորումները։
Տեղադրեք բոտի token-ը MAX_BOT_TOKEN-ի մեջ (secret, պարտադիր)։
Ընտրովի կերպով սահմանեք MAX Bot API base URL-ը MAX_API_BASE-ում։ Այն լռելյայն
ունի https://platform-api2.max.ru արժեքը, այնպես որ սովորաբար կարող եք սա թողնել դատարկ։
Պահպանեք — կոնեկտորը սկսում է ստանալ և ուղարկել հաղորդագրություններ։
[!TIP]
MAX-ը AiHummer-ին նույնականացված ալիքն է որպես max։ Օգտագործեք այդ ալիքի id-ն, երբ
կապում եք գործակալ կամ զտում զրույցները ըստ աղբյուրի։
Ինչ է աջակցվում
MAX կոնեկտորը ընդգրկում է հիմնական զրույցի հոսքերը.
Հաղորդագրությունների ուղարկում և ստացում գործակալի և MAX օգտատերերի միջև։
Long-poll մուտքային — կոնեկտորը քաշում է մուտքային թարմացումները (նշումներ,
պատասխաններ, մեդիա, ինտերակտիվ իրադարձություններ), այնպես որ մուտքային հանրային պորտ չի պահանջվում։
Native պատասխաններ կոնկրետ հաղորդագրությանը։
Հիմնական inline ստեղնաշարեր արագ ինտերակտիվ կոճակների համար։
Մեդիա-ըստ-URL-ի ելքային հաղորդագրություններում։
Կրկնօրինակների հեռացում ըստ key-ի, այնպես որ կրկնված առաքումը երբեք չի առաջացնում կրկնակ։
Ինչպես են հոսում հաղորդագրությունները
Յուրաքանչյուր մուտքային MAX հաղորդագրություն հասնում է gateway-ին նույն մուտքային ուղով, ինչ ամեն
մյուս ալիք՝ պաշտպանված ընդհանուր inbound-HMAC secret-ով։ Այնտեղից turn
engine-ը մշակում է այն, ինչպես ցանկացած այլ ալիքի հաղորդագրություն։
[!NOTE]
Gateway-ը պետք է ունենա կարգավորված լռելյայն workspace՝ մուտքային
հաղորդագրությունները ուղարկելու համար։
**MAX-ը ռուսական մեսենջեր է, և AiHummer-ը միանում է դրան որպես ալիք։** Գործակալը
հայտնվում է MAX-ում որպես բոտ. այն ստանում է մուտքային հաղորդագրություններ, կատարում նորմալ turn,
և հետ ուղարկում պատասխանը — ճիշտ ինչպես Telegram-ը և մյուս ալիքները։
MAX-ը մատակարարվում է որպես **Marketplace ալիքի կոնեկտոր** և կառուցված է **MAX Bot
API**-ի վրա։ Այն ծառայություն չէ, որ դուք ինքներդ կառուցում եք. դուք տեղադրում եք կոնեկտորը
ապրանքի ներսում գործող Marketplace-ից և կարգավորում Admin UI-ից, ինչպես ցանկացած այլ
ալիք։
## Տեղադրեք Marketplace-ից
Բացեք ապրանքի ներսում գործող [Marketplace](/hy/v1.0/marketplace/overview-tiers)-ը և տեղադրեք
**MAX** մոդուլը։ Տեղադրվելուց հետո ալիքը հայտնվում է Admin UI-ի ալիքների բաժնում
`max` ալիքի id-ով — օգտագործեք այդ id-ն, երբ կապում եք գործակալ կամ
զտում զրույցները ըստ աղբյուրի։
## Կարգավորեք այն Admin UI-ից
1. Ստեղծեք MAX բոտ և ստացեք դրա token-ը։
2. Admin UI-ում բացեք **MAX** ալիքի կարգավորումները։
3. Տեղադրեք բոտի token-ը **`MAX_BOT_TOKEN`**-ի մեջ (secret, պարտադիր)։
4. Ընտրովի կերպով սահմանեք MAX Bot API base URL-ը **`MAX_API_BASE`**-ում։ Այն լռելյայն
ունի `https://platform-api2.max.ru` արժեքը, այնպես որ սովորաբար կարող եք սա թողնել դատարկ։
5. Պահպանեք — կոնեկտորը սկսում է ստանալ և ուղարկել հաղորդագրություններ։
> [!TIP]
> MAX-ը AiHummer-ին նույնականացված ալիքն է որպես `max`։ Օգտագործեք այդ ալիքի id-ն, երբ
> կապում եք գործակալ կամ զտում զրույցները ըստ աղբյուրի։
## Ինչ է աջակցվում
MAX կոնեկտորը ընդգրկում է հիմնական զրույցի հոսքերը.
- **Հաղորդագրությունների ուղարկում և ստացում** գործակալի և MAX օգտատերերի միջև։
- **Long-poll մուտքային** — կոնեկտորը քաշում է մուտքային թարմացումները (նշումներ,
պատասխաններ, մեդիա, ինտերակտիվ իրադարձություններ), այնպես որ մուտքային հանրային պորտ չի պահանջվում։
- **Native պատասխաններ** կոնկրետ հաղորդագրությանը։
- **Հիմնական inline ստեղնաշարեր** արագ ինտերակտիվ կոճակների համար։
- **Մեդիա-ըստ-URL-ի** ելքային հաղորդագրություններում։
- **Կրկնօրինակների հեռացում ըստ key-ի**, այնպես որ կրկնված առաքումը երբեք չի առաջացնում կրկնակ։
## Ինչպես են հոսում հաղորդագրությունները
Յուրաքանչյուր մուտքային MAX հաղորդագրություն հասնում է gateway-ին նույն մուտքային ուղով, ինչ ամեն
մյուս ալիք՝ պաշտպանված ընդհանուր **inbound-HMAC secret**-ով։ Այնտեղից turn
engine-ը մշակում է այն, ինչպես ցանկացած այլ ալիքի հաղորդագրություն։
> [!NOTE]
> Gateway-ը պետք է ունենա կարգավորված լռելյայն workspace՝ մուտքային
> հաղորդագրությունները ուղարկելու համար։
## Ուր հաջորդիվ
- Համեմատեք նմանատիպ զրույցի ալիքի հետ՝ [Telegram](/hy/v1.0/channels/telegram)։
- Կոնեկտորների տեղադրման մասին՝ [Marketplace](/hy/v1.0/marketplace/overview-tiers)։
- Նո՞ր եք սկսում։ Տեսեք [Quickstart](/hy/v1.0/getting-started/quickstart)-ը։
