Saltar al contenido principal

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 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.
1

Abre Aplicaciones en Bitrix24

En el menú lateral de Bitrix24, entra a Aplicaciones.
2

Entra a Recursos para desarrolladores

Dentro de Aplicaciones, abre Recursos para desarrolladores.
3

Selecciona Otro

En la pantalla de recursos para desarrolladores, entra a la categoría Otro.
4

Crea un webhook entrante

Haz clic en Webhook entrante para abrir la configuración del webhook que usarás en Brain Studio.
5

Copia la Webhook URL

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.
6

Asigna los permisos necesarios

En la sección Asignar permisos, selecciona estos permisos:
  • CRM (crm)
  • Calendario (calendar)
Pantalla de configuración de Webhook entrante en Bitrix24 con los permisos CRM y Calendario seleccionados
Con estos permisos puedes usar las tools de leads, contactos, empresas, eventos y secciones de calendario disponibles en Brain Studio.
7

Guarda el webhook

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: 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.
1

Abrir el Marketplace

En Brain Studio, abre Marketplace desde el menú lateral.
2

Buscar Bitrix24

Encuentra la integración y haz clic en Conectar.
3

Ingresar la Webhook URL

Completa el formulario con tu Webhook URL de Bitrix24.
Modal de Credenciales API en Brain Studio solicitando la Webhook URL para instalar la integración Bitrix24
4

Confirmar instalación

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:
{
  "title": "Interesado en plan Enterprise",
  "name": "Juan",
  "last_name": "Pérez",
  "phone": "+573001234567",
  "email": "[email protected]",
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "name": "María",
  "last_name": "García",
  "phone": "+573009876543",
  "email": "[email protected]",
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "title": "Empresa ABC S.A.",
  "company_type": "CUSTOMER",
  "phone": "+573001112233",
  "email": "[email protected]",
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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:
{
  "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.
1

Abre el nodo AI Agent

En el Canvas, selecciona o añade el nodo AI Agent.
2

Abre Herramientas

En el panel derecho, entra a la pestaña Herramientas.
3

Agrega Bitrix24

Usa Agregar tool, busca Bitrix24 y actívala.
4

Configura las tools

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.
Panel lateral AI Agent en Brain Studio: pestaña Herramientas con Bitrix24 agregado y configuración accesible
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).
1

Arrastra Bitrix24 al Canvas

En el panel lateral, abre Marketplace y arrastra Bitrix24 al flujo.
2

Selecciona la tool

Con el nodo seleccionado, en Tools elige la acción (por ejemplo Crear lead).
3

Configura el cuerpo y la memoria

Completa el JSON del cuerpo de la petición y, si aplica, Guardar respuesta en una variable de memoria.
4

Conecta el flujo

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.
{
  "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"
}
Brain Studio: nodo Bitrix24 en el Canvas y panel de configuración con tool seleccionada, guardar respuesta y cuerpo de la petición JSON

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
Sincroniza reuniones del equipo entre Bitrix24 y Google Calendar para equipos con herramientas mixtas.Documentación de Google Calendar
Notifica al equipo de ventas cuando se crea un nuevo lead o cambia el estado de un negocio.Documentación de Slack
Exporta leads o contactos a una hoja para reportes de gestión o seguimiento del pipeline.Documentación de Google Sheets

Artículos relacionados

Integraciones

Catálogo de integraciones disponibles en el Marketplace.

Cómo usar integraciones en Brain

Flujo general para instalar y usar integraciones en Brain Studio.