Plugin de Bitrix24

v1.4.x · actualizada 2026-10-14

El complemento de Bitrix24 conecta a su agente con Bitrix24 como un canal de mensajería instantánea interno para empleados. El personal envía mensajes al agente de la misma manera en que lo haría con un colega, y el agente responde dentro del chat de Bitrix24.

[!WARNING] Bitrix24 aquí está un canal de mensajería interna para empleados — como Telegram o Slack para el personal. Es no cliente omnicanal: no hay Líneas Abiertas, no cola de tickets y sin escalamiento a operador. No uses este complemento para encabezar un línea de atención al cliente.

El complemento se ejecuta de forma nativa en el host y se comunica con la puerta de enlace a través de la aihummer.connector.v1 contrato. El comportamiento del canal del usuario final está en la página del canal Bitrix24; esta página cubre el propio complemento.

Los medios y el OAuth compartido descritos abajo requieren Core 1.4.15 firmado y el conector 1.1.1 firmado por separado, tras su publicación en el catálogo y actualización. Un conector 1.1.0 instalado no confirma estas funciones.

Hechos

Campo	Valor
Versión	1.1.1
Puerto	8810
Tiempo de ejecución	anfitrión-nativo

Qué es

Un puente bidireccional entre el chat de Bitrix24 y AiHummer. El agente aparece como un identidad similar a la humana en Bitrix24 — cada agente se autentica con su propia identidad OAuth en lugar de una cuenta de bot genérica — por lo que las conversaciones se sienten como hablar con un colega. El acceso sigue las políticas de la organización ACL del árbol de departamentos, por lo que el alcance de un agente respeta la estructura de tu Bitrix24.

Configure usuarios dedicados del portal en BITRIX24_AGENT_USER_IDS y el portal en BITRIX24_PORTAL. El enrutamiento por departamentos limita el acceso de empleados; la cuenta del agente no sustituye al iniciador de la tarea. El aprovisionamiento automático existente, opcional, usa BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD.

Con las versiones indicadas, BITRIX24_VAULT_CONNECTIONS selecciona una credencial OAuth existente, vigente, autónoma y propiedad de su titular. Use la gestión nativa admitida de la bóveda/conexiones; reutilice su ID de credencial en las vinculaciones de herramientas. El titular real registra el conector en ejecución en su espacio de trabajo mediante /v1/admin/connections/channel con una clave dedicada connection-token. Configure endpoint y apiKey por ID del usuario agente dentro del ajuste secreto BITRIX24_VAULT_CONNECTIONS; nunca en perfiles ni instrucciones del agente. Solo la bóveda renueva tokens; las herramientas mantienen las comprobaciones del actor y del acceso compartido. Consulte OAuth2.

Cómo se usa

Entrada: el sondeo lee mensajes. Los medios se descargan como bytes y se registran mediante /v1/inbound/media; el agente recibe media_id, no solo una URL o metadatos.
Salida: Deliver convierte Markdown a BB-code y carga bytes reales mediante im.v2.File.upload. La confirmación de medios necesita FILE_ID e ID de mensaje reales; un texto o enlace no es un comprobante del archivo.

Conserve el registro persistente de entrega al actualizar. Una operación confirmada repetida devuelve el comprobante anterior. Los efectos parciales o desconocidos no se reenvían automáticamente; compruébelos antes de reintentar.

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

Funciones compatibles

Reacciones y @-menciones.
Indicadores de escritura y respuestas cuando la cuenta y el proveedor admiten im.dialog.writing y REPLY_ID.
Imágenes, audio, voz y archivos entrantes, con los requisitos de versión indicados.
Edición/eliminación de mensajes solo en integraciones antiguas con una identidad de bot separada; no se anuncian para usuarios OAuth normales.

Límites

[!WARNING] No se admiten teclados interactivos, botones ni hilos.

Un archivo generado o preparado no confirma la entrega. Los resultados parciales, fallidos y desconocidos deben permanecer visibles.

Instalación

Instala Bitrix24 con un solo clic desde el marketplace en la interfaz de administración. El desplegador nativo del host descarga el complemento, ejecuta su paso de instalación, genera una unidad systemd en un entorno aislado y espera a que esté saludable antes de marcarlo como listo — ver Instalar y actualizar. Luego conectas la identidad OAuth de cada agente y mapeas el ACL del árbol de departamentos.

Seguridad y límites

Solo mensajes instantáneos internos para empleados — no omnicanal para clientes.
Identidad OAuth per-agente similar a la humana — los agentes no son cuentas de bot genéricas.
ACL de árbol de departamento — llega a respetar tu estructura organizativa.
Nativo del host — se ejecuta bajo systemd, no en un contenedor.