curl "https://crm.vistum.com.br/api/v1/tasks?status=pending&sort=dueAt&order=asc" \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"
{
"data": [
{
"id": "task_1",
"title": "Ligar para retomar proposta",
"type": "call",
"dueDate": "2026-07-22T13:00:00.000Z",
"status": "pending",
"contactId": "cnt_cmnl5abc123",
"cardId": "card_def456ghi",
"assignedTo": { "id": "usr_carlos", "name": "Carlos Atendente" },
"createdAt": "2026-07-21T10:00:00.000Z"
}
],
"pagination": { "total": 1, "limit": 25, "offset": 0, "hasMore": false }
}
Tarefas
Listar tarefas
Lista tarefas e follow-ups do workspace com filtros por contato, negócio, status, responsável e vencimento.
GET
/
api
/
v1
/
tasks
curl "https://crm.vistum.com.br/api/v1/tasks?status=pending&sort=dueAt&order=asc" \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"
{
"data": [
{
"id": "task_1",
"title": "Ligar para retomar proposta",
"type": "call",
"dueDate": "2026-07-22T13:00:00.000Z",
"status": "pending",
"contactId": "cnt_cmnl5abc123",
"cardId": "card_def456ghi",
"assignedTo": { "id": "usr_carlos", "name": "Carlos Atendente" },
"createdAt": "2026-07-21T10:00:00.000Z"
}
],
"pagination": { "total": 1, "limit": 25, "offset": 0, "hasMore": false }
}
Uma tarefa (
Task) é um follow-up com prazo, opcionalmente vinculado a um contato e/ou negócio e atribuído a um membro.
Autenticação
string
required
Bearer vg_live_<sua_chave> — API Key com escopo tasks:readParâmetros de query
| Parâmetro | Tipo | Descrição |
|---|---|---|
contactId | string | Tarefas de um contato. |
cardId | string | Tarefas de um negócio. |
status | string | pending ou done. |
assignedTo | string | ID do usuário responsável. |
dueAfter | string (ISO) | Vencimento a partir desta data. |
dueBefore | string (ISO) | Vencimento até esta data. |
sort | string | dueAt (padrão), createdAt ou updatedAt. |
order | string | asc (padrão) ou desc. |
limit / offset | number | Paginação (1–100, padrão 25). |
curl "https://crm.vistum.com.br/api/v1/tasks?status=pending&sort=dueAt&order=asc" \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI"
{
"data": [
{
"id": "task_1",
"title": "Ligar para retomar proposta",
"type": "call",
"dueDate": "2026-07-22T13:00:00.000Z",
"status": "pending",
"contactId": "cnt_cmnl5abc123",
"cardId": "card_def456ghi",
"assignedTo": { "id": "usr_carlos", "name": "Carlos Atendente" },
"createdAt": "2026-07-21T10:00:00.000Z"
}
],
"pagination": { "total": 1, "limit": 25, "offset": 0, "hasMore": false }
}