AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Canale/MAX

MAX

v1.0.x · actualizat 2026-06-27

MAX este o mesagerie rusească, iar AiHummer se conectează la ea ca un canal. Agentul apare în MAX ca un bot: primește mesaje de intrare, rulează un tur normal și trimite răspunsul înapoi — la fel ca Telegram și celelalte canale.

MAX este livrat ca un conector de canal din Marketplace și este construit pe MAX Bot API. Nu este un serviciu pe care îl construiți singur: instalați conectorul din Marketplace-ul integrat în produs și îl configurați din interfața de administrare, ca orice alt canal.

Instalare din Marketplace

Deschideți Marketplace-ul integrat în produs și instalați modulul MAX. Odată instalat, canalul apare în secțiunea de canale a interfeței de administrare cu id-ul de canal max — folosiți acel id când legați un agent sau filtrați conversațiile după sursă.

Configurați-l din interfața de administrare

  1. Creați un bot MAX și obțineți token-ul său.
  2. În interfața de administrare, deschideți setările canalului MAX.
  3. Lipiți token-ul botului în MAX_BOT_TOKEN (un secret, necesar).
  4. Opțional, setați URL-ul de bază al MAX Bot API în MAX_API_BASE. Acesta are valoarea implicită https://platform-api2.max.ru, deci de obicei îl puteți lăsa necompletat.
  5. Salvați — conectorul începe să primească și să trimită mesaje.

[!TIP] MAX este canalul identificat în AiHummer ca max. Folosiți acel id de canal când legați un agent sau filtrați conversațiile după sursă.

Ce este acceptat

Conectorul MAX acoperă fluxurile de conversație de bază:

  • Trimiterea și primirea de mesaje între agent și utilizatorii MAX.
  • Intrare prin long-poll — conectorul trage actualizările primite (mențiuni, răspunsuri, media, evenimente interactive), deci nu este necesar niciun port public de intrare.
  • Răspunsuri native la un mesaj specific.
  • Tastaturi inline de bază pentru butoane interactive rapide.
  • Media-prin-URL în mesajele de ieșire.
  • Deduplicare după cheie, astfel încât o livrare reîncercată nu produce niciodată un duplicat.

Cum circulă mesajele

Fiecare mesaj MAX de intrare ajunge la gateway pe aceeași cale de intrare ca orice alt canal, securizat de secretul inbound-HMAC partajat. De acolo, motorul de tururi îl procesează ca pe orice alt mesaj de canal.

[!NOTE] Gateway-ul trebuie să aibă un spațiu de lucru implicit configurat pentru a expedia mesajele de intrare.

Unde mergem mai departe