Eventos Disponiveis

Tabela de Eventos

Evento	Descricao	Trigger
`person.created`	Nova pessoa cadastrada	Criacao via API ou painel
`person.updated`	Dados de pessoa atualizados	Atualizacao via API ou painel
`person.inactivated`	Pessoa inativada	Inativacao via painel
`deal.created`	Novo negocio criado	Criacao via API ou painel
`deal.updated`	Negocio atualizado (dados ou estagio)	Atualizacao via API ou painel
`deal.stage_changed`	Negocio movido para outro estagio no pipeline	Mudanca de estagio
`deal.won`	Negocio ganho (fechamento com sucesso)	Marcacao como ganho
`deal.lost`	Negocio perdido	Marcacao como perdido
`financial.created`	Lancamento financeiro criado	Criacao via API ou painel
`financial.settled`	Lancamento liquidado (pagamento confirmado)	Baixa manual ou automatica
`financial.overdue`	Lancamento vencido	Processamento diario de vencimentos
`financial.cancelled`	Lancamento cancelado	Cancelamento via painel
`product.created`	Novo produto cadastrado	Criacao via API ou painel
`product.updated`	Produto atualizado	Atualizacao via API ou painel
`project.created`	Novo projeto criado	Criacao via API ou painel
`project.status_changed`	Status do projeto alterado	Mudanca de status
`lead.created`	Novo lead cadastrado	Criacao via API ou painel
`lead.converted`	Lead convertido em negocio	Conversao via painel
`quote.created`	Nova proposta criada	Criacao via API ou painel
`quote.sent`	Proposta enviada ao cliente	Envio via painel
`quote.accepted`	Proposta aceita pelo cliente	Aceite via painel ou portal
`quote.rejected`	Proposta rejeitada pelo cliente	Rejeicao via painel ou portal
`contract.created`	Novo contrato criado	Criacao via API ou painel
`contract.activated`	Contrato ativado	Assinatura confirmada
`contract.terminated`	Contrato encerrado	Encerramento via painel
`ticket.created`	Novo ticket de suporte	Criacao via API, painel ou portal
`ticket.updated`	Ticket atualizado (status ou dados)	Atualizacao via API ou painel
`ticket.resolved`	Ticket resolvido	Resolucao via painel
`invoice.created`	Nova nota fiscal criada	Criacao via API ou painel
`invoice.sent`	Nota fiscal enviada	Envio via painel
`measurement.created`	Nova medicao criada	Criacao via API ou painel
`measurement.approved`	Medicao aprovada	Aprovacao via painel
`employee.created`	Novo perfil de colaborador	Criacao via API ou painel
`employee.updated`	Perfil de colaborador atualizado	Atualizacao via API ou painel
`timesheet.submitted`	Periodo de timesheet submetido	Submissao via painel
`timesheet.approved`	Periodo de timesheet aprovado	Aprovacao via painel
`purchase_order.created`	Nova ordem de compra	Criacao via API ou painel
`purchase_order.approved`	Ordem de compra aprovada	Aprovacao via painel
`accounting.entry_posted`	Lancamento contabil publicado	Publicacao via painel

Estrutura do Payload

Todos os eventos seguem a mesma estrutura base:

{
  "id": "evt_clx123abc456",
  "event": "nome.do.evento",
  "timestamp": "2026-03-25T10:30:00.000Z",
  "data": { }
}

Campo	Tipo	Descricao
`id`	`string`	Identificador unico do evento (para idempotencia)
`event`	`string`	Nome do evento
`timestamp`	`string`	Data/hora do evento (ISO 8601)
`data`	`object`	Dados do recurso afetado

Exemplos de Payload por Evento

person.created

{
  "id": "evt_clx001",
  "event": "person.created",
  "timestamp": "2026-03-25T10:30:00.000Z",
  "data": {
    "id": "clx2b3c4d5e6f7g8h9i0j1k2",
    "name": "Maria Oliveira",
    "socialName": null,
    "documentNumber": "12345678901",
    "personType": "INDIVIDUAL",
    "email": "maria@email.com",
    "phone": "+5521988887777",
    "classifications": ["CUSTOMER"],
    "isActive": true
  }
}

deal.created

{
  "id": "evt_clx002",
  "event": "deal.created",
  "timestamp": "2026-03-25T11:00:00.000Z",
  "data": {
    "id": "clx3c4d5e6f7g8h9i0j1k2l3",
    "code": "NEG-1042",
    "title": "Implantacao Tesselys - Tech Solutions",
    "customerId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "customerName": "Tech Solutions Ltda",
    "dealType": "COMMERCIAL",
    "dealPipelineId": "clxpipe001",
    "dealStageId": "clxstage001",
    "amount": 85000.00,
    "isActive": true
  }
}

deal.stage_changed

{
  "id": "evt_clx003",
  "event": "deal.stage_changed",
  "timestamp": "2026-03-25T14:00:00.000Z",
  "data": {
    "id": "clx3c4d5e6f7g8h9i0j1k2l3",
    "code": "NEG-1042",
    "title": "Implantacao Tesselys - Tech Solutions",
    "previousStageId": "clxstage001",
    "previousStageName": "Qualificacao",
    "currentStageId": "clxstage003",
    "currentStageName": "Proposta Enviada"
  }
}

deal.won

