Plugin Bitrix24

v1.2.x · mis à jour 2026-10-14

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.

Les médias et l’OAuth partagé décrits ci-dessous nécessitent Core 1.4.15 signé et le connecteur 1.1.1 signé séparément, après publication dans le catalogue et mise à jour. Un connecteur 1.1.0 installé ne confirme pas ces fonctions.

Faits

Champ	Valeur
Version	1.1.1
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.

Configurez les utilisateurs dédiés du portail dans BITRIX24_AGENT_USER_IDS et le portail dans BITRIX24_PORTAL. Le routage par département limite l’accès des employés ; le compte de l’agent ne remplace pas la personne à l’origine de la tâche. Le provisionnement automatique existant, facultatif, utilise BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Avec les versions indiquées, BITRIX24_VAULT_CONNECTIONS sélectionne un identifiant OAuth existant, valide, autonome et détenu par son propriétaire. Utilisez la gestion native prise en charge du coffre/des connexions ; réutilisez son ID dans les liaisons des outils. Le propriétaire réel enregistre le connecteur en cours d’exécution dans son espace de travail via /v1/admin/connections/channel avec une clé dédiée connection-token. Placez endpoint et apiKey par ID d’utilisateur de l’agent dans le réglage secret BITRIX24_VAULT_CONNECTIONS, jamais dans ses profils ou instructions. Seul le coffre renouvelle les jetons ; les outils conservent les contrôles de l’acteur et du partage. Voir OAuth2.

Comment il est utilisé

Entrée : le sondage lit les messages. Les médias sont téléchargés en octets et enregistrés via /v1/inbound/media ; l’agent reçoit media_id, pas seulement une URL ou des métadonnées.
Sortie : Deliver convertit Markdown en BB-code et téléverse les octets réels via im.v2.File.upload. La confirmation des médias exige de vrais FILE_ID et ID de messages ; un texte ou un lien n’est pas un reçu de fichier.

Conservez le journal durable des livraisons lors des mises à jour. La répétition d’une opération confirmée renvoie son reçu précédent. Les effets partiels ou inconnus ne sont pas renvoyés automatiquement ; vérifiez-les avant de réessayer.

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

Fonctionnalités prises en charge

Réactions et @-mentions.
Indicateur de saisie et réponses si le compte et le fournisseur prennent en charge im.dialog.writing et REPLY_ID.
Images, audio, voix et fichiers entrants, selon les exigences de version ci-dessus.
Modification/suppression des messages uniquement pour les anciennes intégrations avec une identité de bot distincte ; elles ne sont pas annoncées pour les utilisateurs OAuth ordinaires.

Limites

[!WARNING] Les claviers interactifs, boutons et fils de discussion ne sont pas pris en charge.

Un fichier généré ou préparé ne confirme pas sa livraison. Les résultats partiels, échoués et inconnus doivent rester visibles.

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.
Hôte-natif — fonctionne sous systemd, pas dans un conteneur.