AiHummer
Français
ConnexionCompte
v1.0.x
{ }Swagger

MAX

v1.0.x · mis à jour 2026-07-05

MAX est un messager russe, et AiHummer s’y connecte comme canal. L’agent apparaît dans MAX en tant que bot : il reçoit les messages entrants, exécute un tour normal et renvoie la réponse — tout comme Telegram et les autres canaux.

MAX expédie en tant que Connecteur de canal de place de marché et est construit sur le API du Bot MAX. Ce n’est pas un service que vous construisez vous-même : vous installez le connecteur depuis le Marketplace intégré au produit et vous le configurez depuis l’interface d’administration, comme n’importe quel autre canal.

Installer depuis la place de marché

Ouvrir dans le produit Marché et installer le MAX module. Une fois installé, le canal apparaît dans la section des canaux de l’interface d’administration avec l’identifiant du canal max — utilisez cet identifiant lorsque vous liez un agent ou filtrez les conversations par source.

[!NOTE] Le canal MAX nécessite un actif Démarreur, Affaires ou Entreprise licence. Sur le plan Communauté, l’installation du connecteur renvoie HTTP 402 « mise à niveau requise » (code plan_limit) — voir Licence.

Configurez-le depuis l’interface d’administration

  1. Créez un bot MAX et obtenez son jeton.
  2. Dans l’interface d’administration, ouvrez le MAX paramètres du canal.
  3. Collez le jeton du bot dans MAX_BOT_TOKEN (un secret, requis).
  4. Définissez éventuellement l’URL de base de l’API Bot MAX dans MAX_API_BASE. Il est réglé par défaut sur https://platform-api2.max.ru, donc vous pouvez généralement laisser ceci vide.
  5. Enregistrer — le connecteur commence à recevoir et à envoyer des messages.

[!TIP] MAX est le canal identifié à AiHummer comme max. Utilisez cet identifiant de chaîne lorsque vous lier un agent ou filtrer les conversations par source.

Qu’est-ce qui est pris en charge

Le connecteur MAX couvre les principaux flux de conversation :

  • Envoyer et recevoir des messages entre l’agent et les utilisateurs de MAX.
  • Longue attente entrante — le connecteur récupère les mises à jour entrantes (mentions, réponses, médias, événements interactifs), donc aucun port public entrant n’est requis.
  • Réponses natives à un message spécifique.
  • Claviers en ligne de base pour des boutons interactifs rapides.
  • Média-par-URL dans les messages sortants.
  • Dédupliquer par clé, donc une livraison réessayée ne produit jamais de doublon.

Comment les messages circulent

Chaque message MAX entrant atteint la passerelle par le même chemin entrant que tous les autres canaux, sécurisé par le partagé secret HMAC entrant. À partir de là, le moteur de rotation le traite comme tout autre message de canal.

[!NOTE] La passerelle doit avoir un espace de travail par défaut configuré pour acheminer les entrées messages.

Où aller ensuite