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. Autentique com o token
Todas as chamadas vão para https://api.azzimuti.com.br/v1 com o token de API no header Authorization: Bearer. A tarefa é aberta em nome do dono do token (o solicitante); use um usuário de integração se quiser que ela apareça como aberta pelo CRM. Veja Autenticação.
2. Crie a tarefa
title, type e userExecutorId são obrigatórios. O departmentId e o userExecutorId saem de Listar espaços: o executor precisa ser membro do espaço. A description aceita HTML. Guarde o id da resposta junto do lead, para não criar a mesma tarefa duas vezes se o lead voltar de etapa.
3. Monte o checklist
Cada item é um POST /v1/tasks/{id}/checklist com a description. Depois, o executor marca os itens no Wiboor, ou o seu sistema marca com Marcar um item do checklist.
4. Comente com o contexto
O comentário aparece no histórico da tarefa para o executor. Use-o para o link do lead e para o que mudou desde a última etapa. O taskNumber é o número que as pessoas veem no Wiboor.

JavaScript

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`);

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"
}

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