MAX

**MAX паёмнависи русӣ аст ва AiHummer ба он ҳамчун канал пайваст мешавад.** Агент дар MAX ҳамчун бот пайдо мешавад: паёмҳои воридшавандаро қабул мекунад, гардиши муқаррариро иҷро мекунад ва ҷавобро бармегардонад — дақиқан мисли Telegram ва каналҳои дигар. MAX ҳамчун **коннектори канали Marketplace** интиқол дода мешавад ва дар асоси **MAX Bot API** сохта шудааст. Он хидмате нест, ки шумо худатон месозед: шумо коннекторро аз Marketplace-и дохили маҳсулот насб мекунед ва онро аз Admin UI, мисли ҳар канали дигар, танзим мекунед. ## Аз Marketplace насб кунед [Marketplace](/tg/v1.0/marketplace/overview-tiers)-и дохили маҳсулотро кушоед ва модули **MAX**-ро насб кунед. Пас аз насб, канал дар бахши каналҳои Admin UI бо id-и канали `max` пайдо мешавад — он id-ро ҳангоми бастани агент ё филтр кардани сӯҳбатҳо аз рӯи манбаъ истифода баред. ## Аз Admin UI танзим кунед 1. Як боти MAX эҷод кунед ва токени онро ба даст оред. 2. Дар Admin UI, танзимоти канали **MAX**-ро кушоед. 3. Токени ботро ба **`MAX_BOT_TOKEN`** (роз, ҳатмӣ) гузоред. 4. Ихтиёрӣ, URL-и асосии MAX Bot API-ро дар **`MAX_API_BASE`** танзим кунед. Он ба таври пешфарз ба `https://platform-api2.max.ru` муқаррар аст, бинобар ин одатан шумо метавонед инро холӣ гузоред. 5. Захира кунед — коннектор паёмҳоро қабул ва фиристодан оғоз мекунад. > [!TIP] > MAX канале аст, ки ба AiHummer ҳамчун `max` муаррифӣ мешавад. Он id-и каналро > ҳангоми бастани агент ё филтр кардани сӯҳбатҳо аз рӯи манбаъ истифода баред. ## Чӣ дастгирӣ мешавад Коннектори MAX ҷараёнҳои асосии сӯҳбатро фаро мегирад: - **Фиристодан ва қабули паёмҳо** байни агент ва корбарони MAX. - **Воридшавандаи long-poll** — коннектор навсозиҳои воридшавандаро (ёдрасиҳо, ҷавобҳо, медиа, рӯйдодҳои интерактивӣ) pull мекунад, бинобар ин ягон порти ҷамъиятии воридшаванда лозим нест. - **Ҷавобҳои ватанӣ** ба паёми мушаххас. - **Клавиатураҳои asosии inline** барои тугмаҳои интерактивии зуд. - **Медиа-аз-URL** дар паёмҳои берунравӣ. - **Dedupe аз рӯи калид**, бинобар ин расонидани такроршуда ҳеҷ гоҳ паёми дубора эҷод намекунад. ## Чӣ тавр паёмҳо ҷараён мегиранд Ҳар паёми воридшавандаи MAX ба gateway тавассути ҳамон масири воридшаванда мисли ҳар канали дигар мерасад, ки бо **рози inbound-HMAC**-и муштарак ҳифз шудааст. Аз он ҷо муҳаррики гардиш онро мисли ҳар паёми канали дигар коркард мекунад. > [!NOTE] > gateway бояд як корфазои пешфарз танзимшуда дошта бошад, то паёмҳои > воридшавандаро равон кунад. ## Қадами навбатӣ ба куҷо - Бо канали чати монанд муқоиса кунед: [Telegram](/tg/v1.0/channels/telegram). - Дар бораи насби коннекторҳо: [Marketplace](/tg/v1.0/marketplace/overview-tiers). - Танҳо оғоз мекунед? [Quickstart](/tg/v1.0/getting-started/quickstart)-ро бубинед.