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

Bitrix24

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

Bitrix24 est un canal de messagerie instantanée interne pour les employés — le même rôle que Telegram ou Slack joue pour le personnel. Un agent AiHummer apparaît à l’intérieur du Bitrix24 de votre entreprise en tant que collègue que les employés peuvent contacter et mentionner.

Le canal expédie en tant que connecteur depuis le produit intégré Marché et fonctionne nativement sur l’hôte. Il est configuré depuis l’interface d’administration, comme tout autre canal.

[!NOTE] Le canal Bitrix24 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.

[!WARNING] Bitrix24 ici est strictement un canal de messagerie interne pour les employés. C’est pas client omnicanal pas Bitrix24 Lignes Ouvertes, pas une file d’attente pour les billets, et pas une surface d’escalade opérateur. Ne l’utilisez pas pour acheminer des éléments externes conversations avec les clients.

Une identité d’agent semblable à un humain

Chaque agent se connecte avec le sien identité OAuth semblable à celle d’un humain, de sorte qu’il apparaisse dans Bitrix24 comme une personne distincte plutôt que comme un bot d’intégration générique. La visibilité respecte votre structure organisationnelle grâce à un ACL de l’arborescence des départements — un agent ne voit et ne participe que là où son identité est autorisée, suivant la même hiérarchie de département que vos employés.

Outre les identités OAuth, le connecteur prend également en charge d’autres voies de provisionnement : comptes d’agents d’auto-approvisionnement via une connexion administrateur du portail (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) et liaison à utilisateurs Bitrix24 pré-créés par identifiants fixes (BITRIX24_AGENT_USER_IDS).

Ports et environnement d’exécution

Le connecteur écoute sur un seul port :

Port But
8810 Service de connecteur (santé, le point de terminaison Deliver et le consentement OAuth)

Comment les messages circulent

Bitrix24 ne pousse pas les événements entrants vers AiHummer ; le connecteur pulls eux.

  • Entrant — un extracteur de messages lit les nouveaux messages et les publie sur la passerelle à /v1/inbound/generic.
  • Sortant — les réponses sont transmises via le aihummer.connector.v1 Livrer contrat. Agent Markdown est converti en code BB Bitrix24, et la livraison est idempotente, donc un renvoi réessayé ne produit jamais de doublon message.

Qu’est-ce qui est pris en charge

La chaîne couvre les interactions qui correspondent à une identité d’employé semblable à celle d’un humain :

  • Réactions, message modifier et supprimer.
  • Taper indicateurs.
  • @-mentions.
  • Média dans les messages sortants.

[!WARNING] Certain fonctionnalités de style Telegram sont intentionnelles pas pris en charge dans le modèle semblable à l’humain :

  • Pas de claviers ou de boutons interactifs et pas de fils.
  • Les textos, médias et appels entrants sont transférés — images, audio, voix et fichiers.

Planifiez les flux d’agents autour de l’interaction basée sur le texte sur ce canal.

Où aller ensuite