MAX yra Rusijos pranešimų siuntimo programa, o AiHummer jungiasi prie jos kaip kanalo. Agentas MAX pasirodo kaip botas: jis gauna įeinančias žinutes, vykdo įprastą ciklą ir išsiunčia atsakymą atgal — taip pat kaip Telegram ir kiti kanalai.
MAX siunčia kaip Prekyvietės kanalo jungiklis ir yra pastatytas ant MAX Bot API. Tai nėra paslauga, kurią kuriate patys: įdiekite jungtį iš produkto viduje esančios „Marketplace“ ir sukonfigūruokite ją naudodami administratoriaus sąsają, kaip ir bet kurį kitą kanalą.
Įdiegti iš Turgavietės
Atidaryti produktyje Prekyvietė ir įdiegti MAKS modulis. Įdiegus, kanalas pasirodo Administratoriaus sąsajos kanalų skiltyje su kanalo ID max — naudokite tą ID, kai susiejate agentą arba filtruojate pokalbius pagal šaltinį.
[!NOTE]
MAX kanalui reikia aktyvaus Starteris, Verslas arba Įmonė
licencija. Bendruomenės plane jungiklio įdiegimas grąžina
HTTP 402 „reikalingas atnaujinimas“ (kodas plan_limit) — žiūrėti
Licencijavimas.
Nustatykite tai iš administratoriaus vartotojo sąsajos
Sukurkite MAX botą ir gaukite jo žetoną.
Admin sąsajoje atidarykite MAKS kanalo nustatymai.
Įklijuokite bot’o žetoną į MAX_BOT_TOKEN (slapta, būtina).
Pasirinktinai nustatykite MAX Bot API pagrindinį URL MAX_API_BASE. Pagal numatytuosius nustatymus tai yra
https://platform-api2.max.ru, tad paprastai galite palikti tai tuščią.
Išsaugoti — jungtis pradeda gauti ir siųsti žinutes.
[!TIP]
MAX yra kanalas, identifikuotas AiHummer kaip max. Naudokite tą kanalo ID, kai jūs
susieti agentą arba filtruoti pokalbius pagal šaltinį.
Kas yra palaikoma
MAX jungtis apima pagrindinius pokalbio srautus:
Siųsti ir gauti žinutes tarp agento ir MAX vartotojų.
Ilgo laikotarpio įeinantis užklausimas — jungtis traukia įeinančius atnaujinimus (paminėjimus,
atsakymai, žiniasklaida, interaktyvūs renginiai), todėl nereikia jokių įeinančių viešųjų prievadų.
Pašalinti dublikatus pagal raktą, todėl pakartotinis pristatymas niekada nesukelia dubliuoto įrašo.
Kaip teka žinutės
Kiekviena gaunama MAX žinutė pasiekia vartus tuo pačiu įeinančiu keliu kaip ir kiekvienas kitas kanalas, apsaugota bendru įeinančio-HMAC slaptas raktas. Iš ten TURN variklis apdoroja tai kaip bet kurią kitą kanalo žinutę.
[!NOTE]
Vartai turi turėti sukonfigūruotą numatytąją darbo vietą įeinančioms užklausoms perduoti
žinutės.
Kur toliau
Palyginkite su panašiu pokalbių kanalu: Telegrama.
**MAX yra Rusijos pranešimų siuntimo programa, o AiHummer jungiasi prie jos kaip kanalo.** Agentas MAX pasirodo kaip botas: jis gauna įeinančias žinutes, vykdo įprastą ciklą ir išsiunčia atsakymą atgal — taip pat kaip Telegram ir kiti kanalai.
MAX siunčia kaip **Prekyvietės kanalo jungiklis** ir yra pastatytas ant **MAX Bot API**. Tai nėra paslauga, kurią kuriate patys: įdiekite jungtį iš produkto viduje esančios „Marketplace“ ir sukonfigūruokite ją naudodami administratoriaus sąsają, kaip ir bet kurį kitą kanalą.
## Įdiegti iš Turgavietės
Atidaryti produktyje [Prekyvietė](/lt/v1.0/marketplace/overview-tiers) ir įdiegti **MAKS** modulis. Įdiegus, kanalas pasirodo Administratoriaus sąsajos kanalų skiltyje su kanalo ID `max` — naudokite tą ID, kai susiejate agentą arba filtruojate pokalbius pagal šaltinį.
> [!NOTE]
> MAX kanalui reikia aktyvaus **Starteris**, **Verslas** arba **Įmonė**
> licencija. Bendruomenės plane jungiklio įdiegimas grąžina
> **HTTP 402 „reikalingas atnaujinimas“** (kodas `plan_limit`) — žiūrėti
> [Licencijavimas](/lt/v1.0/commercial/licensing).
## Nustatykite tai iš administratoriaus vartotojo sąsajos
1. Sukurkite MAX botą ir gaukite jo žetoną.
2. Admin sąsajoje atidarykite **MAKS** kanalo nustatymai.
3. Įklijuokite bot'o žetoną į **`MAX_BOT_TOKEN`** (slapta, būtina).
4. Pasirinktinai nustatykite MAX Bot API pagrindinį URL **`MAX_API_BASE`**. Pagal numatytuosius nustatymus tai yra
`https://platform-api2.max.ru`, tad paprastai galite palikti tai tuščią.
5. Išsaugoti — jungtis pradeda gauti ir siųsti žinutes.
> [!TIP]
> MAX yra kanalas, identifikuotas AiHummer kaip `max`. Naudokite tą kanalo ID, kai jūs
> susieti agentą arba filtruoti pokalbius pagal šaltinį.
## Kas yra palaikoma
MAX jungtis apima pagrindinius pokalbio srautus:
- **Siųsti ir gauti žinutes** tarp agento ir MAX vartotojų.
- **Ilgo laikotarpio įeinantis užklausimas** — jungtis traukia įeinančius atnaujinimus (paminėjimus,
atsakymai, žiniasklaida, interaktyvūs renginiai), todėl nereikia jokių įeinančių viešųjų prievadų.
- **Gimtasis atsakymas** į konkretų pranešimą.
- **Paprastos įterptos klaviatūros** greitiems interaktyviems mygtukams.
- **Medija pagal URL** išvykstančiuose pranešimuose.
- **Pašalinti dublikatus pagal raktą**, todėl pakartotinis pristatymas niekada nesukelia dubliuoto įrašo.
## Kaip teka žinutės
Kiekviena gaunama MAX žinutė pasiekia vartus tuo pačiu įeinančiu keliu kaip ir kiekvienas kitas kanalas, apsaugota bendru **įeinančio-HMAC slaptas raktas**. Iš ten TURN variklis apdoroja tai kaip bet kurią kitą kanalo žinutę.
> [!NOTE]
> Vartai turi turėti sukonfigūruotą numatytąją darbo vietą įeinančioms užklausoms perduoti
> žinutės.
## Kur toliau
- Palyginkite su panašiu pokalbių kanalu: [Telegrama](/lt/v1.0/channels/telegram).
- Diegiant jungtis: [Prekyvietė](/lt/v1.0/marketplace/overview-tiers).
- Tik pradedate? Žr. [Greitas pradžia](/lt/v1.0/getting-started/quickstart).
