Notas y actividades

Cada ficha de cliente en /contacts/:id incluye un historial cronológico de interacciones (Actividad) y un sistema de comentarios internos para tu equipo (Notas).

Timeline de actividad

Frihet registra automáticamente cada evento comercial y administrativo relevante del cliente:

• Factura creada (invoice_created), enviada (invoice_sent), cobrada (invoice_paid) o vencida (invoice_overdue)
• Presupuesto creado (quote_created), aceptado (quote_accepted) o rechazado (quote_rejected)
• Gasto registrado (expense_logged) vinculado al cliente
• Cambio de etapa en el pipeline (stage_changed, indicando la etapa de origen y la de destino)
• Nota añadida (note_added) y Cliente creado (client_created)

El timeline ordena los eventos del más reciente al más antiguo y los agrupa por bloques temporales:

Bloque en el timeline	Qué agrupa
Hoy	Eventos registrados en la fecha actual
Esta semana	Eventos de los últimos 7 días (excluyendo hoy)
YYYY-MM	Eventos anteriores agrupados por mes natural (por ejemplo, 2026-09)
Sin fecha válida	Eventos importados sin marca temporal válida (mostrados siempre al final)

Próxima acción en el timeline

La actividad histórica se combina con el compromiso inmediato del cliente (nextAction):

• Cuando el cliente tiene una próxima acción abierta (status: "open"), aparece fijada en la parte superior del timeline con la etiqueta Próximo: seguida del título y su fecha límite (o Sin fecha).
• Al guardar una próxima acción desde la ficha, Frihet registra además una actividad de tipo task (status: "open").
• Al pulsar Hecho en el panel de próxima acción, el evento queda registrado en el timeline como Hecho: {título} (status: "done").

Actividades manuales

Desde la parte inferior de la pestaña Actividad (si tu rol en el espacio de trabajo tiene permiso de escritura sobre clientes), dispones de tres acciones rápidas:

1. Registrar llamada: abre el campo de descripción, permite anotar el resumen de la conversación y guarda una entrada de tipo call al pulsar Registrar llamada o Enter.
2. Registrar reunión: abre el campo de descripción para documentar acuerdos o asistentes y guarda una entrada de tipo meeting.
3. Añadir tarea: abre directamente el panel de próxima acción en la parte superior de la ficha.

Notas internas

Las notas son comentarios internos vinculados al cliente. Solo son visibles para los miembros de tu espacio de trabajo y nunca se muestran al cliente ni en el portal público.

Crear nota

1. Abre la ficha del cliente y selecciona la pestaña Notas (atajo n).
2. Escribe el contenido en el campo Escribe una nota....
3. Haz clic en Guardar o pulsa Cmd+Enter (Ctrl+Enter en Windows y Linux).

Cada nota creada añade automáticamente una entrada Nota añadida en el timeline de actividad.

Editar y eliminar notas

• Pasa el cursor sobre cualquier nota para mostrar los iconos de acción.
• Haz clic en el icono de lápiz (Editar nota), modifica el texto y pulsa Guardar (o Cmd+Enter / Ctrl+Enter). La nota mostrará la marca (editada) junto a su fecha relativa.
• Haz clic en el icono de papelera (Eliminar nota) para borrarla.

Uso desde la API REST y servidor MCP

Puedes consultar y registrar actividades y notas programáticamente mediante la API REST y el servidor MCP:

Operación	Endpoint REST	Herramienta MCP
Listar actividades	GET /v1/clients/{clientId}/activities	list_client_activities
Registrar actividad	POST /v1/clients/{clientId}/activities	log_client_activity
Consultar actividad	GET /v1/clients/{clientId}/activities/{activityId}	—
Listar notas	GET /v1/clients/{clientId}/notes	list_client_notes
Crear nota	POST /v1/clients/{clientId}/notes	create_client_note
Consultar nota	GET /v1/clients/{clientId}/notes/{noteId}	—
Actualizar nota	PATCH /v1/clients/{clientId}/notes/{noteId}	—
Eliminar nota	DELETE /v1/clients/{clientId}/notes/{noteId}	delete_client_note

Ejemplo para registrar una llamada comercial y una nota interna vía API REST:

# 1. Registrar una llamada en el timeline del cliente
curl -X POST "https://api.frihet.io/v1/clients/cli_01J8X9K2M4/activities" \
  -H "X-API-Key: fri_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "call",
    "title": "Llamada de seguimiento sobre presupuesto Q4",
    "description": "Confirmado alcance técnico. Pendiente validación de compras."
  }'

# 2. Añadir una nota interna para el equipo
curl -X POST "https://api.frihet.io/v1/clients/cli_01J8X9K2M4/notes" \
  -H "X-API-Key: fri_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Prefiere facturación mensual a 30 días. Interlocutora de compras: María García."
  }'

Límites y alcance del contrato

• Tipos de actividad admitidos (ActivityType): la API REST admite los 8 tipos manuales o de integración ("call", "email", "email_sent" —donde "email" se normaliza y almacena como "email_sent"—, "meeting", "note_added", "task", "stage_changed" y "client_created"), mientras que la herramienta MCP log_client_activity acepta los 4 tipos de interacción directa ("call", "email", "meeting" y "task"). Los eventos de facturas, presupuestos y gastos los genera automáticamente el sistema.
• Inmutabilidad de actividades frente a edición de notas: las entradas del timeline de actividades son inmutables una vez registradas (registro append-only: no admiten PATCH ni DELETE). Las notas internas sí pueden actualizarse desde la interfaz web (Editar nota) o mediante PATCH /v1/clients/{clientId}/notes/{noteId} en la API REST; el servidor MCP expone listado, creación y eliminación (list_client_notes, create_client_note y delete_client_note).
• Longitudes máximas en API REST y MCP: en actividades, title es obligatorio (hasta 500 caracteres), description es opcional (hasta 5000 caracteres) y metadata (en la API REST) admite valores de texto de hasta 1000 caracteres; en notas, content es obligatorio (hasta 10000 caracteres).

---

Relacionado: Detalle de cliente · Personas de contacto · Kanban CRM