Bitrix24
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.
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.
Une identité d’agent semblable à un humain
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.
Ports et environnement d’exécution
| Port | Rôle |
|---|---|
| 8810 | Service du connecteur sur loopback : état et Deliver |
Comment les messages circulent
- 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çoitmedia_id, pas seulement une URL ou des métadonnées. - Sortie :
Deliverconvertit Markdown en BB-code et téléverse les octets réels viaim.v2.File.upload. La confirmation des médias exige de vraisFILE_IDet 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.
Qu’est-ce qui est pris en charge
- Réactions et @-mentions.
- Indicateur de saisie et réponses si le compte et le fournisseur prennent en charge
im.dialog.writingetREPLY_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.
[!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.
Où aller ensuite
- Lors de l’installation des connecteurs : Marché.
- Pour les claviers interactifs et les sondages, utilisez Télégramme ou MAX.
- Voir l’API d’ingestion sous-jacente dans Entrant générique.