Tarefas e Comentários

A produtividade das equipes e o registro de histórico de interações dentro do card são gerenciados pelas APIs de Tarefas e Comentários.

Módulo de Tarefas (Tasks)

As tarefas ajudam a organizar prazos de follow-up, lembretes de ligação e atividades pendentes.

1. Listar Minhas Tarefas

Retorna todas as tarefas atribuídas ao usuário autenticado, ordenadas por data de vencimento (dueDate:asc).

• Método: GET
• Caminho: /tasks/my-tasks

2. Criar Tarefa

Associa uma tarefa a um card ou a um board. Se a propriedade assignees (membros responsáveis) for omitida, a tarefa é automaticamente atribuída ao criador do registro.

• Método: POST
• Caminho: /tasks
• Payload de Exemplo:

  {
    "data": {
      "name": "Enviar contrato atualizado",
      "description": "Lembrar de anexar a proposta comercial revisada em PDF.",
      "dueDate": "2026-07-15T12:00:00Z",
      "type": "follow-up",
      "card": "card_doc_id_999",
      "assignees": ["membership_doc_id_vendedor"]
    }
  }

3. Atualizar Status da Tarefa

Altera os dados de uma tarefa. Marcar um status de conclusão como completed atualizará a propriedade completedAt no servidor de forma automática.

• Método: PUT
• Caminho: /tasks/{id}
• Payload:

  {
    "data": {
      "taskStatus": "completed"
    }
  }

Módulo de Comentários

Os comentários registram anotações manuais dos vendedores ou notas geradas automaticamente pelo sistema (ex: histórico de movimentação de fase).

1. Listar Comentários de um Card

Retorna os comentários associados a um card específico.

• Método: GET
• Caminho: /comments
• Parâmetro de Consulta:
  • filters[card][documentId]: O documentId do card (filtro obrigatório para otimização de busca).

curl -G "https://api.perpetuus.com.br/api/comments" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "x-tenant-id: acme" \
  --data-urlencode "filters[card][documentId]=card_document_id_xyz"

2. Adicionar Comentário no Card

Cria um novo comentário. Suporta menções a outros membros usando o documentId de seus memberships. O conteúdo pode ser enviado em texto puro ou em HTML sanitizado.

• Método: POST
• Caminho: /comments
• Payload de Exemplo:

  {
    "data": {
      "card": "card_document_id_xyz",
      "content": "Reunião de alinhamento com a diretoria realizada hoje. <a href='https://link.com'>Minuta da reunião</a>.",
      "contentFormat": "html",
      "mentions": ["membership_id_diretor_comercial"]
    }
  }