Contactos
Los contactos son personas en tu base de datos comercial. Pueden vincularse a una cuenta (empresa) y a un cliente del e-commerce.
Listar contactos
GET /admin/crm/contacts
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
cursor | string | Cursor de paginación |
q | string | Busca en email, nombre, teléfono |
filter | string | all, b2b, vip, archived |
source | string | ecommerce, manual |
tag | string | Filtrar por tag específico |
sort | string | -created_at, first_name, -first_name |
Crear contacto
POST /admin/crm/contacts
| Campo | Requerido | Tipo | Descripción |
|---|---|---|---|
email | sí | string | Email del contacto |
first_name | sí | string | Nombre |
last_name | no | string | Apellido |
phone | no | string | Teléfono |
job_title | no | string | Cargo |
account_id | no | uuid | Cuenta (empresa) asociada |
owner_id | no | uuid | Staff responsable |
tags | no | []string | Tags para segmentación |
source | no | string | Origen (default: manual) |
Detalle de contacto
GET /admin/crm/contacts/:id
Muestra timeline de actividades, deals asociados, tareas pendientes.
Editar contacto
POST /admin/crm/contacts/:id/edit
Mismos campos que crear (sin source).
Eliminar contacto
DELETE /admin/crm/contacts/:id
Soft-delete (marca como archivado).
Restaurar contacto
POST /admin/crm/contacts/:id/restore
Exportar contactos
GET /admin/crm/contacts/export.csv
Exporta todos los contactos que coinciden con el filtro actual.
Importar contactos
POST /admin/crm/contacts/import
Sube un archivo CSV con los contactos a importar.
Acciones masivas
| Acción | Método | Endpoint |
|---|---|---|
| Archivar varios | POST | /admin/crm/contacts/bulk-archive |
| Restaurar varios | POST | /admin/crm/contacts/bulk-restore |
| Exportar seleccionados | POST | /admin/crm/contacts/bulk-export |
| Agregar tag | POST | /admin/crm/contacts/bulk-tag |