CRM — Complementar

Endpoints complementares do modulo CRM: atividades, itens de negocio e pipelines.

Atividades (Activities)

Listar Atividades

`GET /external/v1/activities`

Retorna uma lista paginada de atividades comerciais.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`dealId`	`string`	Nao	Filtro por negocio
`personId`	`string`	Nao	Filtro por pessoa
`type`	`string`	Nao	Filtro por tipo: `CALL`, `EMAIL`, `MEETING`, `TASK`, `NOTE`
`status`	`string`	Nao	Filtro por status: `PENDING`, `DONE`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/activities?page=1&limit=10&type=MEETING&status=PENDING" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clx9h0i1j2k3l4m5n6o7p8q9",
      "title": "Reuniao de apresentacao - Tech Solutions",
      "type": "MEETING",
      "status": "PENDING",
      "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
      "dealTitle": "Implantacao Tesselys - Tech Solutions",
      "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
      "personName": "Tech Solutions Ltda",
      "description": "Apresentacao dos modulos financeiro e CRM.",
      "dueDate": "2026-03-28T14:00:00.000Z",
      "isActive": true,
      "createdAt": "2026-03-22T10:00:00.000Z",
      "updatedAt": "2026-03-22T10:00:00.000Z"
    }
  ],
  "meta": {
    "total": 18,
    "page": 1,
    "limit": 10,
    "totalPages": 2
  }
}

Buscar Atividade por ID

`GET /external/v1/activities/:id`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/activities/clx9h0i1j2k3l4m5n6o7p8q9" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "id": "clx9h0i1j2k3l4m5n6o7p8q9",
  "title": "Reuniao de apresentacao - Tech Solutions",
  "type": "MEETING",
  "status": "PENDING",
  "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
  "dealTitle": "Implantacao Tesselys - Tech Solutions",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "description": "Apresentacao dos modulos financeiro e CRM.",
  "dueDate": "2026-03-28T14:00:00.000Z",
  "isActive": true,
  "createdAt": "2026-03-22T10:00:00.000Z",
  "updatedAt": "2026-03-22T10:00:00.000Z"
}

Criar Atividade

`POST /external/v1/activities`

Body:

Campo	Tipo	Obrigatorio	Descricao
`title`	`string`	Sim	Titulo da atividade (max: 255)
`type`	`string`	Sim	Tipo: `CALL`, `EMAIL`, `MEETING`, `TASK`, `NOTE`
`dealId`	`string`	Nao	ID do negocio vinculado
`personId`	`string`	Nao	ID da pessoa vinculada
`description`	`string`	Nao	Descricao detalhada
`dueDate`	`string`	Nao	Data de vencimento (ISO 8601)
`status`	`string`	Nao	Status inicial: `PENDING` ou `DONE` (default: `PENDING`)

Exemplo de requisicao:

curl -X POST "https://api.tesselys.com.br/external/v1/activities" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Ligacao de follow-up - Acme Corp",
    "type": "CALL",
    "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
    "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "description": "Retornar ligacao para confirmar recebimento da proposta.",
    "dueDate": "2026-03-27T10:00:00.000Z"
  }'

Resposta (201):

{
  "id": "clxa0i1j2k3l4m5n6o7p8q9r0",
  "title": "Ligacao de follow-up - Acme Corp",
  "type": "CALL",
  "status": "PENDING",
  "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
  "dealTitle": "Implantacao Tesselys - Tech Solutions",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "description": "Retornar ligacao para confirmar recebimento da proposta.",
  "dueDate": "2026-03-27T10:00:00.000Z",
  "isActive": true,
  "createdAt": "2026-03-25T15:00:00.000Z",
  "updatedAt": "2026-03-25T15:00:00.000Z"
}

Atualizar Atividade

`PUT /external/v1/activities/:id`

Atualiza os dados de uma atividade existente. Envie apenas os campos que deseja alterar.

Body (campos opcionais):

Campo	Tipo	Descricao
`title`	`string`	Novo titulo
`status`	`string`	Novo status: `PENDING` ou `DONE`
`description`	`string`	Nova descricao
`dueDate`	`string`	Nova data de vencimento (ISO 8601)

Exemplo de requisicao:

curl -X PUT "https://api.tesselys.com.br/external/v1/activities/clxa0i1j2k3l4m5n6o7p8q9r0" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "DONE",
    "description": "Ligacao realizada. Cliente confirmou interesse e solicitou reuniao presencial."
  }'

