MAX este un messenger rus, iar AiHummer se conectează la el ca un canal. Agentul apare în MAX ca un bot: primește mesaje inbound, rulează un turn normal și trimite răspunsul înapoi — exact ca Telegram și celelalte canale.
MAX livrează ca un Conector canal de piață și este construit pe API-ul MAX Bot. Nu este un serviciu pe care să-l construiești singur: instalezi conectorul din Marketplace-ul din produs și îl configurezi din interfața de administrare, ca orice alt canal.
Instalează din Marketplace
Deschideți produsul în aplicație Piață și instalează MAX modul. Odată instalat, canalul apare în secțiunea de canale a interfeței de administrare cu ID-ul canalului max — folosește acel id când asociezi un agent sau filtrezi conversațiile după sursă.
[!NOTE]
Canalul MAX necesită un activ Starter, Afaceri sau Întreprindere
licență. Pe planul Comunității, instalarea conectorului returnează
HTTP 402 “actualizare necesară” (cod plan_limit) — vezi
Licențiere.
Configurează-l din interfața de administrare
Creează un bot MAX și obține tokenul său.
În interfața de administrare, deschide MAX setările canalului.
Lipește tokenul botului în MAX_BOT_TOKEN (un secret, necesar).
Setați opțional URL-ul de bază al API-ului MAX Bot în MAX_API_BASE. Implicit este
https://platform-api2.max.ru, așa că de obicei poți lăsa acest câmp necompletat.
Salvați — conectorul începe să primească și să trimită mesaje.
[!TIP]
MAX este canalul identificat pentru AiHummer ca max. Folosește acel ID de canal atunci când tu
leagă un agent sau filtrează conversațiile după sursă.
Ce este acceptat
Conectorul MAX acoperă fluxurile principale de conversație:
Trimite și primește mesaje între agent și utilizatorii MAX.
Intrare cu sondaj lung — conectorul preia actualizările primite (mențiuni,
răspunsuri, mass-media, evenimente interactive), astfel că nu este necesar niciun port public de intrare.
Răspunsuri native la un mesaj specific.
Tastaturi inline de bază pentru butoane interactive rapide.
Media-dupa-URL în mesajele de ieșire.
Elimină duplicatele după cheie, astfel încât o livrare reîncercată să nu producă niciodată un duplicat.
Cum circulă mesajele
Fiecare mesaj MAX primit ajunge la gateway prin aceeași cale de intrare ca orice alt canal, securizată de partajare secret HMAC de intrare. De acolo, motorul de turn prelucrează aceasta ca orice alt mesaj de canal.
[!NOTE]
Poarta trebuie să aibă un spațiu de lucru implicit configurat pentru a direcționa intrările
mesaje.
**MAX este un messenger rus, iar AiHummer se conectează la el ca un canal.** Agentul apare în MAX ca un bot: primește mesaje inbound, rulează un turn normal și trimite răspunsul înapoi — exact ca Telegram și celelalte canale.
MAX livrează ca un **Conector canal de piață** și este construit pe **API-ul MAX Bot**. Nu este un serviciu pe care să-l construiești singur: instalezi conectorul din Marketplace-ul din produs și îl configurezi din interfața de administrare, ca orice alt canal.
## Instalează din Marketplace
Deschideți produsul în aplicație [Piață](/ro/v1.0/marketplace/overview-tiers) și instalează **MAX** modul. Odată instalat, canalul apare în secțiunea de canale a interfeței de administrare cu ID-ul canalului `max` — folosește acel id când asociezi un agent sau filtrezi conversațiile după sursă.
> [!NOTE]
> Canalul MAX necesită un activ **Starter**, **Afaceri** sau **Întreprindere**
> licență. Pe planul Comunității, instalarea conectorului returnează
> **HTTP 402 "actualizare necesară"** (cod `plan_limit`) — vezi
> [Licențiere](/ro/v1.0/commercial/licensing).
## Configurează-l din interfața de administrare
1. Creează un bot MAX și obține tokenul său.
2. În interfața de administrare, deschide **MAX** setările canalului.
3. Lipește tokenul botului în **`MAX_BOT_TOKEN`** (un secret, necesar).
4. Setați opțional URL-ul de bază al API-ului MAX Bot în **`MAX_API_BASE`**. Implicit este
`https://platform-api2.max.ru`, așa că de obicei poți lăsa acest câmp necompletat.
5. Salvați — conectorul începe să primească și să trimită mesaje.
> [!TIP]
> MAX este canalul identificat pentru AiHummer ca `max`. Folosește acel ID de canal atunci când tu
> leagă un agent sau filtrează conversațiile după sursă.
## Ce este acceptat
Conectorul MAX acoperă fluxurile principale de conversație:
- **Trimite și primește mesaje** între agent și utilizatorii MAX.
- **Intrare cu sondaj lung** — conectorul preia actualizările primite (mențiuni,
răspunsuri, mass-media, evenimente interactive), astfel că nu este necesar niciun port public de intrare.
- **Răspunsuri native** la un mesaj specific.
- **Tastaturi inline de bază** pentru butoane interactive rapide.
- **Media-dupa-URL** în mesajele de ieșire.
- **Elimină duplicatele după cheie**, astfel încât o livrare reîncercată să nu producă niciodată un duplicat.
## Cum circulă mesajele
Fiecare mesaj MAX primit ajunge la gateway prin aceeași cale de intrare ca orice alt canal, securizată de partajare **secret HMAC de intrare**. De acolo, motorul de turn prelucrează aceasta ca orice alt mesaj de canal.
> [!NOTE]
> Poarta trebuie să aibă un spațiu de lucru implicit configurat pentru a direcționa intrările
> mesaje.
## Unde următor?
- Compară cu canalul de chat similar: [Telegram](/ro/v1.0/channels/telegram).
- Despre instalarea conectorilor: [Piață](/ro/v1.0/marketplace/overview-tiers).
- Abia începi? Vezi [Ghid rapid](/ro/v1.0/getting-started/quickstart).