Plugin Bitrix24

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

Le plugin Bitrix24 connecte votre agent à Bitrix24 en tant que canal de messagerie instantanée interne pour les employés. Le personnel envoie un message à l’agent de la même manière qu’il enverrait un message à un collègue, et l’agent répond dans le chat de Bitrix24.

[!WARNING] Bitrix24 ici est un canal de messagerie interne pour les employés — comme Telegram ou Slack pour le personnel. C’est pas client omnicanal : il n’y a pas de lignes ouvertes, non file d’attente de tickets et aucune escalade par un opérateur. N’utilisez pas ce plugin pour faire face à ligne de support client.

Le plugin s’exécute nativement sur l’hôte et communique avec la passerelle via le aihummer.connector.v1 contrat. Le comportement du canal de l’utilisateur final se trouve sur la page du canal Bitrix24; cette page couvre le plugin lui-même.

Faits

Champ	Valeur
Version	1.0.0
Port	8810
Exécution	hôte-natif

Ce que c’est

Un pont bidirectionnel entre le chat Bitrix24 et AiHummer. L’agent apparaît comme un identité humaine dans Bitrix24 — chaque agent s’authentifie avec sa propre identité OAuth plutôt qu’avec un compte bot générique — donc les conversations donnent l’impression de parler à un collègue. L’accès suit celui de l’organisation ACL de l’arborescence des départements, donc la portée d’un agent respecte votre structure Bitrix24.

En plus des identités OAuth, d’autres chemins de provisionnement sont pris en charge : création automatique de comptes d’agent via une connexion d’administrateur du portail (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) et liaison aux utilisateurs Bitrix24 pré-créés par des identifiants fixes (BITRIX24_AGENT_USER_IDS).

Comment il est utilisé

Entrant : un récupérateur par tirage récupère de nouveaux messages et les transfère vers le point de terminaison entrant générique de la passerelle, où le routeur résout l’agent cible.
Sortant : les réponses sont envoyées via l’idempotent du connecteur Livrer étape, qui convertit le Markdown de l’agent en Bitrix24 BB-code et garantit qu’un message n’est pas envoyé deux fois.

employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24

Fonctionnalités prises en charge

Le plugin prend en charge un comportement de chat riche et semblable à celui des humains :

réactions
modifier et supprimer le message
indicateurs de saisie
@-mentions
média

Limites

[!WARNING] Le modèle semblable à un humain agit intentionnellement pas inclure un certain bot Bitrix24 caractéristiques :

Pas de claviers / boutons interactifs et pas de fils.

Les médias entrants et la voix ne sont pas transférés — entrant est texte seul. A l’identité de type collègue reçoit et répond aux textes ; pièces jointes et voix les notes envoyées à l’agent ne sont pas transmises dans un tour.

Installation

Installez Bitrix24 en un clic depuis le marketplace dans l’interface d’administration. Le déployeur natif de l’hôte télécharge le plugin, exécute son étape d’installation, génère une unité systemd en bac à sable et attend que le système soit opérationnel avant de le marquer comme prêt — voir Installation et mises à jour. Vous connectez ensuite l’identité OAuth de chaque agent et mappez l’ACL de l’arborescence des départements.

Sécurité et limites

Messagerie instantanée interne pour les employés seulement — pas omnicanal pour le client.
Identité OAuth par agent semblable à celle d’un humain — les agents ne sont pas des comptes bot génériques.
ACL de l’arborescence du département — Reach respecte la structure de votre organisation.
Livraison idempotente — Le Markdown est rendu en code BB et n’est jamais envoyé deux fois.
Entrée uniquement texte ; pas de claviers/fils.
Hôte-natif — fonctionne sous systemd, pas dans un conteneur.