Gere o token no seu perfil do Wiboor, liste seus espaços e crie a primeira tarefa com três chamadas.
Fazer a primeira requisição
Cada endpoint da referência tem exemplos de código e um Try It para chamar a API com o seu token.
Criar uma tarefa
Conecte o Claude, o ChatGPT ou o Cursor à documentação pelo MCP Server e gere a integração com a doc oficial.
Configurar o MCP ServerLead mudou para Proposta no CRM.
', }), }); const task = await taskRes.json(); // 2. Monte o checklist, um item por chamada for (const description of ['Enviar proposta', 'Agendar reunião', 'Registrar retorno no CRM']) { await fetch(`${BASE_URL}/tasks/${task.id}/checklist`, { method: 'POST', headers, body: JSON.stringify({ description }), }); } // 3. Comente com o link do lead await fetch(`${BASE_URL}/tasks/${task.id}/comments`, { method: 'POST', headers, body: JSON.stringify({ message: 'Lead no CRM: https://crm.exemplo.com.br/leads/4821' }), }); console.log(`Tarefa #${task.taskNumber} criada`); ``` ## Resposta ```json { "id": "0197b3f0-1a2b-7c3d-8e4f-5a6b7c8d9e0f", "taskNumber": 85731, "title": "Follow-up: ACME Ltda. entrou em Proposta", "type": "TASK", "status": "NOT_STARTED", "priority": 7, "departmentId": "0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607", "userExecutorId": "0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d", "userRequesterId": "0197a1c2-0f1e-7d2c-9b3a-485960718293", "spentedTime": 0, "createdAt": "2026-11-03T14:02:11.000Z" } ``` --- # Criar um projeto com tarefas Source: https://docs.wiboor.com.br/recipes/criar-um-projeto-com-tarefas Crie as tarefas com POST /v1/tasks, agrupe-as num projeto com POST /v1/projects e vincule depois as que surgirem. ## Crie as tarefas primeiro > Linhas destacadas: 6-19 O projeto recebe uma lista de IDs de tarefas que já existem, então crie as tarefas antes, no mesmo espaço do projeto. Só tarefas `TASK` entram em projeto: um `BUG` não pode fazer parte de um projeto. ## Crie o projeto > Linhas destacadas: 21-38 A criação de projeto pede todos estes campos: `title`, `description`, `departmentId`, `userExecutorId` (o líder), `priority` (1 a 10), `endedAt` (prazo), `tasks`, `isReadyToClose` e `openReview`. Com `isReadyToClose: true`, o projeto fecha sozinho quando todas as tarefas forem finalizadas. Se `openReview` for `true`, o projeto gera uma avaliação ao terminar e `userReviewerId` (o avaliador) passa a ser obrigatório. ## Vincule tarefas depois > Linhas destacadas: 40-42 Tarefas que aparecem no meio do caminho entram com [Vincular uma tarefa a um projeto](/reference/vincular-uma-tarefa-a-um-projeto-por-id). Outra opção é criar a tarefa já com o `projectId` no `POST /v1/tasks`. ## Código ```js Node.js const BASE_URL = 'https://api.azzimuti.com.br/v1'; const headers = { Authorization: `Bearer ${process.env.WIBOOR_TOKEN}`, 'Content-Type': 'application/json', }; const departmentId = '0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607'; const leaderId = '0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d'; // 1. Crie as tarefas primeiro const titles = ['Briefing com o cliente', 'Criação das peças', 'Revisão e entrega']; const taskIds = []; for (const title of titles) { const res = await fetch(`${BASE_URL}/tasks`, { method: 'POST', headers, body: JSON.stringify({ title, type: 'TASK', departmentId, userExecutorId: leaderId }), }); taskIds.push((await res.json()).id); } // 2. Crie o projeto com os IDs das tarefas const projectRes = await fetch(`${BASE_URL}/projects`, { method: 'POST', headers, body: JSON.stringify({ title: 'Campanha de Natal — ACME', description: 'Peças da campanha de fim de ano.', departmentId, userExecutorId: leaderId, priority: 5, endedAt: '2026-12-15T21:00:00.000Z', tasks: taskIds, isReadyToClose: true, openReview: false, userReviewerId: null, }), }); const project = await projectRes.json(); // 3. Vincule uma tarefa que surgiu depois const extraTaskId = '0197b4a1-2c3d-7e4f-9a5b-6c7d8e9f0a1b'; await fetch(`${BASE_URL}/projects/${project.id}/attach/tasks/${extraTaskId}`, { method: 'POST', headers }); ``` ## Resposta ```json { "id": "0197b4a0-7d6c-7b5a-8f4e-3d2c1b0a9f8e", "projectNumber": 1612, "title": "Campanha de Natal — ACME", "status": "NOT_STARTED", "priority": 5, "endedAt": "2026-12-15T21:00:00.000Z", "isReadyToClose": true, "departmentId": "0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607", "userExecutorId": "0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d", "tasks": [ "0197b49f-0a1b-7c2d-8e3f-4a5b6c7d8e9f", "0197b49f-1b2c-7d3e-9f4a-5b6c7d8e9f0a", "0197b49f-2c3d-7e4f-8a5b-6c7d8e9f0a1b" ] } ``` --- # Listar as tarefas abertas de um usuário Source: https://docs.wiboor.com.br/recipes/listar-tarefas-abertas-de-um-usuario Percorra todas as páginas de GET /v1/tasks filtrando por executor e status, e monte um painel ou relatório com o resultado. ## Encontre o usuário > Linhas destacadas: 4-6 [Listar espaços](/reference/listar-todos-os-espacos-que-seu-usuario-esta-com-seus-membros) traz os espaços do dono do token com os membros (`users`: `id`, `name`, `email`). Guarde o `id` no seu sistema para não procurar toda vez. ## Percorra as páginas > Linhas destacadas: 8-17 [Listar tarefas](/reference/listar-todas-as-tarefas-com-filtros) é paginada: `count` vai até 100 por página e `page` começa em 1. Repita `status[]` para cada status. Pare quando `pagination.currentPage` chegar a `pagination.lastPage`. Outros filtros úteis: `projectId`, `departmentIds[]`, `search`, `startDate` e `endDate`. ## Use o resultado > Linhas destacadas: 19-21 O `endedAt` é o prazo planejado e o `taskNumber` é o número que as pessoas veem no Wiboor. Para trazer comentários ou checklist junto, use o parâmetro `join`. ## Código ```js Node.js const BASE_URL = 'https://api.azzimuti.com.br/v1'; const headers = { Authorization: `Bearer ${process.env.WIBOOR_TOKEN}` }; // 1. Descubra o ID do usuário pelos membros dos seus espaços const spaces = await (await fetch(`${BASE_URL}/departments`, { headers })).json(); const user = spaces.flatMap(space => space.users).find(u => u.email === 'ana@exemplo.com.br'); // 2. Percorra todas as páginas das tarefas abertas dele const tasks = []; for (let page = 1; ; page++) { const params = new URLSearchParams({ userExecutorId: user.id, count: '100', page: String(page) }); for (const status of ['NOT_STARTED', 'STARTED', 'PAUSED']) params.append('status[]', status); const { data, pagination } = await (await fetch(`${BASE_URL}/tasks?${params}`, { headers })).json(); tasks.push(...data); if (pagination.currentPage >= pagination.lastPage) break; } // 3. Ordene pelo prazo tasks.sort((a, b) => new Date(a.endedAt) - new Date(b.endedAt)); console.log(tasks.map(t => `#${t.taskNumber} ${t.title} (${t.status})`)); ``` ## Resposta ```json { "data": [ { "id": "0197b3f0-1a2b-7c3d-8e4f-5a6b7c8d9e0f", "taskNumber": 85731, "title": "Follow-up: ACME Ltda. entrou em Proposta", "status": "STARTED", "priority": 7, "endedAt": "2026-11-05T21:00:00.000Z" } ], "pagination": { "totalItems": 37, "perPage": 100, "currentPage": 1, "lastPage": 1 } } ``` --- # Registrar e aprovar uma ideia Source: https://docs.wiboor.com.br/recipes/registrar-e-aprovar-uma-ideia Registre sugestões vindas de outro sistema com POST /v1/ideas e aprove a ideia gerando uma tarefa com PATCH /v1/ideas/{id}/change-status. ## Registre a ideia > Linhas destacadas: 7-16 Só `description` e `departmentId` (o espaço) são obrigatórios. Use para levar ao Wiboor sugestões que chegam por formulário, pesquisa de satisfação ou chat interno. A ideia nasce como `NOT_STARTED` (não analisada). ## Coloque em análise > Linhas destacadas: 18-23 [Alterar o status de uma ideia](/reference/alterar-o-status-de-uma-ideia) aceita `NOT_STARTED` (não analisada), `STARTED` (em análise), `FINISHED` (aprovada) e `CANCELED` (arquivada). ## Aprove gerando trabalho > Linhas destacadas: 25-35 Para aprovar (`FINISHED`), informe o que a aprovação gera em `ideaType` (`task` ou `project`) e quem vai executar em `userExecutorId`: os dois são obrigatórios nesse status. Para arquivar, envie só `status: "CANCELED"`. ## Código ```js Node.js const BASE_URL = 'https://api.azzimuti.com.br/v1'; const headers = { Authorization: `Bearer ${process.env.WIBOOR_TOKEN}`, 'Content-Type': 'application/json', }; // 1. Registre a ideia no espaço da equipe const ideaRes = await fetch(`${BASE_URL}/ideas`, { method: 'POST', headers, body: JSON.stringify({ description: 'Enviar lembrete por WhatsApp um dia antes da reunião com o cliente', departmentId: '0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607', }), }); const idea = await ideaRes.json(); // 2. Coloque em análise await fetch(`${BASE_URL}/ideas/${idea.id}/change-status`, { method: 'PATCH', headers, body: JSON.stringify({ status: 'STARTED' }), }); // 3. Aprove: a ideia vira uma tarefa para o executor const approvedRes = await fetch(`${BASE_URL}/ideas/${idea.id}/change-status`, { method: 'PATCH', headers, body: JSON.stringify({ status: 'FINISHED', ideaType: 'task', userExecutorId: '0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d', }), }); const approved = await approvedRes.json(); ``` ## Resposta ```json { "id": "0197b6d3-4e5f-7a6b-8c7d-8e9f0a1b2c3d", "ideaNumber": 412, "description": "Enviar lembrete por WhatsApp um dia antes da reunião com o cliente", "status": "FINISHED", "departmentId": "0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607", "createdAt": "2026-11-03T15:20:44.000Z" } ```