Ver el panorama (siempre primero)
get_crm_overview({ workspaceId }): marcas con su salud (en riesgo si no hay oportunidades abiertas y 30+ días sin contacto), personas, oportunidades con avance de producción y resumen del pipeline.Registrar una oportunidad
1. Si la marca no existe: brands_create (skill musa-marcas) o create_crm_contact({ brandName }), que la crea.
2. create_crm_deal({ workspaceId, brandId, title, stage, value, currency, probability, expectedCloseDate, deliverables }).
3. Contacto principal: create_crm_contact y update_crm_deal({ primaryContactId }).
Avanzar o cerrar
update_crm_deal({ workspaceId, dealId, stage }). Al ganar, finalValue; al perder, lostReason.update_crm_deliverable.log_interaction({ brandId, contactId?, interactionType, notes, interactionDate }).Seguimiento de cuentas en riesgo
1. get_crm_overview → marcas at_risk.
2. list_interactions({ brandId }) para ver el último contacto.
3. Propón el siguiente paso; update_crm_brand({ brandId, nextFollowUpAt, crmNotes }).
Dar acceso al portal a un cliente
1. provision_client_access({ workspaceId, email, name, brandId }): crea la cuenta del cliente (o rota su contraseña). La contraseña se muestra una sola vez: entrégasela a la persona en ese momento.
2. list_guests, update_client_profile, reset_client_password, revoke_guest para administrarlos.
Cotizar
1. list_rates({ workspaceId }) → tarifario. Si no existe o hay que cambiarlo: rates_save (solo admins).
2. quote_save({ workspaceId, title, brandId, dealId?, currency, items: [{ label, price, qty, unit }] }) → queda en Borrador con número y total.
3. Revisada por la persona: quote_set_status({ id, status: "Enviada" }) → devuelve la url donde el cliente firma. Envíala con email_send (skill musa-mailing-eventos) si te lo piden.
4. Cuando el cliente firma, el estado pasa solo a Firmada; también puedes marcar Rechazada o Vencida.
Fees y horas
list_fees, fee_save({ brandId, monthlyFee, currency, hoursIncluded, piecesIncluded }).fee_log({ id, hours?, pieces?, outOfScope?: ["Video extra para TikTok"] }); clearOutOfScope: true cuando se resolvieron.Proyectos
list_projects({ workspaceId, brandId?, withTasks: true }).project_save({ name, brandId, briefId?, quoteId?, status, startsOn, endsOn, budget, hoursPlanned, progress }). Estados: Planificando, En producción, En revisión, Pausado, Entregado, Cerrado.project_task_save({ projectId, title, due, status: "todo" | "doing" | "done" }); delete: true la borra.playbook_apply (skill musa-planear).Growth loops (mecánica de crecimiento por marca)
list_growth_loops y save_growth_loop({ brandName, macro: "acq" | "ret" | "mon", sub, values }). Se ven en Vender › Loops y Medir › Loops (más en musa-medir).Panorama y oportunidades
get_crm_overview, list_crm_deals, create_crm_deal, update_crm_deal, update_crm_deliverable.Personas y empresas
create_crm_contact, update_crm_contact, update_crm_brand.capture_social_contact: desde la bandeja de redes (skill musa-redes).Interacciones
log_interaction, list_interactions.Portal del cliente
provision_client_access, list_guests, update_client_profile, reset_client_password, revoke_guest.Loops
list_growth_loops, save_growth_loop.Cotizaciones y tarifario
list_quotes, quote_save, quote_set_status, list_rates, rates_save.Fees
list_fees, fee_save, fee_log.Proyectos
list_projects, project_save, project_task_save.