Resposta (200):

{
  "id": "clxa0i1j2k3l4m5n6o7p8q9r0",
  "title": "Ligacao de follow-up - Acme Corp",
  "type": "CALL",
  "status": "DONE",
  "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
  "dealTitle": "Implantacao Tesselys - Tech Solutions",
  "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
  "personName": "Tech Solutions Ltda",
  "description": "Ligacao realizada. Cliente confirmou interesse e solicitou reuniao presencial.",
  "dueDate": "2026-03-27T10:00:00.000Z",
  "isActive": true,
  "createdAt": "2026-03-25T15:00:00.000Z",
  "updatedAt": "2026-03-25T17:30:00.000Z"
}

Itens de Negocio (Deal Items)

Listar Itens de Negocio

`GET /external/v1/deal-items`

Retorna uma lista paginada de itens vinculados a negocios.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)
`dealId`	`string`	Nao	Filtro por negocio

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/deal-items?dealId=clx3c4d5e6f7g8h9i0j1k2l3" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clxb1j2k3l4m5n6o7p8q9r0s1",
      "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
      "description": "Licenca Tesselys Enterprise - 50 usuarios",
      "quantity": 50,
      "unitPrice": 1200.00,
      "discount": 10.00,
      "totalPrice": 54000.00,
      "isActive": true,
      "createdAt": "2026-03-10T11:00:00.000Z",
      "updatedAt": "2026-03-10T11:00:00.000Z"
    }
  ],
  "meta": {
    "total": 3,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

Buscar Item de Negocio por ID

`GET /external/v1/deal-items/:id`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/deal-items/clxb1j2k3l4m5n6o7p8q9r0s1" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "id": "clxb1j2k3l4m5n6o7p8q9r0s1",
  "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
  "description": "Licenca Tesselys Enterprise - 50 usuarios",
  "quantity": 50,
  "unitPrice": 1200.00,
  "discount": 10.00,
  "totalPrice": 54000.00,
  "isActive": true,
  "createdAt": "2026-03-10T11:00:00.000Z",
  "updatedAt": "2026-03-10T11:00:00.000Z"
}

Criar Item de Negocio

`POST /external/v1/deal-items`

Body:

Campo	Tipo	Obrigatorio	Descricao
`dealId`	`string`	Sim	ID do negocio vinculado
`description`	`string`	Sim	Descricao do item (max: 255)
`quantity`	`number`	Nao	Quantidade (default: `1`)
`unitPrice`	`number`	Nao	Preco unitario
`discount`	`number`	Nao	Percentual de desconto (0-100)

Exemplo de requisicao:

curl -X POST "https://api.tesselys.com.br/external/v1/deal-items" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
    "description": "Treinamento presencial - 2 dias",
    "quantity": 1,
    "unitPrice": 8000.00,
    "discount": 0
  }'

Resposta (201):

{
  "id": "clxc2k3l4m5n6o7p8q9r0s1t2",
  "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
  "description": "Treinamento presencial - 2 dias",
  "quantity": 1,
  "unitPrice": 8000.00,
  "discount": 0,
  "totalPrice": 8000.00,
  "isActive": true,
  "createdAt": "2026-03-25T16:00:00.000Z",
  "updatedAt": "2026-03-25T16:00:00.000Z"
}

Atualizar Item de Negocio

`PUT /external/v1/deal-items/:id`

Atualiza os dados de um item de negocio existente. Envie apenas os campos que deseja alterar.

Body (campos opcionais):

Campo	Tipo	Descricao
`description`	`string`	Nova descricao
`quantity`	`number`	Nova quantidade
`unitPrice`	`number`	Novo preco unitario
`discount`	`number`	Novo percentual de desconto (0-100)

Exemplo de requisicao:

curl -X PUT "https://api.tesselys.com.br/external/v1/deal-items/clxc2k3l4m5n6o7p8q9r0s1t2" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 2,
    "unitPrice": 7500.00,
    "discount": 5
  }'

Resposta (200):

{
  "id": "clxc2k3l4m5n6o7p8q9r0s1t2",
  "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
  "description": "Treinamento presencial - 2 dias",
  "quantity": 2,
  "unitPrice": 7500.00,
  "discount": 5,
  "totalPrice": 14250.00,
  "isActive": true,
  "createdAt": "2026-03-25T16:00:00.000Z",
  "updatedAt": "2026-03-25T17:00:00.000Z"
}