{
  "id": "evt_clx004",
  "event": "deal.won",
  "timestamp": "2026-03-25T16:00:00.000Z",
  "data": {
    "id": "clx3c4d5e6f7g8h9i0j1k2l3",
    "code": "NEG-1042",
    "title": "Implantacao Tesselys - Tech Solutions",
    "customerId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "customerName": "Tech Solutions Ltda",
    "amount": 85000.00,
    "wonAt": "2026-03-25T16:00:00.000Z"
  }
}

financial.created

{
  "id": "evt_clx005",
  "event": "financial.created",
  "timestamp": "2026-03-25T09:00:00.000Z",
  "data": {
    "id": "clx5e6f7g8h9i0j1k2l3m4n5",
    "code": "REC-2030",
    "title": "Fatura Mensal - Tech Solutions",
    "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "personName": "Tech Solutions Ltda",
    "typeCategory": "REVENUE",
    "status": "PENDING",
    "originalAmount": 8500.00,
    "originalDueDate": "2026-03-31T00:00:00.000Z",
    "paymentMethod": "BANK_SLIP"
  }
}

financial.settled

{
  "id": "evt_clx006",
  "event": "financial.settled",
  "timestamp": "2026-03-28T10:00:00.000Z",
  "data": {
    "id": "clx5e6f7g8h9i0j1k2l3m4n5",
    "code": "REC-2030",
    "title": "Fatura Mensal - Tech Solutions",
    "personId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "typeCategory": "REVENUE",
    "status": "SETTLED",
    "originalAmount": 8500.00,
    "paidAmount": 8500.00,
    "paymentDate": "2026-03-28T10:00:00.000Z"
  }
}

project.status_changed

{
  "id": "evt_clx007",
  "event": "project.status_changed",
  "timestamp": "2026-03-25T15:00:00.000Z",
  "data": {
    "id": "clxa0j1k2l3m4n5o6p7q8r9s0",
    "code": "PRP-1015",
    "title": "Implantacao Tesselys - Fase 2",
    "previousStatus": "PLANNING",
    "currentStatus": "IN_PROGRESS",
    "responsibleId": "clxuser001",
    "responsibleName": "Carlos Silva"
  }
}

lead.converted

{
  "id": "evt_clx008",
  "event": "lead.converted",
  "timestamp": "2026-03-26T09:30:00.000Z",
  "data": {
    "id": "clxlead001",
    "title": "TechCorp - Projeto Software",
    "status": "CONVERTED",
    "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
    "dealCode": "NEG-1044",
    "convertedAt": "2026-03-26T09:30:00.000Z"
  }
}

quote.accepted

{
  "id": "evt_clx009",
  "event": "quote.accepted",
  "timestamp": "2026-03-26T14:00:00.000Z",
  "data": {
    "id": "clxquote001",
    "code": "COT-1015",
    "title": "Proposta Implantacao Fase 2",
    "dealId": "clx3c4d5e6f7g8h9i0j1k2l3",
    "totalAmount": 85000.00,
    "status": "ACCEPTED",
    "acceptedAt": "2026-03-26T14:00:00.000Z"
  }
}

ticket.created

{
  "id": "evt_clx010",
  "event": "ticket.created",
  "timestamp": "2026-03-26T10:15:00.000Z",
  "data": {
    "id": "clxticket001",
    "code": "TKT-0042",
    "title": "Tela de login nao carrega",
    "category": "INCIDENT",
    "priority": "HIGH",
    "status": "OPEN",
    "requestedByPersonId": "clx1a2b3c4d5e6f7g8h9i0j1",
    "requestedByName": "Tech Solutions Ltda"
  }
}

contract.activated

{
  "id": "evt_clx011",
  "event": "contract.activated",
  "timestamp": "2026-03-26T16:00:00.000Z",
  "data": {
    "id": "clxcontract001",
    "title": "Contrato Mensal - Tech Solutions",
    "status": "ACTIVE",
    "monthlyAmount": 85000.00,
    "startDate": "2026-04-01T00:00:00.000Z",
    "endDate": "2027-03-31T00:00:00.000Z",
    "activatedAt": "2026-03-26T16:00:00.000Z"
  }
}

accounting.entry_posted

{
  "id": "evt_clx012",
  "event": "accounting.entry_posted",
  "timestamp": "2026-03-26T18:00:00.000Z",
  "data": {
    "id": "clxjournal001",
    "code": "LC-2026-0315",
    "description": "Receita de servico - Tech Solutions",
    "entryDate": "2026-03-26",
    "status": "POSTED",
    "totalDebit": 85000.00,
    "totalCredit": 85000.00,
    "isAutomatic": true
  }
}

Observacoes

Eventos sao enviados em tempo real (geralmente em menos de 1 segundo apos a acao)
O campo data contem um subconjunto dos campos do recurso, otimizado para o evento
Para obter o recurso completo apos receber o evento, faca um GET no endpoint correspondente usando o id do data
Eventos de inactivated e cancelled indicam soft delete — o recurso continua existindo, mas com isActive: false ou status terminal

Tabela de Eventos​

Estrutura do Payload​

Exemplos de Payload por Evento​

person.created​

deal.created​

deal.stage_changed​

deal.won​

financial.created​

financial.settled​

project.status_changed​

lead.converted​

quote.accepted​

ticket.created​

contract.activated​

accounting.entry_posted​

Observacoes​

Tabela de Eventos

Estrutura do Payload

Exemplos de Payload por Evento

person.created

deal.created

deal.stage_changed

deal.won

financial.created

financial.settled

project.status_changed

lead.converted

quote.accepted

ticket.created

contract.activated

accounting.entry_posted

Observacoes