Overview
Atividades são os compromissos da agenda — ligação, reunião, visita, tarefa — sempre vinculados a uma oportunidade. Cada atividade tem um tipo, data e hora, duração e um estado próprio: open (aberta), late (atrasada) ou done (concluída).
Rotas
Fluxo típico
- Consulte os tipos em
GET /activities/typese guarde oiddo tipo desejado. - Crie com
POST /activities, informandobudget(ID da oportunidade),activity(ID do tipo) edate(YYYY-MM-DD HH:mm:ss). - Leia a agenda com
GET /activities, usandostarteend, para obter o ID da atividade criada. - Conclua com
PATCH /activities/status(status: "done") ou mude a data comPATCH /activities/date.
Cuidados
- A criação não devolve o ID da atividade. A resposta identifica a oportunidade; o ID sai da listagem da agenda.
- Atividade nasce com o usuário do token como responsável.
- Operações em lote. As rotas
PATCHrecebemidscomo lista ([301,302]) ou texto ("301,302"), nunca vazio. - Reagendamento tem limites. Atividade concluída ou bloqueada não pode ser reagendada; a resposta é 400 com
ACTIVITY_MUTATION_FAILED. - Etapa da atividade ≠ etapa do funil.
PATCH /activities/stageusa o fluxo de atividades da conta e exige o módulo Gestão de Atividades ativo. - Filtro padrão da agenda. Sem
responsible, a listagem traz só as atividades do usuário autenticado; semstatus, trazopen,lateedone.
