AllyOneCRM / Contatos & Empresas

Contatos & Empresas

O modelo de dado central do CRM. Toda automação, campanha e conversa gira em torno de um Contact.

Contact

email ou phone é obrigatório — os demais campos são opcionais.

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

Company

Uma empresa é uma entidade separada — a relação é 1:N: um contato pertence a no máximo uma empresa (Contact.companyId), uma empresa pode ter vários contatos.

Endpoints

Ação	Endpoint
Criar contato	POST `/v1/contacts`
Listar contatos	GET `/v1/contacts`
Buscar rápido	GET `/v1/contacts/search?q=`
Atualizar contato	PATCH `/v1/contacts/:id`
Importar em massa	POST `/v1/contacts/import`

Listagem é paginada por offset:

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

Importação em massa

POST /v1/contacts/import aceita CSV via multipart/form-data (até 256MB), com mapeamento de coluna — o arquivo é processado de forma assíncrona numa fila, não bloqueia a resposta.