AllyOneCRM / Contactos y empresas

Contactos y empresas

El modelo de datos central del CRM. Toda automatización, campaña y conversación gira en torno a un Contact.

Contact

email o phone es obligatorio — los demás campos son opcionales.

{
  "email": "maria@empresa.com",
  "phone": "+5511999998888",
  "mobile": "+5511999998888",
  "firstName": "María",
  "lastName": "Silva",
  "companyId": "cmp_...",
  "cpf": "000.000.000-00",
  "attributes": { "plan": "premium" },
  "tags": ["lead-caliente"],
  "optInEmail": true,
  "optInWhatsapp": true,
  "optInPush": false,
  "optInSms": false,
  "optInRcs": false
}

Company

Una empresa es una entidad separada — la relación es 1:N: un contacto pertenece a lo sumo a una empresa (Contact.companyId), una empresa puede tener varios contactos.

Endpoints

Acción	Endpoint
Crear contacto	POST `/v1/contacts`
Listar contactos	GET `/v1/contacts`
Búsqueda rápida	GET `/v1/contacts/search?q=`
Actualizar contacto	PATCH `/v1/contacts/:id`
Importar en masa	POST `/v1/contacts/import`

El listado se pagina por offset:

{ "data": [...], "total": 4213, "page": 1, "pageSize": 50, "totalPages": 85 }

Importación masiva

POST /v1/contacts/import acepta CSV mediante multipart/form-data (hasta 256 MB), con mapeo de columnas — el archivo se procesa de forma asíncrona en una cola y no bloquea la respuesta.