Bitrix24
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.
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.
Una identidad de agente similar a un humano
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.
Puertos y tiempo de ejecución
| Puerto | Finalidad |
|---|---|
| 8810 | Servicio del conector en loopback: estado y Deliver |
Cómo fluyen los mensajes
- Entrada: el sondeo lee mensajes. Los medios se descargan como bytes y se registran mediante
/v1/inbound/media; el agente recibemedia_id, no solo una URL o metadatos. - Salida:
Deliverconvierte Markdown a BB-code y carga bytes reales medianteim.v2.File.upload. La confirmación de medios necesitaFILE_IDe 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.
Qué se admite
- Reacciones y @-menciones.
- Indicadores de escritura y respuestas cuando la cuenta y el proveedor admiten
im.dialog.writingyREPLY_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.
[!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.
¿A dónde vamos ahora?
- Sobre la instalación de conectores: Mercado.
- Para teclados interactivos y encuestas, utiliza Telegram o MÁX.
- Vea la API de ingestión subyacente en Genérico entrante.