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

string

UUID do negócio

string

Tipo da atividade

string

Descrição da atividade

string

Prazo (ISO 8601), ou ausente

string

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

boolean

Se a atividade foi concluída

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.

string

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

string

padrão:"Tarefa"

Um dos tipos válidos acima

string

Prazo (ISO 8601)

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.

string

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

boolean

Marca ou desmarca como concluída

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.

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

integer

padrão:"1"

Página desejada

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

Base de Conhecimento

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`)