Bitrix24 es un canal interno de mensajería instantánea para empleados — el mismo rol que Telegram o Slack desempeñan para el personal. Un agente AiHummer aparece dentro de Bitrix24 de su empresa como un compañero con el que los empleados pueden enviar mensajes y mencionar.
El canal se envía como un conector del producto Mercado y se ejecuta de forma nativa en el host. Se configura desde la interfaz de administración, como cualquier otro canal.
[!NOTE]
El canal de Bitrix24 requiere un activo Arrancador, Negocios o
Empresa licencia. En el plan Comunitario, instalar el conector devuelve
HTTP 402 “actualización requerida” (código plan_limit) — ver
Licenciamiento.
[!WARNING]
Bitrix24 aquí es estrictamente un canal de mensajería interna para empleados. Es no
cliente omnicanal no Líneas abiertas de Bitrix24 no una cola de tickets, y
no una superficie de escalamiento de operador. No la utilice para enrutar externo
conversaciones con clientes.
Una identidad de agente similar a un humano
Cada agente se conecta con el suyo propio identidad OAuth similar a la humana, para que aparezca en Bitrix24 como una persona distinta en lugar de un bot de integración genérico. La visibilidad respeta la estructura de tu organización a través de un ACL del árbol de departamentos — un agente solo ve y participa donde se le permite según su identidad, siguiendo la misma jerarquía departamental que tus empleados.
Además de las identidades OAuth, el conector también admite otras vías de aprovisionamiento: cuentas de agentes de autoaprovisionamiento mediante un inicio de sesión de administrador del portal (BITRIX24_ADMIN_LOGIN / BITRIX24_ADMIN_PASSWORD) y unión a usuarios de Bitrix24 pre-creados por identificaciones fijas (BITRIX24_AGENT_USER_IDS).
Puertos y tiempo de ejecución
El conector escucha en un solo puerto:
Puerto
Propósito
8810
Servicio de conector (salud, el endpoint de Entrega y consentimiento de OAuth)
Cómo fluyen los mensajes
Bitrix24 no envía eventos entrantes a AiHummer; el conector tira ellos.
Entrante — un recolector de consultas lee los mensajes nuevos y los publica en la puerta de enlace en
/v1/inbound/generic.
Saliente — las respuestas se entregan a través de aihummer.connector.v1Entregar contrato. Agente Markdown se convierte en código BB de Bitrix24, y
la entrega es idempotente, por lo que un reenvío no produce nunca un duplicado
mensaje.
Qué se admite
El canal cubre las interacciones que encajan con una identidad de empleado similar a la humana:
Reacciones, mensaje editar y eliminar.
Escribiendo indicadores.
@-menciones.
Medios en mensajes salientes.
[!WARNING]
Algunas funciones al estilo de Telegram son intencionales no compatible con el
modelo similar al humano:
Sin teclados ni botones interactivos y sin hilos.
Los textos, medios y voz entrantes se reenvían — imágenes, audio, voz y archivos.
Planifica los flujos del agente alrededor de la interacción basada en texto en este canal.
**Bitrix24 es un canal interno de mensajería instantánea para empleados** — el mismo rol que Telegram o Slack desempeñan para el personal. Un agente AiHummer aparece dentro de Bitrix24 de su empresa como un compañero con el que los empleados pueden enviar mensajes y mencionar.
El canal se envía como un **conector del producto [Mercado](/es/v1.0/marketplace/overview-tiers)** y se ejecuta de forma nativa en el host. Se configura desde la interfaz de administración, como cualquier otro canal.
> [!NOTE]
> El canal de Bitrix24 requiere un activo **Arrancador**, **Negocios** o
> **Empresa** licencia. En el plan Comunitario, instalar el conector devuelve
> **HTTP 402 "actualización requerida"** (código `plan_limit`) — ver
> [Licenciamiento](/es/v1.0/commercial/licensing).
> [!WARNING]
> Bitrix24 aquí es estrictamente un **canal de mensajería interna para empleados**. Es **no**
> cliente omnicanal **no** Líneas abiertas de Bitrix24 **no** una cola de tickets, y
> **no** una superficie de escalamiento de operador. No la utilice para enrutar externo
> conversaciones con clientes.
## Una identidad de agente similar a un humano
Cada agente se conecta con el suyo propio **identidad OAuth similar a la humana**, para que aparezca en Bitrix24 como una persona distinta en lugar de un bot de integración genérico. La visibilidad respeta la estructura de tu organización a través de un **ACL del árbol de departamentos** — un agente solo ve y participa donde se le permite según su identidad, siguiendo la misma jerarquía departamental que tus empleados.
Además de las identidades OAuth, el conector también admite otras vías de aprovisionamiento: **cuentas de agentes de autoaprovisionamiento mediante un inicio de sesión de administrador del portal** (`BITRIX24_ADMIN_LOGIN` / `BITRIX24_ADMIN_PASSWORD`) y unión a **usuarios de Bitrix24 pre-creados por identificaciones fijas** (`BITRIX24_AGENT_USER_IDS`).
## Puertos y tiempo de ejecución
El conector escucha en un solo puerto:
| Puerto | Propósito |
|---|---|
| 8810 | Servicio de conector (salud, el endpoint de Entrega y consentimiento de OAuth) |
## Cómo fluyen los mensajes
Bitrix24 no envía eventos entrantes a AiHummer; el conector **tira** ellos.
- **Entrante** — un recolector de consultas lee los mensajes nuevos y los publica en la puerta de enlace en
`/v1/inbound/generic`.
- **Saliente** — las respuestas se entregan a través de `aihummer.connector.v1`
**Entregar** contrato. Agente **Markdown se convierte en código BB de Bitrix24**, y
la entrega es **idempotente**, por lo que un reenvío no produce nunca un duplicado
mensaje.
## Qué se admite
El canal cubre las interacciones que encajan con una identidad de empleado similar a la humana:
- Reacciones, mensaje **editar** y **eliminar**.
- **Escribiendo** indicadores.
- **@-menciones**.
- **Medios** en mensajes salientes.
> [!WARNING]
> Algunas funciones al estilo de Telegram son intencionales **no** compatible con el
> modelo similar al humano:
>
> - **Sin teclados ni botones interactivos** y **sin hilos**.
> - **Los textos, medios y voz entrantes se reenvían** — imágenes, audio, voz y archivos.
>
> Planifica los flujos del agente alrededor de la interacción basada en texto en este canal.
## ¿A dónde vamos ahora?
- Sobre la instalación de conectores: [Mercado](/es/v1.0/marketplace/overview-tiers).
- Para teclados interactivos y encuestas, utiliza [Telegram](/es/v1.0/channels/telegram)
o [MÁX](/es/v1.0/channels/max).
- Vea la API de ingestión subyacente en
[Genérico entrante](/es/v1.0/channels/generic-inbound).
