> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Bitrix24
> Gestiona leads, contactos, empresas y calendario con el CRM de Bitrix24 desde Brain Studio.
**Bitrix24** es un CRM y plataforma de gestión empresarial todo en uno. En **Brain Studio**, esta integración permite que tus flujos y agentes gestionen leads, contactos, empresas y eventos de calendario directamente desde conversaciones.
## Qué habilita Bitrix24
Al conectar **Bitrix24**, puedes:
* **Capturar** leads desde conversaciones de WhatsApp u otros canales con datos enriquecidos
* **Consultar** contactos y empresas existentes para responder con contexto del CRM
* **Actualizar** el estado del pipeline según el avance real de cada conversación
* **Convertir** leads calificados en contactos y empresas sin ingreso manual
* **Agendar** reuniones de ventas directamente en el calendario de Bitrix24 desde el flujo
***
## Instalación
### Requisitos previos
1. Una **cuenta activa de Bitrix24**.
2. Un plan **pago** de Bitrix24 con acceso a **webhooks inbound**. En la cuenta gratuita este módulo no está disponible.
3. Permisos para crear o editar integraciones desde **Aplicaciones → Recursos para desarrolladores**.
### Cómo obtener credenciales
Para conectar **Bitrix24** en Brain Studio necesitas la **Webhook URL** de un **webhook entrante** con permisos sobre los módulos que usa esta integración.
En el menú lateral de Bitrix24, entra a **Aplicaciones**.
Dentro de **Aplicaciones**, abre **Recursos para desarrolladores**.
En la pantalla de recursos para desarrolladores, entra a la categoría **Otro**.
Haz clic en **Webhook entrante** para abrir la configuración del webhook que usarás en Brain Studio.
En la parte superior verás el campo **Webhook para llamar a la API REST**. Copia esa URL completa.
Esta URL permite ejecutar acciones en Bitrix24 con los permisos asignados al webhook. Guárdala como una credencial sensible y no la expongas en código público ni en canales compartidos.
En la sección **Asignar permisos**, selecciona estos permisos:
* **CRM (`crm`)**
* **Calendario (`calendar`)**
Con estos permisos puedes usar las tools de **leads, contactos, empresas, eventos y secciones de calendario** disponibles en Brain Studio.
Haz clic en **Guardar** para dejar activo el webhook con los permisos seleccionados.
### Cómo conectarla
La forma más directa es usar [**Jelou Agent**](/guides/getting-started/jelou-agent): describe lo que necesitas y el agente conecta **Bitrix24** automáticamente dentro del flujo.
Si prefieres instalar manualmente, abre el **Marketplace** y sigue estos pasos con la Webhook URL que obtuviste en el paso anterior.
En Brain Studio, abre **Marketplace** desde el menú lateral.
Encuentra la integración y haz clic en **Conectar**.
Completa el formulario con tu **Webhook URL** de Bitrix24.
La integración aparecerá como **conectada**.
Puedes usarla en **Canvas** o agregarla como herramienta en **AI Agent**.
***
## Tools disponibles
A alto nivel, las acciones se agrupan así:
* **Crear** — lead, contacto, empresa, evento de calendario, sección de calendario.
* **Consultar** — obtener y listar leads, contactos, empresas, eventos y secciones.
* **Actualizar** — lead, contacto, empresa, sección de calendario.
* **Eliminar** — lead, contacto, empresa, evento y sección de calendario.
La integración expone 23 tools en Brain Studio; a continuación, cada una con propósito, inputs y ejemplo.
Crea un nuevo lead en Bitrix24 CRM para capturar clientes potenciales u oportunidades de venta. Devuelve el **ID del lead** creado.
**Inputs:**
* **title** (string, requerido) — Título del lead.
* **name** (opcional, string) — Nombre del contacto.
* **last\_name** (opcional, string) — Apellido del contacto.
* **company\_title** (opcional, string) — Nombre de la empresa.
* **phone** (opcional, string) — Teléfono.
* **phone\_type** (opcional, string) — Tipo de teléfono (por defecto `"WORK"`).
* **email** (opcional, string) — Correo electrónico.
* **email\_type** (opcional, string) — Tipo de email (por defecto `"WORK"`).
* **status\_id** (opcional, string) — Estado del lead (ej. `"NEW"`, `"IN_PROCESS"`).
* **source\_id** (opcional, string) — Fuente del lead (ej. `"WEB"`, `"CALL"`).
* **opportunity** (opcional, string) — Monto estimado del negocio.
* **currency\_id** (opcional, string) — Código de moneda (ej. `"USD"`, `"EUR"`).
* **assigned\_by\_id** (opcional, string) — ID del usuario responsable.
* **comments** (opcional, string) — Comentarios adicionales.
**Ejemplo:**
```json theme={null}
{
"title": "Interesado en plan Enterprise",
"name": "Juan",
"last_name": "Pérez",
"phone": "+573001234567",
"email": "juan@empresa.com",
"source_id": "WEB",
"opportunity": "5000",
"currency_id": "USD"
}
```
Devuelve la información completa de un lead específico por su ID.
**Inputs:**
* **id** (string, requerido) — ID del lead.
**Ejemplo:**
```json theme={null}
{
"id": "42"
}
```
Lista leads del CRM con filtrado opcional. Devuelve resultados paginados.
**Inputs:**
* **status\_id** (opcional, string) — Filtrar por estado (ej. `"NEW"`, `"IN_PROCESS"`).
* **source\_id** (opcional, string) — Filtrar por fuente.
* **assigned\_by\_id** (opcional, string) — Filtrar por responsable.
* **start** (opcional, string) — Offset para paginación.
**Ejemplo:**
```json theme={null}
{
"status_id": "NEW",
"start": "0"
}
```
Actualiza la información de un lead existente. Solo se modifican los campos incluidos en la petición.
**Inputs:**
* **id** (string, requerido) — ID del lead a actualizar.
* **title** (opcional, string) — Nuevo título.
* **phone** (opcional, string) — Nuevo teléfono.
* **phone\_type** (opcional, string) — Tipo de teléfono (por defecto `"WORK"`).
* **email** (opcional, string) — Nuevo email.
* **email\_type** (opcional, string) — Tipo de email (por defecto `"WORK"`).
* **status\_id** (opcional, string) — Nuevo estado.
* **opportunity** (opcional, string) — Nuevo monto estimado.
* **comments** (opcional, string) — Nuevos comentarios.
**Ejemplo:**
```json theme={null}
{
"id": "42",
"status_id": "IN_PROCESS",
"opportunity": "8000"
}
```
Elimina un lead del CRM de forma permanente.
Esta acción no se puede deshacer.
**Inputs:**
* **id** (string, requerido) — ID del lead a eliminar.
**Ejemplo:**
```json theme={null}
{
"id": "42"
}
```
Crea un nuevo contacto en Bitrix24 CRM. Los contactos representan personas con las que haces negocios. Devuelve el **ID del contacto** creado.
**Inputs:**
* **name** (opcional, string) — Nombre.
* **last\_name** (opcional, string) — Apellido.
* **phone** (opcional, string) — Teléfono.
* **phone\_type** (opcional, string) — Tipo de teléfono (por defecto `"WORK"`).
* **email** (opcional, string) — Email.
* **email\_type** (opcional, string) — Tipo de email (por defecto `"WORK"`).
* **post** (opcional, string) — Cargo o posición.
* **company\_id** (opcional, string) — ID de la empresa asociada.
* **source\_id** (opcional, string) — Fuente del contacto.
* **assigned\_by\_id** (opcional, string) — ID del responsable.
* **comments** (opcional, string) — Comentarios.
**Ejemplo:**
```json theme={null}
{
"name": "María",
"last_name": "García",
"phone": "+573009876543",
"email": "maria@empresa.com",
"post": "Gerente de Compras",
"company_id": "10"
}
```
Devuelve la información completa de un contacto específico por su ID.
**Inputs:**
* **id** (string, requerido) — ID del contacto.
**Ejemplo:**
```json theme={null}
{
"id": "15"
}
```
Lista contactos del CRM con filtrado opcional. Devuelve resultados paginados.
**Inputs:**
* **company\_id** (opcional, string) — Filtrar por empresa.
* **source\_id** (opcional, string) — Filtrar por fuente.
* **assigned\_by\_id** (opcional, string) — Filtrar por responsable.
* **start** (opcional, string) — Offset para paginación.
**Ejemplo:**
```json theme={null}
{
"company_id": "10",
"start": "0"
}
```
Actualiza la información de un contacto existente. Solo se modifican los campos incluidos en la petición.
**Inputs:**
* **id** (string, requerido) — ID del contacto a actualizar.
* **name** (opcional, string) — Nombre.
* **last\_name** (opcional, string) — Apellido.
* **phone** (opcional, string) — Teléfono.
* **phone\_type** (opcional, string) — Tipo de teléfono (por defecto `"WORK"`).
* **email** (opcional, string) — Email.
* **email\_type** (opcional, string) — Tipo de email (por defecto `"WORK"`).
* **post** (opcional, string) — Cargo.
* **comments** (opcional, string) — Comentarios.
**Ejemplo:**
```json theme={null}
{
"id": "15",
"post": "Directora de Operaciones",
"phone": "+573001112233"
}
```
Elimina un contacto del CRM de forma permanente.
Esta acción no se puede deshacer.
**Inputs:**
* **id** (string, requerido) — ID del contacto a eliminar.
**Ejemplo:**
```json theme={null}
{
"id": "15"
}
```
Crea una nueva empresa en Bitrix24 CRM. Las empresas representan las organizaciones con las que haces negocios. Devuelve el **ID de la empresa** creada.
**Inputs:**
* **title** (string, requerido) — Nombre de la empresa.
* **company\_type** (opcional, string) — Tipo de empresa (ej. `"CUSTOMER"`, `"SUPPLIER"`).
* **industry** (opcional, string) — Código de industria.
* **phone** (opcional, string) — Teléfono.
* **phone\_type** (opcional, string) — Tipo de teléfono (por defecto `"WORK"`).
* **email** (opcional, string) — Email.
* **email\_type** (opcional, string) — Tipo de email (por defecto `"WORK"`).
* **web** (opcional, string) — Sitio web.
* **address** (opcional, string) — Dirección.
* **assigned\_by\_id** (opcional, string) — ID del responsable.
* **comments** (opcional, string) — Comentarios.
**Ejemplo:**
```json theme={null}
{
"title": "Empresa ABC S.A.",
"company_type": "CUSTOMER",
"phone": "+573001112233",
"email": "info@empresaabc.com",
"web": "https://empresaabc.com"
}
```
Devuelve la información completa de una empresa específica por su ID.
**Inputs:**
* **id** (string, requerido) — ID de la empresa.
**Ejemplo:**
```json theme={null}
{
"id": "8"
}
```
Lista empresas del CRM con filtrado opcional. Devuelve resultados paginados.
**Inputs:**
* **company\_type** (opcional, string) — Filtrar por tipo.
* **industry** (opcional, string) — Filtrar por industria.
* **assigned\_by\_id** (opcional, string) — Filtrar por responsable.
* **start** (opcional, string) — Offset para paginación.
**Ejemplo:**
```json theme={null}
{
"company_type": "CUSTOMER",
"start": "0"
}
```
Actualiza la información de una empresa existente. Solo se modifican los campos incluidos en la petición.
**Inputs:**
* **id** (string, requerido) — ID de la empresa a actualizar.
* **title** (opcional, string) — Nombre.
* **company\_type** (opcional, string) — Tipo.
* **industry** (opcional, string) — Industria.
* **phone** (opcional, string) — Teléfono.
* **phone\_type** (opcional, string) — Tipo de teléfono (por defecto `"WORK"`).
* **email** (opcional, string) — Email.
* **email\_type** (opcional, string) — Tipo de email (por defecto `"WORK"`).
* **address** (opcional, string) — Dirección.
* **comments** (opcional, string) — Comentarios.
**Ejemplo:**
```json theme={null}
{
"id": "8",
"address": "Calle 100 #15-20, Bogotá",
"company_type": "SUPPLIER"
}
```
Elimina una empresa del CRM de forma permanente.
Esta acción no se puede deshacer.
**Inputs:**
* **id** (string, requerido) — ID de la empresa a eliminar.
**Ejemplo:**
```json theme={null}
{
"id": "8"
}
```
Crea un nuevo evento en el calendario de Bitrix24. Devuelve el **ID del evento** creado.
**Inputs:**
* **name** (string, requerido) — Nombre del evento.
* **from** (string, requerido) — Fecha y hora de inicio (ISO 8601, ej. `"2025-06-15T10:00:00"`).
* **to** (string, requerido) — Fecha y hora de fin (ISO 8601).
* **section\_id** (string, requerido) — ID de la sección de calendario donde se crea el evento.
* **type** (opcional, string) — Tipo de calendario (ej. `"user"`, `"group"`, `"company"`).
* **owner\_id** (opcional, string) — ID del propietario del calendario.
* **description** (opcional, string) — Descripción del evento.
* **location** (opcional, string) — Ubicación.
* **importance** (opcional, string) — Importancia del evento (por defecto `"high"`).
* **accessibility** (opcional, string) — Estado de disponibilidad (por defecto `"busy"`).
* **is\_meeting** (opcional, string) — Indica si es una reunión con asistentes.
* **attendees** (opcional, array) — IDs de los usuarios asistentes.
**Ejemplo:**
```json theme={null}
{
"name": "Demo con cliente potencial",
"from": "2025-06-15T10:00:00",
"to": "2025-06-15T11:00:00",
"section_id": "3",
"location": "Sala de reuniones",
"importance": "high"
}
```
Devuelve la información completa de un evento de calendario específico por su ID.
**Inputs:**
* **id** (string, requerido) — ID del evento.
**Ejemplo:**
```json theme={null}
{
"id": "101"
}
```
Lista eventos del calendario con filtrado por rango de fechas y sección.
**Inputs:**
* **from** (opcional, string) — Fecha de inicio del rango (ISO 8601).
* **to** (opcional, string) — Fecha de fin del rango (ISO 8601).
* **type** (opcional, string) — Tipo de calendario (ej. `"user"`, `"group"`).
* **owner\_id** (opcional, string) — ID del propietario del calendario.
* **section** (opcional, array) — IDs de secciones a filtrar.
**Ejemplo:**
```json theme={null}
{
"from": "2025-06-01",
"to": "2025-06-30"
}
```
Elimina un evento del calendario de forma permanente.
Esta acción no se puede deshacer.
**Inputs:**
* **id** (string, requerido) — ID del evento a eliminar.
**Ejemplo:**
```json theme={null}
{
"id": "101"
}
```
Crea una nueva sección de calendario en Bitrix24. Devuelve el **ID de la sección** creada.
**Inputs:**
* **name** (string, requerido) — Nombre de la sección.
* **type** (opcional, string) — Tipo de calendario (por defecto `"user"`).
* **owner\_id** (opcional, string) — ID del propietario.
* **description** (opcional, string) — Descripción de la sección.
* **color** (opcional, string) — Color de fondo en formato hex (ej. `"#9cbeee"`).
* **text\_color** (opcional, string) — Color del texto en formato hex.
**Ejemplo:**
```json theme={null}
{
"name": "Reuniones con clientes",
"type": "user",
"color": "#5bc8e2",
"description": "Eventos de demos y seguimiento comercial"
}
```
Lista las secciones de calendario disponibles.
**Inputs:**
* **type** (opcional, string) — Tipo de calendario a consultar (ej. `"user"`, `"group"`).
* **owner\_id** (opcional, string) — ID del propietario del calendario.
**Ejemplo:**
```json theme={null}
{
"type": "user"
}
```
Actualiza la información de una sección de calendario existente. Solo se modifican los campos incluidos en la petición.
**Inputs:**
* **id** (string, requerido) — ID de la sección a actualizar.
* **name** (opcional, string) — Nuevo nombre.
* **type** (opcional, string) — Tipo de calendario (por defecto `"user"`).
* **owner\_id** (opcional, string) — ID del propietario.
* **description** (opcional, string) — Nueva descripción.
* **color** (opcional, string) — Nuevo color de fondo (hex).
* **text\_color** (opcional, string) — Nuevo color del texto (hex).
**Ejemplo:**
```json theme={null}
{
"id": "3",
"name": "Demos y seguimiento",
"color": "#f4c542"
}
```
Elimina una sección de calendario de forma permanente.
Esta acción eliminará todos los eventos de esta sección y no se puede deshacer.
**Inputs:**
* **id** (string, requerido) — ID de la sección a eliminar.
**Ejemplo:**
```json theme={null}
{
"id": "3"
}
```
***
## Cómo usar en Brain
Una vez conectada, puedes usar **Bitrix24** en dos superficies:
### En AI Agent
Ideal cuando el usuario quiere crear leads, actualizar contactos o consultar el CRM en lenguaje natural.
En el Canvas, selecciona o añade el nodo **AI Agent**.
En el panel derecho, entra a la pestaña **Herramientas**.
Usa **Agregar tool**, busca **Bitrix24** y actívala.
Elige integración completa o activa solo los módulos que necesites (CRM, calendario).
**Bitrix24** aparece en la lista de herramientas del agente y puedes abrir su configuración con el icono de ajustes.
El agente decidirá automáticamente cuándo crear un lead, consultar un contacto o registrar un evento según la conversación.
### En Canvas
Ideal cuando necesitas control total del flujo (por ejemplo: calificar lead → crear contacto → asignar responsable → notificar).
En el panel lateral, abre **Marketplace** y arrastra **Bitrix24** al flujo.
Con el nodo seleccionado, en **Tools** elige la acción (por ejemplo **Crear lead**).
Completa el JSON del cuerpo de la petición y, si aplica, **Guardar respuesta** en una variable de memoria.
Enlaza las salidas **Finalizó la tarea** y **Hubo un error** con los nodos siguientes.
El nodo queda listo para ejecutarse en el orden definido por tu flujo.
**Ejemplo de configuración:**
El editor del nodo muestra un cuerpo JSON alineado con la tool **Crear lead**. Los campos `title` y `phone` son los mínimos recomendados para identificar al prospecto.
```json theme={null}
{
"title": "Lead WhatsApp — {{$memory.nombre_cliente}}",
"name": "{{$memory.nombre_cliente}}",
"phone": "{{$memory.telefono}}",
"email": "{{$memory.email}}",
"source_id": "WEB",
"opportunity": "{{$memory.monto_estimado}}",
"currency_id": "USD"
}
```
***
## Casos de uso
El agente conduce una conversación de calificación y crea el lead en Bitrix24 con todos los datos relevantes capturados, sin que el prospecto haya hablado con ningún humano todavía.
**Flujo típico:**
* El prospecto inicia conversación por WhatsApp
* El agente recorre las preguntas de calificación: necesidad, presupuesto, plazo y autoridad
* Al completar la calificación, el flujo crea el lead con **Crear Lead** incluyendo nombre, empresa, monto estimado, fuente y comentarios con el resumen de la conversación
* Se asigna automáticamente al representante de ventas según los criterios del negocio
**Impacto:**
* El lead llega al CRM con contexto completo, no solo nombre y teléfono
* El equipo de ventas recibe prospectos pre-calificados listos para cerrar
* Reduce el riesgo de perder leads por olvido o ingreso tardío
**Ideal para:** inmobiliarias, seguros, educación y servicios financieros con captación de leads por WhatsApp
El agente mueve el lead por las etapas del pipeline de Bitrix24 a medida que detecta señales de avance en la conversación, sin que el ejecutivo tenga que actualizar el CRM manualmente.
**Flujo típico:**
* El prospecto muestra interés inicial → el flujo actualiza el lead a `IN_PROCESS` con **Actualizar Lead**
* El prospecto solicita una propuesta o demo → el flujo registra el avance en `status_id` y actualiza el monto estimado
* El prospecto confirma intención de compra → el flujo convierte el lead creando contacto con **Crear Contacto** y empresa con **Crear Empresa**
* El ejecutivo ve el pipeline actualizado en tiempo real en Bitrix24
**Impacto:**
* Pipeline siempre refleja el estado real sin depender de la disciplina del equipo
* El gerente de ventas tiene visibilidad precisa para pronosticar ingresos
**Ideal para:** equipos comerciales B2B con pipeline definido en Bitrix24 y alto volumen de conversaciones
Cuando un cliente conocido contacta por WhatsApp, el agente lo identifica en el CRM, recupera su información y responde con contexto: qué empresa representa, qué leads o negociaciones tiene activas, con quién trabaja en el equipo.
**Flujo típico:**
* El cliente envía un mensaje por WhatsApp
* El flujo busca en Bitrix24 por teléfono o email con **Listar Contactos**
* Si existe, obtiene los datos completos del contacto con **Obtener Contacto** y de su empresa con **Obtener Empresa**
* El agente responde con contexto personalizado o transfiere al ejecutivo asignado con el briefing listo
**Impacto:**
* El agente consulta el CRM antes de preguntar, evitando que el cliente repita información ya registrada
* El ejecutivo recibe la transferencia con contexto completo, no "alguien quiere hablar contigo"
* Experiencia de cliente notablemente más fluida en cuentas recurrentes
**Ideal para:** empresas B2B con cartera de clientes activa gestionada en Bitrix24
Cuando el lead supera el umbral de calificación, el flujo crea el contacto, la empresa y la primera reunión de ventas en Bitrix24 de forma encadenada, sin intervención manual.
**Flujo típico:**
* El agente detecta señal de cierre en la conversación (solicitud de propuesta, confirmación de presupuesto, etc.)
* El flujo crea el contacto con **Crear Contacto** y la empresa con **Crear Empresa**
* Propone horarios disponibles y al confirmar crea el evento con **Crear Evento** en el calendario del ejecutivo asignado
* El ejecutivo recibe notificación con el briefing del prospecto
**Impacto:**
* Elimina tres pasos manuales post-calificación: crear contacto, crear empresa y agendar reunión
* El tiempo entre calificación y primera reunión pasa de horas o días a minutos
**Ideal para:** empresas con ciclos de venta cortos o medianos donde la velocidad de respuesta es diferenciador
El ejecutivo de ventas consulta al agente antes de una reunión y recibe un resumen completo del cliente directamente en el chat, sin abrir Bitrix24.
**Flujo típico:**
* El ejecutivo pregunta al agente "¿qué sé del cliente de las 3pm?"
* El flujo consulta el evento con **Listar Eventos**, identifica al asistente y recupera su perfil con **Obtener Contacto** y **Obtener Empresa**
* Si hay leads activos asociados, los recupera con **Obtener Lead**
* Devuelve un resumen estructurado: empresa, cargo, historial de contacto, oportunidad activa y notas
**Impacto:**
* El ejecutivo llega a la reunión preparado sin invertir tiempo en navegar el CRM
* Reduce errores por confundir clientes o llegar sin contexto en equipos con muchas cuentas
**Ideal para:** equipos de ventas con agenda densa y múltiples cuentas activas en Bitrix24
***
## Integraciones que combinan bien con Bitrix24
Envía **follow-ups y confirmaciones** por correo tras crear o actualizar un lead en el CRM.
[Documentación de Gmail](/guides/integraciones/productividad/gmail)
Sincroniza **reuniones del equipo** entre Bitrix24 y Google Calendar para equipos con herramientas mixtas.
[Documentación de Google Calendar](/guides/integraciones/agendamiento/google-calendar)
Notifica al equipo de ventas cuando se crea un **nuevo lead** o cambia el **estado de un negocio**.
[Documentación de Slack](/guides/integraciones/productividad/slack)
Exporta **leads o contactos** a una hoja para **reportes de gestión** o seguimiento del pipeline.
[Documentación de Google Sheets](/guides/integraciones/productividad/google-sheets)
***
## Artículos relacionados
Catálogo de integraciones disponibles en el Marketplace.
Flujo general para instalar y usar integraciones en Brain Studio.
El agente decidirá automáticamente cuándo crear un lead, consultar un contacto o registrar un evento según la conversación.
### En Canvas
Ideal cuando necesitas control total del flujo (por ejemplo: calificar lead → crear contacto → asignar responsable → notificar).
***
## Casos de uso