Skip to main content

​
Configuración básica

Puedes instalar la integración de Bitrix24 desde nuestro Marketplace. Una vez instalada, podrás gestionar tu CRM (leads, contactos, empresas) y calendario directamente desde tu agente.

​
Prerrequisitos

Antes de usar esta integración, necesitas:
  1. Cuenta activa en Bitrix24 — Regístrate en bitrix24.com
  2. Webhook URL — Crea un webhook inbound en tu portal de Bitrix24

​
Credenciales requeridas

CampoDescripciónRequerido
Webhook URLURL del webhook inbound de Bitrix24Sí
Para crear tu Webhook URL, ve a tu portal de Bitrix24: Aplicaciones > Recursos para desarrolladores > Otros > Inbound webhook. La URL tiene el formato: https://tu-dominio.bitrix24.com/rest/1/abc123xyz/

​
Funcionalidades

​
CRM - Leads

​
Crear lead

Crea un nuevo lead en el CRM de Bitrix24. Inputs:
  • title (string) — 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.
  • status_id (opcional, string) — ID del estado (ej. “NEW”, “IN_PROCESS”).
  • source_id (opcional, string) — ID de la fuente (ej. “WEB”, “CALL”).
  • phone (opcional, string) — Número de teléfono.
  • phone_type (opcional, enum: WORK | MOBILE | HOME | FAX | OTHER) — Tipo de teléfono.
  • email (opcional, string) — Correo electrónico.
  • email_type (opcional, enum: WORK | HOME | OTHER) — Tipo de email.
  • opportunity (opcional, string) — Monto esperado 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": "Nuevo cliente interesado",
  "name": "Juan",
  "last_name": "Pérez",
  "phone": "+593999123456",
  "email": "[email protected]",
  "opportunity": "5000",
  "currency_id": "USD"
}

​
Obtener lead

Obtiene información detallada de un lead específico. Inputs:
  • id (string) — ID del lead.

​
Listar leads

Lista los leads del CRM con filtros opcionales. Inputs:
  • status_id (opcional, string) — Filtrar por estado.
  • source_id (opcional, string) — Filtrar por fuente.
  • assigned_by_id (opcional, string) — Filtrar por responsable.
  • start (opcional, number) — Offset para paginación.

​
Actualizar lead

Actualiza la información de un lead existente. Inputs:
  • id (string) — ID del lead a actualizar.
  • title (opcional, string) — Nuevo título.
  • status_id (opcional, string) — Nuevo estado.
  • phone (opcional, string) — Nuevo teléfono.
  • email (opcional, string) — Nuevo email.
  • opportunity (opcional, string) — Nuevo monto esperado.
  • comments (opcional, string) — Nuevos comentarios.

​
Eliminar lead

Elimina un lead del CRM.
Esta acción no se puede deshacer.
Inputs:
  • id (string) — ID del lead a eliminar.

​
CRM - Contactos

​
Crear contacto

Crea un nuevo contacto en el CRM. Inputs:
  • name (opcional, string) — Nombre.
  • last_name (opcional, string) — Apellido.
  • phone (opcional, string) — Teléfono.
  • phone_type (opcional, enum: WORK | MOBILE | HOME | FAX | OTHER) — Tipo de teléfono.
  • email (opcional, string) — Email.
  • email_type (opcional, enum: WORK | HOME | OTHER) — Tipo de email.
  • company_id (opcional, string) — ID de la empresa asociada.
  • post (opcional, string) — Cargo/posición.
  • source_id (opcional, string) — ID de la fuente.
  • assigned_by_id (opcional, string) — ID del responsable.
  • comments (opcional, string) — Comentarios.
Ejemplo: 
{
  "name": "María",
  "last_name": "García",
  "phone": "+593999654321",
  "phone_type": "MOBILE",
  "email": "[email protected]",
  "post": "Gerente de Compras"
}

​
Obtener contacto

Obtiene información detallada de un contacto. Inputs:
  • id (string) — ID del contacto.

​
Listar contactos

Lista los contactos del CRM con filtros opcionales. Inputs:
  • company_id (opcional, string) — Filtrar por empresa.
  • assigned_by_id (opcional, string) — Filtrar por responsable.
  • source_id (opcional, string) — Filtrar por fuente.
  • start (opcional, number) — Offset para paginación.

​
Actualizar contacto

Actualiza la información de un contacto existente. Inputs:
  • id (string) — ID del contacto a actualizar.
  • name (opcional, string) — Nuevo nombre.
  • last_name (opcional, string) — Nuevo apellido.
  • phone (opcional, string) — Nuevo teléfono.
  • email (opcional, string) — Nuevo email.
  • post (opcional, string) — Nuevo cargo.
  • comments (opcional, string) — Nuevos comentarios.

​
Eliminar contacto

Elimina un contacto del CRM. Inputs:
  • id (string) — ID del contacto a eliminar.

​
CRM - Empresas

