CRM
El CRM guarda a tus clientes y el trabajo comercial: quién entró, en qué etapa está, quién lo lleva y qué pasó con él. Su clave en el catálogo es crm, es núcleo y viene en todos los planes. Lo usas desde el primer lead.
Qué hace
Sección titulada «Qué hace»- Embudo por etapas. Crear, renombrar, colorear, marcar ganada o perdida, reordenar y eliminar. Al reordenar mandas la lista completa, no “sube esta una posición”.
- Métricas en
GET /api/sites/{sitio}/crm: leads y valor por etapa, conversión, sin atender y olvidados, con ventana de semana contra la anterior. - Las etapas son datos. Ningún número mira el nombre de una etapa: la conversión sale de las banderas
is_won/is_lost. Puedes renombrar el embudo entero sin que cambie un indicador. - Sin atender y olvidados son cosas distintas. Sin atender es que nadie lo tocó desde que entró; olvidado es que se quedó parado. Un formulario o un correo entrante no cuentan como atención: llegaron sin que el equipo hiciera nada.
- Responsable. Un lead se asigna a una persona; queda en la línea de tiempo con el nombre de quien lo tenía, y si esa persona sale del equipo el lead sigue en el embudo.
- Personas y empresas. La persona es la entidad y el lead su papel; todas las vías de alta pasan por el mismo resolutor, por correo normalizado y teléfono. La empresa se liga por nombre normalizado.
- Segmentos, tareas, duplicados y el chat de la ficha (resumen, siguiente paso, voz y foto).
De qué depende
Sección titulada «De qué depende»- El módulo
crmy el permiso de trabajocrmde tu perfil. Un perfil de caja no entra. - Una llave de IA para el chat de la ficha; sin ella, el resumen responde que no se puede generar.
- HubSpot, si lo conectas en Ajustes → Integraciones, para sincronizar contactos.
- Los bloques de cotizaciones y pedidos del chat solo aparecen si el sitio tiene esos módulos.
Qué pasa cuando se apaga
Sección titulada «Qué pasa cuando se apaga»- Los segmentos, el chat de la ficha y la memoria responden 403 con
module: "crm"; la fuente “leads sin tocar” desaparece deGET /api/attention. - Una automatización cuya audiencia es un segmento deja de correr: la regla no encuentra la vista.
- Trampa: el listado y la ficha de leads no consultan el entitlement. Se cierran por permiso de perfil, así que apagar el módulo esconde la sección del panel, no la API.
Límites y trampas
Sección titulada «Límites y trampas»- No hay filtro por “sin atender” en el listado. Por eso el aviso del Pipeline es un indicador y no un enlace: “sin atender” y “sin asignar” no son lo mismo, y enlazar al filtro equivocado manda a la lista equivocada.
- Una etapa no puede ser ganada y perdida a la vez. El resumen evaluaría ganada primero y la etapa quedaría fuera del valor abierto.
- Borrar una etapa con leads exige decir a dónde se mueven, incluidos los de la papelera; sin destino desaparecerían del tablero sin que nadie los cerrara.
- La empresa del CRM no tiene buzón. El buzón es del sitio: confundir las dos capas pone el correo de un negocio en otro.
- Editar el dato que dio la propia persona es 422 y atómico: si un campo está protegido no se aplica ninguno.
- Los importes viajan como texto con dos decimales; el porcentaje de conversión puede salir entero o decimal, así que el panel no debe asumir decimales.