Criar uma tarefa a partir de um template

Criar uma tarefa a partir do CRM

Nesta recipe

Autentique com o token
Crie a tarefa
Monte o checklist

Node.js

const BASE_URL = 'https://api.azzimuti.com.br/v1';
const headers = {
  Authorization: `Bearer ${process.env.WIBOOR_TOKEN}`,
  'Content-Type': 'application/json',
};

// 1. Crie a tarefa de follow-up para o vendedor
const taskRes = await fetch(`${BASE_URL}/tasks`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    title: 'Follow-up: ACME Ltda. entrou em Proposta',
    type: 'TASK',
    priority: 7,
    departmentId: '0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607', // espaço Comercial
    userExecutorId: '0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d', // vendedor do lead
    description: '<p>Lead mudou para <strong>Proposta</strong> no CRM.</p>',
  }),
});
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`);

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}.
4 passos
Abrir recipe: Acompanhar a execução de uma tarefa
Criar uma tarefa a partir de um template
Encontre o template com GET /v1/templates, pegue o rascunho com o prazo já calculado e crie a tarefa enviando o templateId.
3 passos
Abrir recipe: Criar uma tarefa a partir de um template
Criar uma tarefa a partir do CRM
Quando um lead muda de etapa, crie uma tarefa de follow-up com POST /v1/tasks, monte o checklist e deixe um comentário com o contexto.
4 passos
Abrir recipe: Criar uma tarefa a partir do CRM
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.
3 passos
Abrir recipe: Criar um projeto com tarefas
Listar as tarefas abertas de um usuário
Percorra todas as páginas de GET /v1/tasks filtrando por executor e status, e monte um painel ou relatório com o resultado.
3 passos
Abrir recipe: Listar as tarefas abertas de um usuário
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.
3 passos
Abrir recipe: Registrar e aprovar uma ideia

1. Encontre o template
Listar templates devolve os templates que você vê, paginados em data. Filtre por kind=TASK (ou PROJECT), por search no título e por departmentId.
2. Pegue o rascunho
Buscar um template traz o draft: para template de tarefa, { task: {...} }, com título, descrição, prioridade, checklist e o endedAt já calculado pelo prazo sugerido do template.
3. Crie a tarefa
Envie o conteúdo de draft.task (não o envelope draft), e complete o userExecutorId se ele vier nulo: é obrigatório. Mande também o templateId, que registra a origem da tarefa e conta nas métricas do template. Campos que o rascunho traz mas a criação ignora: openReview, attachments e, no checklist, assigneeId e os subitens.

Para template de projeto, o rascunho vem como { project: { ..., tasks: [...] } }: crie antes cada item de project.tasks com POST /v1/tasks e siga a recipe Criar um projeto com tarefas.

JavaScript

const BASE_URL = 'https://api.azzimuti.com.br/v1';
const headers = {
  Authorization: `Bearer ${process.env.WIBOOR_TOKEN}`,
  'Content-Type': 'application/json',
};

// 1. Encontre o template de tarefa pelo título
const listRes = await fetch(`${BASE_URL}/templates?kind=TASK&search=Fechamento%20mensal`, { headers });
const { data: templates } = await listRes.json();
const templateId = templates[0].id;

// 2. Pegue o rascunho, com o prazo calculado a partir de agora
const detailRes = await fetch(`${BASE_URL}/templates/${templateId}`, { headers });
const { draft } = await detailRes.json();

// 3. Crie a tarefa com o conteúdo de draft.task e o templateId
const taskRes = await fetch(`${BASE_URL}/tasks`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    ...draft.task,
    userExecutorId: draft.task.userExecutorId ?? '0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d',
    templateId,
  }),
});
const task = await taskRes.json();

Resposta

JSON

{
  "id": "0197b5c2-3d4e-7f5a-8b6c-7d8e9f0a1b2c",
  "taskNumber": 85740,
  "title": "Fechamento mensal — novembro",
  "type": "TASK",
  "status": "NOT_STARTED",
  "priority": 6,
  "endedAt": "2026-11-08T21:00:00.000Z",
  "userExecutorId": "0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d"
}

Acompanhar a execução de uma tarefa

Criar uma tarefa a partir de um template

Criar uma tarefa a partir do CRM

Criar um projeto com tarefas

Listar as tarefas abertas de um usuário

Registrar e aprovar uma ideia