Plugin de Bitrix24
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.
Hechos
| Campo | Valor |
|---|---|
| Versión | 1.0.0 |
| 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.
Además de las identidades OAuth, se admiten otros métodos de aprovisionamiento: creación automática de cuentas de agente a través de un inicio de sesión de administrador del portal (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) y vinculación a usuarios de Bitrix24 pre-creados mediante IDs fijos (BITRIX24_AGENT_USER_IDS).
Cómo se usa
- Entrante: un recolector por extracción recoge nuevos mensajes y los reenvía a punto de entrada genérico de entrada del gateway, donde el enrutador resuelve el agente de destino.
- Saliente: las respuestas se envían a través del idempotente del conector Entregar paso, que convierte el Markdown del agente en Bitrix24 Código BB y garantiza que un mensaje no se envíe dos veces.
employee ─▶ Bitrix24 chat ─▶ pull poller ─▶ gateway (router · turn) ─▶ Deliver (Markdown→BB-code, idempotent) ─▶ Bitrix24Funciones compatibles
El complemento admite un comportamiento de chat rico y similar al humano:
- reacciones
- editar y eliminar mensaje
- indicadores de escritura
- @-menciones
- media
Límites
[!WARNING] El modelo similar a un humano lo hace intencionalmente no incluir algún bot de Bitrix24 características:
- Sin teclados / botones interactivos y sin hilos.
- Los medios y la voz entrantes no se reenvían — entrante es solo texto. A La identidad de estilo colega recibe y responde a textos; archivos adjuntos y voz las notas enviadas al agente no se transmiten en una intervención.
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.
- Entrega idempotente — Markdown se convierte en código BB y nunca se envía dos veces.
- Solo texto entrante; sin teclados/hilos.
- Nativo del host — se ejecuta bajo systemd, no en un contenedor.