Configuración del CRM

CRM → Configuración concentra los ajustes comerciales de la organización: la Jerarquía comercial, los Targets de venta (desde el informe Cumplimiento) y los Webhooks salientes.

Jerarquía comercial

En Configuración → Jerarquía se define el árbol del equipo: cada usuario con su supervisor directo. El árbol se muestra indentado; los supervisores ven la cantidad de personas a cargo.

• Asignar: elegí el usuario, su supervisor (o "Sin supervisor" para una raíz) y presioná Asignar. Si el usuario ya estaba en el árbol, se actualiza su supervisor.
• Quitar: la cruz al lado del nombre saca al usuario del árbol (sus supervisados directos conservan el vínculo con él).
• Las asignaciones que crearían un ciclo (A supervisa a B y B a A) se rechazan automáticamente.
• Solo administradores del tenant pueden modificar la jerarquía.

Modos de visibilidad (parámetro CRM_VISIBILIDAD)

La jerarquía cobra efecto según el parámetro CRM_VISIBILIDAD (grupo CRM de los parámetros unificados, configurable por organización o tenant):

| Modo | Qué ve cada usuario | |---|---| | org (default) | Todo lo de la organización (comportamiento histórico). | | propias | Solo sus registros (asignado o creador) + los compartidos con él. | | jerarquia | Lo propio + todo lo de su subárbol de supervisados + compartidos. |

Aplica a oportunidades, leads (consultas web), cotizaciones y actividades, y también al dashboard y a los informes (un gerente ve el agregado de su equipo). Los administradores del sistema, del tenant o de la organización ven siempre todo.

En modos restringidos, un registro sin asignado ni creador queda visible solo para administradores: asignalo o compartilo para exponerlo.

Compartir una oportunidad

Desde la ficha de la oportunidad, el botón Compartir permite darle acceso a un usuario puntual con permiso de lectura o edición, sin importar la jerarquía. Quien comparte debe poder editar el registro (dueño, supervisor del dueño o administrador).

Webhooks salientes

En Configuración → Webhooks podés suscribir URLs de sistemas externos a eventos del CRM: lead creado, oportunidad ganada y cotización aceptada. Ante cada evento, Kanoa hace un POST JSON a la URL con la firma HMAC-SHA256 del cuerpo en el header X-Kanoa-Signature (verificala con el secreto del webhook).

• El secreto se muestra una sola vez al crear el webhook: guardalo en ese momento. Si lo perdés, eliminá el webhook y crealo de nuevo.
• La URL debe ser https://.
• Cada entrega reintenta hasta 3 veces (1s / 5s / 25s) y queda registrada en el historial (estado HTTP, error) visible en la misma pantalla.
• El botón Probar envía una entrega de prueba (data.test = true) para validar la integración.
• Solo administradores del tenant pueden crear, pausar o eliminar webhooks.

El contrato técnico (payloads, verificación de firma con ejemplo en Node) está en la documentación de la API pública del CRM.

Parámetros CRM_* — tabla de referencia

Todo el comportamiento configurable del CRM vive en Configuración → Parámetros, grupo CRM (parámetros unificados, con cascada global → tenant → organización: el valor más específico gana). Los siete parámetros:

| Parámetro | Qué hace | Valores posibles | Default | |---|---|---|---| | CRM_VISIBILIDAD | Alcance de lo que ve cada usuario en oportunidades, leads, cotizaciones y actividades (ver "Modos de visibilidad" arriba). | org / propias / jerarquia | org (todos ven todo) | | CRM_ASIGNACION_LEADS | Qué pasa al crear un lead (web, WhatsApp, manual, import): a quién se asigna automáticamente. | ninguna / round_robin (rota entre los usuarios de la org) / el ID de un usuario fijo | ninguna | | CRM_SCORING_PESOS | Pesos de cada señal del score de leads (0-100): email corporativo, teléfono, empresa, dominio registrado, campaña UTM, mensaje largo. | JSON con un peso por señal | email_corporativo 20, telefono 15, empresa 15, dominio_ruteado 20, utm_campaign 15, mensaje_largo 15 | | CRM_SCORING_IA | Suma al score por reglas un ajuste IA de -20 a +20 según el contenido del mensaje (urgencia, presupuesto vs. spam). Tiene costo de IA por lead. | activado / desactivado | desactivado | | CRM_LEAD_COMERCIAL_IA | Cuando la Bandeja detecta por IA una consulta comercial de un remitente desconocido, genera un lead en la bandeja comercial global (solo visible para administradores). Se configura a nivel global. | activado / desactivado | activado | | CRM_DESCUENTO_MAX_SIN_APROBACION | % de descuento máximo por ítem que un vendedor puede dar en una cotización sin aprobación del supervisor (ver artículo "Cotizaciones"). | número 0-100 (100 = sin control) | 100 | | CRM_INFORME_MENSUAL_EMAILS | Emails que reciben el día 1 de cada mes el informe comercial del mes anterior (funnel + cumplimiento de targets). | emails separados por coma; vacío = desactivado | vacío |