Personas de contacto

Cuando trabajas con una empresa cliente, sueles tratar con varios interlocutores (dirección, administración, compras, equipo técnico). Frihet permite registrar cada persona de contacto por separado dentro de la pestaña Personas de la ficha del cliente (/contacts/:id).

Añadir persona

1. Abre la ficha del cliente y selecciona la pestaña Personas (atajo p).
2. Si se trata de una empresa sin contactos registrados, la franja Foco en la parte superior muestra el aviso Falta una persona responsable con el botón directo Abrir personas.
3. Haz clic en Añadir persona, completa los campos y pulsa Añadir persona para guardar.

Campos disponibles

Campo	Obligatorio	Ejemplo	Notas de uso
Nombre	Sí	María García	Nombre completo de la persona de contacto
Cargo	No	Directora financiera	Puesto o responsabilidad dentro de la organización
Email	No	maria@acme.es	Correo directo del interlocutor (independiente del email fiscal)
Teléfono	No	+34 922 123 456	Teléfono directo o extensión

Editar, eliminar y permisos

Pasa el cursor sobre cualquier tarjeta de persona para mostrar las acciones:

• Editar contacto (icono de lápiz): abre el formulario en línea con los datos actuales; pulsa Guardar para confirmar.
• Eliminar contacto (icono de papelera): elimina la persona de contacto de la ficha del cliente.

Las acciones de creación, edición y borrado respetan los permisos del rol de tu usuario sobre el módulo de clientes (write para añadir o editar y delete para eliminar). Los usuarios con rol de solo lectura pueden consultar la lista completa sin modificarla.

Uso desde la API REST y servidor MCP

Los contactos de cada cliente pueden gestionarse desde la API REST y el servidor MCP:

Operación	Endpoint REST	Herramienta MCP
Listar personas	GET /v1/clients/{clientId}/contacts	list_client_contacts
Crear persona	POST /v1/clients/{clientId}/contacts	create_client_contact
Consultar persona	GET /v1/clients/{clientId}/contacts/{contactId}	—
Actualizar persona	PATCH /v1/clients/{clientId}/contacts/{contactId}	—
Eliminar persona	DELETE /v1/clients/{clientId}/contacts/{contactId}	delete_client_contact

Ejemplo para registrar una persona de contacto principal mediante la API REST:

curl -X POST "https://api.frihet.io/v1/clients/cli_01J8X9K2M4/contacts" \
  -H "X-API-Key: fri_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "María García",
    "role": "Directora financiera",
    "email": "maria@acme.es",
    "phone": "+34 922 123 456",
    "isPrimary": true
  }'

Límites y alcance del contrato

• Campos y longitudes en API REST y MCP: name es obligatorio (hasta 200 caracteres); email (hasta 255 caracteres), phone (hasta 50 caracteres), role (hasta 200 caracteres) e isPrimary (boolean, por defecto false en la API REST) son opcionales.
• Actualización parcial frente a herramientas MCP: una persona existente puede editarse en línea desde la interfaz web (Editar contacto) o mediante PATCH /v1/clients/{clientId}/contacts/{contactId} en la API REST; el servidor MCP expone listado, creación y eliminación (list_client_contacts, create_client_contact y delete_client_contact).

Uso práctico

• Identifica quién es el interlocutor responsable en cada empresa para evitar que llamadas, notas y próximas acciones queden sin destinatario claro.
• Conserva correos y teléfonos directos de administración o compras sin alterar el email ni los datos fiscales de facturación del cliente.

---

Relacionado: Detalle de cliente · Notas y actividades · Kanban CRM