Pipelines de Negocio (Deal Pipelines)

Endpoints somente leitura para consultar pipelines e seus estagios.

Listar Pipelines

`GET /external/v1/deal-pipelines`

Retorna uma lista paginada de pipelines de negocio.

Query Parameters:

Parametro	Tipo	Obrigatorio	Descricao
`page`	`number`	Nao	Pagina atual (default: `1`)
`limit`	`number`	Nao	Itens por pagina (default: `20`, max: `100`)

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/deal-pipelines?page=1&limit=10" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "data": [
    {
      "id": "clxpipe001",
      "name": "Vendas B2B",
      "description": "Pipeline principal para vendas corporativas.",
      "stages": [
        { "id": "clxstage001", "name": "Qualificacao", "order": 1 },
        { "id": "clxstage002", "name": "Negociacao", "order": 2 },
        { "id": "clxstage003", "name": "Proposta Enviada", "order": 3 },
        { "id": "clxstage004", "name": "Fechamento", "order": 4 }
      ],
      "isActive": true,
      "createdAt": "2026-01-05T08:00:00.000Z",
      "updatedAt": "2026-01-05T08:00:00.000Z"
    }
  ],
  "meta": {
    "total": 3,
    "page": 1,
    "limit": 10,
    "totalPages": 1
  }
}

Buscar Pipeline por ID

`GET /external/v1/deal-pipelines/:id`

Exemplo de requisicao:

curl -X GET "https://api.tesselys.com.br/external/v1/deal-pipelines/clxpipe001" \
  -H "Authorization: Bearer {accessToken}" \
  -H "x-company-token: {companyToken}"

Resposta (200):

{
  "id": "clxpipe001",
  "name": "Vendas B2B",
  "description": "Pipeline principal para vendas corporativas.",
  "stages": [
    { "id": "clxstage001", "name": "Qualificacao", "order": 1 },
    { "id": "clxstage002", "name": "Negociacao", "order": 2 },
    { "id": "clxstage003", "name": "Proposta Enviada", "order": 3 },
    { "id": "clxstage004", "name": "Fechamento", "order": 4 }
  ],
  "isActive": true,
  "createdAt": "2026-01-05T08:00:00.000Z",
  "updatedAt": "2026-01-05T08:00:00.000Z"
}

Valores de Enum

type (Atividades)

Valor	Descricao
`CALL`	Ligacao telefonica
`EMAIL`	Envio de email
`MEETING`	Reuniao presencial ou virtual
`TASK`	Tarefa interna
`NOTE`	Anotacao ou observacao

status (Atividades)

Valor	Descricao
`PENDING`	Atividade pendente
`DONE`	Atividade concluida

Atividades (Activities)​

Listar Atividades​

GET /external/v1/activities​

Buscar Atividade por ID​

GET /external/v1/activities/:id​

Criar Atividade​

POST /external/v1/activities​

Atualizar Atividade​

PUT /external/v1/activities/:id​

Itens de Negocio (Deal Items)​

Listar Itens de Negocio​

GET /external/v1/deal-items​

Buscar Item de Negocio por ID​

GET /external/v1/deal-items/:id​

Criar Item de Negocio​

POST /external/v1/deal-items​

Atualizar Item de Negocio​

PUT /external/v1/deal-items/:id​

Pipelines de Negocio (Deal Pipelines)​

Listar Pipelines​

GET /external/v1/deal-pipelines​

Buscar Pipeline por ID​

GET /external/v1/deal-pipelines/:id​

Valores de Enum​

type (Atividades)​

status (Atividades)​

Atividades (Activities)

Listar Atividades

`GET /external/v1/activities`

Buscar Atividade por ID

`GET /external/v1/activities/:id`

Criar Atividade

`POST /external/v1/activities`

Atualizar Atividade

`PUT /external/v1/activities/:id`

Itens de Negocio (Deal Items)

Listar Itens de Negocio

`GET /external/v1/deal-items`

Buscar Item de Negocio por ID

`GET /external/v1/deal-items/:id`

Criar Item de Negocio

`POST /external/v1/deal-items`

Atualizar Item de Negocio

`PUT /external/v1/deal-items/:id`

Pipelines de Negocio (Deal Pipelines)

Listar Pipelines

`GET /external/v1/deal-pipelines`

Buscar Pipeline por ID

`GET /external/v1/deal-pipelines/:id`

Valores de Enum

type (Atividades)

status (Atividades)