MAX ist ein russischer Messenger, und AiHummer verbindet sich mit ihm als Kanal. Der Agent erscheint in MAX als Bot: Er empfängt eingehende Nachrichten, führt einen normalen Durchlauf aus und sendet die Antwort zurück – genau wie Telegram und die anderen Kanäle.
MAX wird versendet als Marktplatz-Kanalverbinder und ist aufgebaut auf dem MAX Bot API. Es ist kein Service, den man selbst erstellt: Sie installieren den Connector aus dem In-Produkt-Marktplatz und konfigurieren ihn über die Admin-Oberfläche, wie jeden anderen Kanal auch.
Aus dem Marketplace installieren
Öffnen Sie das In-Produkt Marktplatz und installieren Sie die MAX Modul. Nach der Installation wird der Kanal im Abschnitt Kanäle der Admin-Benutzeroberfläche mit der Kanal-ID angezeigt max — Verwenden Sie diese ID, wenn Sie einen Agenten binden oder Gespräche nach Quelle filtern.
[!NOTE]
Der MAX-Kanal erfordert einen aktiven Anlasser, Geschäft oder Unternehmen
Lizenz. Im Community-Plan liefert die Installation des Connectors
HTTP 402 „Upgrade erforderlich“ (Code plan_limit) — siehe
Lizenzierung.
Richten Sie es über die Admin-Benutzeroberfläche ein
Erstelle einen MAX-Bot und erhalte dessen Token.
Öffnen Sie in der Admin-Benutzeroberfläche die MAX Kanal-Einstellungen.
Fügen Sie das Bot-Token ein MAX_BOT_TOKEN (ein Geheimnis, erforderlich).
Optional die MAX Bot API-Basis-URL festlegen in MAX_API_BASE. Es wird standardmäßig auf gesetzt
https://platform-api2.max.ru, also kannst du das meist leer lassen.
Speichern — der Anschluss beginnt, Nachrichten zu empfangen und zu senden.
[!TIP]
MAX ist der Kanal, der AiHummer als solcher identifiziert wurde max. Verwenden Sie diese Kanal-ID, wenn Sie
Einen Agenten binden oder Gespräche nach Quelle filtern.
Was wird unterstützt
Der MAX-Anschluss deckt die Kernkonversationsabläufe ab:
Nachrichten senden und empfangen zwischen dem Agenten und den MAX-Benutzern.
Lang-Poll eingehend — der Connector zieht eingehende Updates (Erwähnungen,
Antworten, Medien, interaktive Ereignisse), daher wird kein eingehender öffentlicher Port benötigt.
Eingeborene Antworten zu einer bestimmten Nachricht.
Einfache Inline-Tastaturen für schnelle interaktive Schaltflächen.
Medien-nach-URL in ausgehenden Nachrichten.
Nach Schlüssel duplizieren, sodass eine wiederholte Zustellung niemals ein Duplikat erzeugt.
Wie Nachrichten fließen
Jede eingehende MAX-Nachricht erreicht das Gateway über denselben eingehenden Pfad wie jeder andere Kanal, gesichert durch das gemeinsame Inbound-HMAC-Geheimnis. Von dort aus verarbeitet die Turn-Engine es wie jede andere Kanalnachricht.
[!NOTE]
Das Gateway muss einen standardmäßigen Arbeitsbereich konfiguriert haben, um eingehende Nachrichten zuzuordnen.
Nachrichten.
Wohin als Nächstes
Mit dem ähnlichen Chat-Kanal vergleichen: Telegram.
Gerade erst angefangen? Sieh dir die Schnellstart.
**MAX ist ein russischer Messenger, und AiHummer verbindet sich mit ihm als Kanal.** Der Agent erscheint in MAX als Bot: Er empfängt eingehende Nachrichten, führt einen normalen Durchlauf aus und sendet die Antwort zurück – genau wie Telegram und die anderen Kanäle.
MAX wird versendet als **Marktplatz-Kanalverbinder** und ist aufgebaut auf dem **MAX Bot API**. Es ist kein Service, den man selbst erstellt: Sie installieren den Connector aus dem In-Produkt-Marktplatz und konfigurieren ihn über die Admin-Oberfläche, wie jeden anderen Kanal auch.
## Aus dem Marketplace installieren
Öffnen Sie das In-Produkt [Marktplatz](/de/v1.0/marketplace/overview-tiers) und installieren Sie die **MAX** Modul. Nach der Installation wird der Kanal im Abschnitt Kanäle der Admin-Benutzeroberfläche mit der Kanal-ID angezeigt `max` — Verwenden Sie diese ID, wenn Sie einen Agenten binden oder Gespräche nach Quelle filtern.
> [!NOTE]
> Der MAX-Kanal erfordert einen aktiven **Anlasser**, **Geschäft** oder **Unternehmen**
> Lizenz. Im Community-Plan liefert die Installation des Connectors
> **HTTP 402 „Upgrade erforderlich“** (Code `plan_limit`) — siehe
> [Lizenzierung](/de/v1.0/commercial/licensing).
## Richten Sie es über die Admin-Benutzeroberfläche ein
1. Erstelle einen MAX-Bot und erhalte dessen Token.
2. Öffnen Sie in der Admin-Benutzeroberfläche die **MAX** Kanal-Einstellungen.
3. Fügen Sie das Bot-Token ein **`MAX_BOT_TOKEN`** (ein Geheimnis, erforderlich).
4. Optional die MAX Bot API-Basis-URL festlegen in **`MAX_API_BASE`**. Es wird standardmäßig auf gesetzt
`https://platform-api2.max.ru`, also kannst du das meist leer lassen.
5. Speichern — der Anschluss beginnt, Nachrichten zu empfangen und zu senden.
> [!TIP]
> MAX ist der Kanal, der AiHummer als solcher identifiziert wurde `max`. Verwenden Sie diese Kanal-ID, wenn Sie
> Einen Agenten binden oder Gespräche nach Quelle filtern.
## Was wird unterstützt
Der MAX-Anschluss deckt die Kernkonversationsabläufe ab:
- **Nachrichten senden und empfangen** zwischen dem Agenten und den MAX-Benutzern.
- **Lang-Poll eingehend** — der Connector zieht eingehende Updates (Erwähnungen,
Antworten, Medien, interaktive Ereignisse), daher wird kein eingehender öffentlicher Port benötigt.
- **Eingeborene Antworten** zu einer bestimmten Nachricht.
- **Einfache Inline-Tastaturen** für schnelle interaktive Schaltflächen.
- **Medien-nach-URL** in ausgehenden Nachrichten.
- **Nach Schlüssel duplizieren**, sodass eine wiederholte Zustellung niemals ein Duplikat erzeugt.
## Wie Nachrichten fließen
Jede eingehende MAX-Nachricht erreicht das Gateway über denselben eingehenden Pfad wie jeder andere Kanal, gesichert durch das gemeinsame **Inbound-HMAC-Geheimnis**. Von dort aus verarbeitet die Turn-Engine es wie jede andere Kanalnachricht.
> [!NOTE]
> Das Gateway muss einen standardmäßigen Arbeitsbereich konfiguriert haben, um eingehende Nachrichten zuzuordnen.
> Nachrichten.
## Wohin als Nächstes
- Mit dem ähnlichen Chat-Kanal vergleichen: [Telegram](/de/v1.0/channels/telegram).
- Zur Installation von Anschlüssen: [Marktplatz](/de/v1.0/marketplace/overview-tiers).
- Gerade erst angefangen? Sieh dir die [Schnellstart](/de/v1.0/getting-started/quickstart).