​
Crear empresa

Crea una nueva empresa en el CRM. Inputs:
  • title (string) — Nombre de la empresa.
  • company_type (opcional, string) — Tipo (ej. “CUSTOMER”, “SUPPLIER”).
  • industry (opcional, string) — Código de industria.
  • phone (opcional, string) — Teléfono.
  • phone_type (opcional, enum: WORK | MOBILE | HOME | FAX | OTHER) — Tipo de teléfono.
  • email (opcional, string) — Email.
  • email_type (opcional, enum: WORK | HOME | OTHER) — Tipo de email.
  • 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": "+593999111222",
  "email": "[email protected]",
  "web": "https://empresaabc.com"
}

​
Obtener empresa

Obtiene información detallada de una empresa. Inputs:
  • id (string) — ID de la empresa.

​
Listar empresas

Lista las empresas del CRM con filtros opcionales. Inputs:
  • company_type (opcional, string) — Filtrar por tipo.
  • industry (opcional, string) — Filtrar por industria.
  • assigned_by_id (opcional, string) — Filtrar por responsable.
  • start (opcional, number) — Offset para paginación.

​
Actualizar empresa

Actualiza la información de una empresa existente. Inputs:
  • id (string) — ID de la empresa a actualizar.
  • title (opcional, string) — Nuevo nombre.
  • company_type (opcional, string) — Nuevo tipo.
  • industry (opcional, string) — Nueva industria.
  • phone (opcional, string) — Nuevo teléfono.
  • email (opcional, string) — Nuevo email.
  • address (opcional, string) — Nueva dirección.
  • comments (opcional, string) — Nuevos comentarios.

​
Eliminar empresa

Elimina una empresa del CRM. Inputs:
  • id (string) — ID de la empresa a eliminar.

​
Calendario

​
Crear evento

Crea un nuevo evento en el calendario de Bitrix24. Inputs:
  • name (string) — Nombre del evento.
  • from (string) — Fecha/hora de inicio (formato ISO).
  • to (string) — Fecha/hora de fin (formato ISO).
  • section_id (string) — ID de la sección del calendario.
  • description (opcional, string) — Descripción del evento.
  • location (opcional, string) — Ubicación.
  • accessibility (opcional, enum: busy | free | absent) — Estado de disponibilidad.
  • importance (opcional, enum: high | normal | low) — Importancia.
  • is_meeting (opcional, boolean) — Es una reunión con asistentes.
  • attendees (opcional, array de string) — IDs de los asistentes.
  • type (opcional, string) — Tipo de calendario: “user”, “group” o “company”.
  • owner_id (opcional, string) — ID del propietario del calendario.
Ejemplo: 
{
  "name": "Reunión con cliente",
  "from": "2025-01-20T10:00:00",
  "to": "2025-01-20T11:00:00",
  "section_id": "1",
  "location": "Sala de reuniones",
  "importance": "high"
}

​
Listar eventos

Lista los eventos del calendario en un rango de fechas. Inputs:
  • type (opcional, string) — Tipo de calendario (por defecto “user”).
  • owner_id (opcional, string) — ID del propietario.
  • from (opcional, string) — Fecha de inicio del rango (ISO).
  • to (opcional, string) — Fecha de fin del rango (ISO).
  • section (opcional, array de string) — Filtrar por IDs de sección.

​
Obtener evento

Obtiene información detallada de un evento. Inputs:
  • id (string) — ID del evento.

​
Eliminar evento

Elimina un evento del calendario. Inputs:
  • id (string) — ID del evento a eliminar.

​
Listar secciones de calendario

Lista las secciones (calendarios) disponibles. Inputs:
  • type (opcional, string) — Tipo de calendario (por defecto “user”).
  • owner_id (opcional, string) — ID del propietario.

​
Crear sección de calendario

Crea una nueva sección (calendario) en Bitrix24. Inputs:
  • name (string) — Nombre de la sección.
  • type (opcional, enum: user | group) — Tipo de calendario.
  • owner_id (opcional, string) — ID del propietario.
  • description (opcional, string) — Descripción.
  • color (opcional, string) — Color de fondo (formato hex, ej. “#9cbeee”).
  • text_color (opcional, string) — Color de texto (formato hex).

​
Actualizar sección de calendario

Actualiza una sección existente. Inputs:
  • id (string) — ID de la sección a actualizar.
  • type (opcional, enum: user | group) — Tipo de calendario.
  • owner_id (opcional, string) — ID del propietario.
  • name (opcional, string) — Nuevo nombre.
  • description (opcional, string) — Nueva descripción.
  • color (opcional, string) — Nuevo color de fondo.
  • text_color (opcional, string) — Nuevo color de texto.

​
Eliminar sección de calendario

Elimina una sección del calendario.
Esta acción eliminará todos los eventos de esta sección y no se puede deshacer.
Inputs:
  • id (string) — ID de la sección a eliminar.