---
agentTools:
  projectIndex: https://docs.wiboor.com.br/llms.txt
  projectSearch: https://docs.wiboor.com.br/agentSearch?query=term1%20term2
---

# Acompanhar a execução de uma tarefa

Inicie, pause e finalize uma tarefa pela API para o Wiboor medir o tempo gasto, e consulte o resultado com GET /v1/tasks/{id}.

## Execute como o dono da tarefa

> Linhas destacadas: 1-3

Iniciar, pausar e finalizar valem para o usuário do token: use o token do executor da tarefa (ou de um usuário de integração que seja o executor). Os três endpoints não têm corpo e respondem `200`.

## Inicie e pause

> Linhas destacadas: 5-9

`/start` muda o status para `STARTED` e começa a contar o tempo; `/pause` muda para `PAUSED` e para o relógio. É o mesmo que o executor faz pelos botões no Wiboor, então dá para ligar a tarefa ao seu sistema de ponto, ao help desk ou a um timer próprio.

## Retome e finalize

> Linhas destacadas: 11-13

Para retomar uma tarefa pausada, chame `/start` de novo. `/end` muda o status para `FINISHED` e registra o `finishedAt`.

## Consulte o resultado

> Linhas destacadas: 15-18

[Buscar uma tarefa por ID](/reference/buscar-uma-tarefa-por-id) traz o `status` e o `spentedTime`, o tempo gasto executando a tarefa. Para listar várias de uma vez, filtre [Listar tarefas](/reference/listar-todas-as-tarefas-com-filtros) por `status[]=FINISHED` e período.

## Código

```js Node.js
const BASE_URL = 'https://api.azzimuti.com.br/v1';
const headers = { Authorization: `Bearer ${process.env.WIBOOR_TOKEN}` };
const taskId = '0197b3f0-1a2b-7c3d-8e4f-5a6b7c8d9e0f';

// 1. Comece a executar: o relógio da tarefa começa a contar
await fetch(`${BASE_URL}/tasks/${taskId}/start`, { method: 'POST', headers });

// 2. Pause quando o trabalho parar (almoço, outra prioridade)
await fetch(`${BASE_URL}/tasks/${taskId}/pause`, { method: 'POST', headers });

// 3. Retome com o mesmo /start e finalize no fim
await fetch(`${BASE_URL}/tasks/${taskId}/start`, { method: 'POST', headers });
await fetch(`${BASE_URL}/tasks/${taskId}/end`, { method: 'POST', headers });

// 4. Consulte o status e o tempo gasto
const res = await fetch(`${BASE_URL}/tasks/${taskId}`, { headers });
const task = await res.json();
console.log(task.status, task.spentedTime, task.finishedAt);
```

## Resposta

```json
{
  "id": "0197b3f0-1a2b-7c3d-8e4f-5a6b7c8d9e0f",
  "taskNumber": 85731,
  "title": "Follow-up: ACME Ltda. entrou em Proposta",
  "status": "FINISHED",
  "spentedTime": 5400,
  "finishedAt": "2026-11-03T17:45:02.000Z"
}
```