> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.wbudget.app/w-budget/atividades/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.wbudget.app/_mcp/server. # 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 | Método | Rota | Para quê | | ------- | -------------------- | ---------------------------------------------------------------------------------------------------------- | | `GET` | `/activities` | [Listar atividades](/w-budget/atividades/listar-atividades) de um período, por responsável, estado e tipo. | | `POST` | `/activities` | [Criar atividade](/w-budget/atividades/criar-atividade) numa oportunidade. | | `PATCH` | `/activities/status` | [Alterar status da atividade](/w-budget/atividades/alterar-status-da-atividade), em uma ou várias. | | `PATCH` | `/activities/date` | [Reagendar atividade](/w-budget/atividades/reagendar-atividade), em uma ou várias. | | `PATCH` | `/activities/stage` | [Mover atividade de etapa](/w-budget/atividades/mover-atividade-de-etapa) (módulo Gestão de Atividades). | | `GET` | `/activities/types` | [Listar tipos de atividade](/w-budget/atividades/listar-tipos-de-atividade). | ## Fluxo típico 1. Consulte os tipos em `GET /activities/types` e guarde o `id` do tipo desejado. 2. Crie com `POST /activities`, informando `budget` (ID da oportunidade), `activity` (ID do tipo) e `date` (`YYYY-MM-DD HH:mm:ss`). 3. Leia a agenda com `GET /activities`, usando `start` e `end`, para obter o ID da atividade criada. 4. Conclua com `PATCH /activities/status` (`status: "done"`) ou mude a data com `PATCH /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 `PATCH` recebem `ids` como 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/stage` usa 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; sem `status`, traz `open`, `late` e `done`. ## API Docs - [Listar atividades](https://developers.wbudget.app/w-budget/atividades/listar-atividades.md): Atividades - [Criar atividade](https://developers.wbudget.app/w-budget/atividades/criar-atividade.md): Atividades - [Alterar status da atividade](https://developers.wbudget.app/w-budget/atividades/alterar-status-da-atividade.md): Atividades - [Reagendar atividade](https://developers.wbudget.app/w-budget/atividades/reagendar-atividade.md): Atividades - [Mover atividade de etapa](https://developers.wbudget.app/w-budget/atividades/mover-atividade-de-etapa.md): Atividades - [Listar tipos de atividade](https://developers.wbudget.app/w-budget/atividades/listar-tipos-de-atividade.md): Atividades ## OpenAPI Specification - [OpenAPI JSON](https://developers.wbudget.app/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format - [OpenAPI YAML](https://developers.wbudget.app/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format