Télégramme — AiHummer Docs

Telegram est le canal recommandé de première intention de production d’AiHummer. C’est le moyen le plus rapide de mettre un agent fonctionnel devant de vraies personnes : créer un bot avec @BotFather, donnez le jeton au connecteur, et les messages entrants commencent à affluer vers la passerelle.

Le connecteur Telegram est installé depuis le produit Marché et configuré dans l’interface d’administration. Il fonctionne de manière native sur l’hôte et communique avec la passerelle via l’API entrante, ce qui lui permet de se dimensionner et de redémarrer indépendamment du moteur de tour.

Connectez Telegram en 6 étapes

Voici le parcours complet de zéro jusqu’à un bot qui vous répond sur Telegram. Tout ce dont vous avez besoin est un compte Telegram et l’accès à votre interface d’administration web AiHummer.

Créez un bot avec BotFather. Ouvrir dans Telegram @BotFather, envoyer /newbot, et définissez le nom du bot et nom d’utilisateur. Ce que vous verrez : BotFather renvoie un jeton aimer 123456789:AA… — Ceci est la clé d’accès du bot, copiez-la.
Installez le connecteur Telegram. Ouvrir dans l’interface d’administration Plugins/Marché, trouvez le connecteur Telegram dans le catalogue et cliquez sur “Installer”. Attendez que la carte devienne “en ligne” (une installation la barre de progression est affichée).
Collez le jeton. Aller à la Chaînes écran → le Configurer les chaînes installées bloquer, ouvrir la carte Telegram et coller le jeton de bot dans le champ depuis le formulaire du connecteur. Enregistrer.
Créer un agent (si vous n’en avez pas encore) — voir Agents: un nom et une invite système suffisent.
Liez l’agent au canal. Sur le Chaînes écran, dans le Liens bloc, choisir un agent par défaut pour Telegram — le règle « les nouvelles conversations Telegram sont gérées par l’agent Y ». Le choix est enregistré instantanément.
Envoyez un message au bot. Ouvrez votre bot sur Telegram et envoyez-lui un message. Quoi vous verrez : l’agent répond dans le chat, et la conversation correspondante apparaît sur l’écran « Sessions » dans l’interface d’administration.

[!NOTE] Par défaut, l’agent répond utilisateurs connus uniquement (personnes inscrites dans AiHummer). Si le bot reste silencieux sur votre message — ajoutez-vous simplement en tant que utilisateur d’instance, ou désactivez « Répondre uniquement aux utilisateurs connus » sur le Chaînes écran.

Pourquoi commencer avec Telegram

Telegram a le moindre frottement de tous les canaux AiHummer : pas d’opérateur, pas d’écran de consentement OAuth, pas de revue d’application. Un jeton de bot suffit pour envoyer et recevoir des messages, et le même connecteur couvre à la fois les discussions internes du personnel et les bots destinés aux clients. Comme il est de qualité production et entièrement éprouvé, c’est le canal que nous recommandons de brancher en premier lorsque vous évaluez AiHummer.

Sondage ou webhook

Le connecteur prend en charge les deux modes d’ingestion, il fonctionne donc que votre passerelle soit accessible ou non depuis Internet public.

Long polling — le connecteur récupère les mises à jour de Telegram. Aucun port entrant ou TLS est requis, ce qui le rend idéal pour le développement local et privé réseaux.
Webhook — Telegram envoie des mises à jour à une URL HTTPS publique. Latence plus faible et mieux adapté à la production derrière un proxy inverse qui termine TLS.

Le connecteur écoute sur port 8800 dans un déploiement normal, ou 8091 pour une exécution locale. Chaque message entrant est publié sur l’URL de la passerelle configurée dans AIHUMMER_INBOUND_URL, authentifié avec le secret partagé entrant.

Messages enrichis, réactions aux messages et sondages

Au-delà du texte brut, le canal Telegram rend Messages enrichis — réponses formatées qui mappent la sortie structurée d’un agent sur les fonctionnalités natives de messagerie de Telegram. Il prend également en charge réactions aux messages et sondages, afin qu’un agent puisse réagir au message d’un utilisateur ou insérer un sondage rapide dans un chat dans le cadre d’un tour.

[!TIP] Telegram est le canal identifié à AiHummer comme telegram. Utilise ce canal identifiant lorsque vous liez un agent ou filtrez les conversations par source.

Bot-à-bot avec un garde-boucle

Les agents peuvent parler à d’autres bots. Pour que cela soit sûr, le connecteur fournit un garde de boucle: il détecte et interrompt les échanges incontrôlés entre bots avant qu’ils ne se transforment en un ping-pong infini. Cela vous permet de composer des flux de travail multi-bots sans le mode d’échec classique des boucles de rétroaction.

Courtage secret sur OIDC

Le jeton du bot et les autres secrets du connecteur ne sont jamais codés en dur dans le service. Au lieu de cela, le connecteur les récupère à l’exécution depuis un Service des secrets sur OIDC — il s’authentifie, puis récupère les informations d’identification dont il a besoin. Les secrets restent dans le coffre-fort chiffré et hors des fichiers de configuration et des arguments de processus.

[!NOTE] Les messages entrants sont publiés sur AIHUMMER_INBOUND_URL et sécurisé par le secret HMAC entrant partagé (AIHUMMER_INBOUND_SECRET). La passerelle doit avoir une Espace de travail par défaut configuré pour les dispatcher.

Si cela n’a pas fonctionné

Le connecteur Telegram n’est pas sur l’écran “Canaux” — installez-le d’abord sur le Plugins/Marché écran ; jusqu’à ce qu’il soit installé le canal n’est pas affiché. Sur le plan Communauté, seul Telegram est disponible ; le reste a besoin d’une mise à jour (HTTP 402).
Le bot ne répond pas — vérifier : (1) le jeton est collé correctement et le La carte Telegram est « en ligne » ; (2) le canal est lié à un agent dans « Liaisons » ; (3) l’expéditeur est enregistré dans le système (par défaut, l’agent répond uniquement utilisateurs connus).
Les réponses semblent être des modèles — le modèle fictif est probablement encore actif ; connectez un fournisseur sur le Modèles page.
“Non autorisé” / jeton rejeté — le jeton est incorrect ou révoqué ; générez un nouveau avec @BotFather (/token) et collez-le à nouveau.
Le webhook n’arrive pas — en mode webhook, la passerelle doit être accessible à une URL HTTPS publique ; sur un réseau privé, utilisez le long polling, qui ne nécessite aucun trafic entrant port ou TLS.

Où aller ensuite

Comparer les chaînes dans le MAX, Bitrix24 et Téléphonie SIP guides.
Configurations des liaisons et accès — Chaînes.
Pour les sources non liées au chat, voir Entrant générique.
Construire contre l’API ? Voir chat/complétions.