Atividades, Arquivos e Histórico

Atividades (todos)

Uma atividade é uma tarefa vinculada a um negócio: uma ligação, uma reunião, um follow-up.

Tipos válidos

`type`	Uso
`Ligação`	Contato por telefone
`Reunião`	Encontro agendado
`Follow-up`	Retomada de contato
`Tarefa`	Genérico — é o padrão quando `type` é omitido

Um type fora desta lista retorna 400. Os valores são exatamente estes, acentuados.

O objeto Atividade

string

UUID da atividade

deal_id

string

UUID do negócio

type

string

Tipo da atividade

text

string

Descrição da atividade

due_at

string

Prazo (ISO 8601), ou ausente

booking_id

string

UUID do agendamento no módulo Agendamentos, quando a atividade nasceu de uma reunião marcada

done

boolean

Se a atividade foi concluída

overdue

boolean

Calculado na leitura: true quando a atividade está pendente e due_at já passou

Listar atividades

GET /backend/pipeline/deals/{id}/todos

Requer pipeline.view.

Criar atividade

POST /backend/pipeline/deals/{id}/todos

Requer pipeline.deals.edit.

text

string

Descrição da atividade. Quando omitida ou vazia, usa o próprio type como descrição.

type

string

padrão:"Tarefa"

Um dos tipos válidos acima

due_at

string

Prazo (ISO 8601)

booking_id

string

UUID de um agendamento já criado em Agendamentos, para vincular a atividade à reunião real

curl -X POST "https://api.leavo.ai/backend/pipeline/deals/dd0e8400-e29b-41d4-a716-446655440000/todos" \
  -H "Authorization: Bearer sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Ligação",
    "text": "Retornar sobre a proposta",
    "due_at": "2026-07-25T14:00:00Z"
  }'

{
  "id": "110e8400-e29b-41d4-a716-446655440000",
  "deal_id": "dd0e8400-e29b-41d4-a716-446655440000",
  "type": "Ligação",
  "text": "Retornar sobre a proposta",
  "due_at": "2026-07-25T14:00:00Z",
  "done": false,
  "overdue": false,
  "created_at": "2026-07-21T10:00:00Z"
}

Atualizar atividade

PUT /backend/pipeline/todos/{id}

Requer pipeline.deals.edit. Campos omitidos permanecem inalterados.

text

string

Nova descrição. Se enviada, não pode ser vazia — nesse caso a resposta é 400.

done

boolean

Marca ou desmarca como concluída

due_at

string

Novo prazo (ISO 8601)

O type de uma atividade não pode ser alterado depois de criada.

Excluir atividade

DELETE /backend/pipeline/todos/{id}

Requer pipeline.deals.edit. Retorna { "success": true }.

Arquivos

Os anexos seguem o padrão de duas fases já usado no restante da plataforma: primeiro o arquivo é enviado para Upload de Arquivos, depois o upload_id resultante é vinculado ao negócio.

Enviar o arquivo

POST /backend/uploads com o arquivo. O upload nasce com status PENDING.

Vincular ao negócio

POST /backend/pipeline/deals/{id}/files com o upload_id. O upload passa a ASSOCIATED.

Listar arquivos

GET /backend/pipeline/deals/{id}/files

Requer pipeline.view.

[
  {
    "id": "220e8400-e29b-41d4-a716-446655440000",
    "upload_id": "330e8400-e29b-41d4-a716-446655440000",
    "filename": "proposta-comercial.pdf",
    "file_url": "https://storage.leavo.ai/...",
    "mime_type": "application/pdf",
    "size": 148392,
    "created_at": "2026-07-21T10:05:00Z"
  }
]

Anexar arquivo

POST /backend/pipeline/deals/{id}/files

Requer pipeline.deals.edit.

upload_id

string

obrigatório

UUID do upload retornado pela etapa anterior

curl -X POST "https://api.leavo.ai/backend/pipeline/deals/dd0e8400-e29b-41d4-a716-446655440000/files" \
  -H "Authorization: Bearer sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{ "upload_id": "330e8400-e29b-41d4-a716-446655440000" }'

Retorna 201 Created com o arquivo.

Remover arquivo

DELETE /backend/pipeline/deal-files/{id}

Requer pipeline.deals.edit. O {id} é o id do anexo (DealFile), não o upload_id.

Histórico (eventos)

Cada negócio mantém um log de eventos persistido — não derivado em tempo de leitura. É o que alimenta a aba de histórico do negócio.

GET /backend/pipeline/deals/{id}/events

Requer pipeline.view. Resposta paginada.

Query Parameters

page

integer

padrão:"1"

Página desejada

limit

integer

padrão:"50"

Itens por página. Valores fora de 1–200 voltam ao padrão de 50.

Tipos de evento

`event_type`	Quando acontece
`deal_created`	Negócio criado
`stage_moved`	Movido para outra etapa
`deal_won`	Movido para a etapa de ganho
`deal_lost`	Movido para a etapa de perda
`note_added`	Observação alterada
`todo_created`	Atividade criada
`todo_completed`	Atividade concluída
`owner_changed`	Responsável alterado
`tag_added`	Tag adicionada
`tag_removed`	Tag removida
`file_attached`	Arquivo anexado
`file_removed`	Arquivo removido
`meeting_booked`	Reunião agendada
`products_updated`	Produtos do negócio alterados

Autor do evento (`actor_type`)

Valor	Significado
`user`	Uma pessoa autenticada
`ai`	O assistente de IA
`system`	Ação automática — por exemplo, um negócio criado por webhook de entrada

{
  "data": [
    {
      "id": "440e8400-e29b-41d4-a716-446655440000",
      "event_type": "deal_lost",
      "title": "Negócio marcado como perdido",
      "description": "Motivo: Fechou com concorrente",
      "actor_type": "user",
      "actor_name": "Ana Ribeiro",
      "metadata": {
        "from_stage_id": "cc0e8400-e29b-41d4-a716-446655440000",
        "to_stage_id": "cc3e8400-e29b-41d4-a716-446655440000"
      },
      "created_at": "2026-07-21T09:40:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 8,
    "has_next": false,
    "has_prev": false
  }
}

Visão Geral

Leads

Status

Tags

Pipeline (CRM)

Webhooks

Campos Personalizados

Cadências

Conversas

Mensagens

Departamentos

Upload de Arquivos

Templates (Meta/Gupshup)

Follow-up

Atividades, Arquivos e Histórico

Atividades (todos)

Tipos válidos

O objeto Atividade

Listar atividades

Criar atividade

Atualizar atividade

Excluir atividade

Arquivos

Listar arquivos

Anexar arquivo

Remover arquivo

Histórico (eventos)

Query Parameters

Tipos de evento

Autor do evento (`actor_type`)

​Atividades (todos)

​Tipos válidos

​O objeto Atividade

​Listar atividades

​Criar atividade

​Atualizar atividade

​Excluir atividade

​Arquivos

​Listar arquivos

​Anexar arquivo

​Remover arquivo

​Histórico (eventos)

​Query Parameters

​Tipos de evento

​Autor do evento (actor_type)

Atividades (todos)

Tipos válidos

O objeto Atividade

Listar atividades

Criar atividade

Atualizar atividade

Excluir atividade

Arquivos

Listar arquivos

Anexar arquivo

Remover arquivo

Histórico (eventos)

Query Parameters

Tipos de evento

Autor do evento (`actor_type`)