MAX jest rosyjskim komunikatorem, a AiHummer łączy się z nim jako kanałem. Agent pojawia się w MAX jako bot: odbiera wiadomości przychodzące, wykonuje normalną turę i odsyła odpowiedź z powrotem — tak jak Telegram i inne kanały.
MAX wysyła jako Łącznik kanału marketplace i jest zbudowany na API bota MAX. To nie jest usługa, którą tworzysz samodzielnie: instalujesz konektor z Marketplace dostępnego w produkcie i konfigurujesz go z poziomu interfejsu administracyjnego, jak każdy inny kanał.
Zainstaluj z Marketplace
Otwórz w produkcie Rynek i zainstaluj MAX moduł. Po zainstalowaniu kanał pojawia się w sekcji kanałów w interfejsie administracyjnym z identyfikatorem kanału max — użyj tego identyfikatora, gdy przypisujesz agenta lub filtrujesz rozmowy według źródła.
[!NOTE]
Kanał MAX wymaga aktywnego Rozrusznik, Biznes lub Przedsiębiorstwo
licencja. W planie Community instalacja łącznika zwraca
HTTP 402 „wymagana aktualizacja” (kod plan_limit) — zobacz
Licencjonowanie.
Skonfiguruj to z interfejsu administracyjnego
Utwórz bota MAX i uzyskaj jego token.
W interfejsie administracyjnym otwórz MAX ustawienia kanału.
Wklej token bota do MAX_BOT_TOKEN (tajny, wymagany).
Opcjonalnie ustaw podstawowy adres URL MAX Bot API w MAX_API_BASE. Domyślnie ustawia się na
https://platform-api2.max.ru, więc zazwyczaj możesz to pozostawić puste.
Zapisz — łącze zaczyna odbierać i wysyłać wiadomości.
[!TIP]
MAX to kanał zidentyfikowany dla AiHummera jako max. Użyj tego identyfikatora kanału, gdy ty
wiązać agenta lub filtrować rozmowy według źródła.
Co jest obsługiwane
Złącze MAX obejmuje podstawowe przepływy rozmów:
Wysyłaj i odbieraj wiadomości pomiędzy agentem a użytkownikami MAX.
Długie oczekiwanie przychodzące — łącznik pobiera nadchodzące aktualizacje (wzmianki,
odpowiedzi, media, wydarzenia interaktywne), więc nie jest wymagany żaden publiczny port przychodzący.
Odpowiedzi rodzimych użytkowników do konkretnej wiadomości.
Podstawowe klawiatury inline dla szybkich interaktywnych przycisków.
Media według URL w wiadomościach wychodzących.
Usuń duplikaty według klucza, więc ponowna dostawa nigdy nie powoduje duplikatu.
Jak przepływają wiadomości
Każda przychodząca wiadomość MAX dociera do bramki tą samą ścieżką przychodzącą, co każdy inny kanał, zabezpieczona przez współdzielony tajny klucz HMAC przychodzący. Stamtąd silnik turn przetwarza go jak każdą inną wiadomość kanałową.
[!NOTE]
Bramka musi mieć skonfigurowane domyślne środowisko robocze do wysyłania przychodzących
wiadomości.
**MAX jest rosyjskim komunikatorem, a AiHummer łączy się z nim jako kanałem.** Agent pojawia się w MAX jako bot: odbiera wiadomości przychodzące, wykonuje normalną turę i odsyła odpowiedź z powrotem — tak jak Telegram i inne kanały.
MAX wysyła jako **Łącznik kanału marketplace** i jest zbudowany na **API bota MAX**. To nie jest usługa, którą tworzysz samodzielnie: instalujesz konektor z Marketplace dostępnego w produkcie i konfigurujesz go z poziomu interfejsu administracyjnego, jak każdy inny kanał.
## Zainstaluj z Marketplace
Otwórz w produkcie [Rynek](/pl/v1.0/marketplace/overview-tiers) i zainstaluj **MAX** moduł. Po zainstalowaniu kanał pojawia się w sekcji kanałów w interfejsie administracyjnym z identyfikatorem kanału `max` — użyj tego identyfikatora, gdy przypisujesz agenta lub filtrujesz rozmowy według źródła.
> [!NOTE]
> Kanał MAX wymaga aktywnego **Rozrusznik**, **Biznes** lub **Przedsiębiorstwo**
> licencja. W planie Community instalacja łącznika zwraca
> **HTTP 402 „wymagana aktualizacja”** (kod `plan_limit`) — zobacz
> [Licencjonowanie](/pl/v1.0/commercial/licensing).
## Skonfiguruj to z interfejsu administracyjnego
1. Utwórz bota MAX i uzyskaj jego token.
2. W interfejsie administracyjnym otwórz **MAX** ustawienia kanału.
3. Wklej token bota do **`MAX_BOT_TOKEN`** (tajny, wymagany).
4. Opcjonalnie ustaw podstawowy adres URL MAX Bot API w **`MAX_API_BASE`**. Domyślnie ustawia się na
`https://platform-api2.max.ru`, więc zazwyczaj możesz to pozostawić puste.
5. Zapisz — łącze zaczyna odbierać i wysyłać wiadomości.
> [!TIP]
> MAX to kanał zidentyfikowany dla AiHummera jako `max`. Użyj tego identyfikatora kanału, gdy ty
> wiązać agenta lub filtrować rozmowy według źródła.
## Co jest obsługiwane
Złącze MAX obejmuje podstawowe przepływy rozmów:
- **Wysyłaj i odbieraj wiadomości** pomiędzy agentem a użytkownikami MAX.
- **Długie oczekiwanie przychodzące** — łącznik pobiera nadchodzące aktualizacje (wzmianki,
odpowiedzi, media, wydarzenia interaktywne), więc nie jest wymagany żaden publiczny port przychodzący.
- **Odpowiedzi rodzimych użytkowników** do konkretnej wiadomości.
- **Podstawowe klawiatury inline** dla szybkich interaktywnych przycisków.
- **Media według URL** w wiadomościach wychodzących.
- **Usuń duplikaty według klucza**, więc ponowna dostawa nigdy nie powoduje duplikatu.
## Jak przepływają wiadomości
Każda przychodząca wiadomość MAX dociera do bramki tą samą ścieżką przychodzącą, co każdy inny kanał, zabezpieczona przez współdzielony **tajny klucz HMAC przychodzący**. Stamtąd silnik turn przetwarza go jak każdą inną wiadomość kanałową.
> [!NOTE]
> Bramka musi mieć skonfigurowane domyślne środowisko robocze do wysyłania przychodzących
> wiadomości.
## Dokąd dalej
- Porównaj z podobnym kanałem rozmów: [Telegram](/pl/v1.0/channels/telegram).
- Podczas instalowania złączy: [Rynek](/pl/v1.0/marketplace/overview-tiers).
- Dopiero zaczynasz? Zobacz [Szybki start](/pl/v1.0/getting-started/quickstart).
