AiHummer
Română▾
AutentificareCont personal
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Canale/MAX

MAX

v1.0.x · actualizat 2026-07-05

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

  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?