Skip to main content

Endpoint

GET /v1/tasks
Escopo necessário: read:tasks — disponível nos planos Growth e Scale

Parâmetros de query

ParâmetroTipoDescrição
limitintegerItens por página. Padrão: 25. Máximo: 100
cursorstringToken de paginação
statusstringpending, overdue, completed
typestringcall, meeting, task, deadline, email, lunch, visit, message
prioritystringlow, medium, high, urgent
assigned_tostringID do responsável
deal_idstringID do negócio vinculado
contact_idstringID do contato vinculado
due_beforestringISO 8601
due_afterstringISO 8601

Exemplo de requisição

curl "https://api.socialsell.ai/v1/tasks?status=overdue&priority=high" \
  -H "Authorization: Bearer sk_live_..."

Exemplo de resposta

{
  "data": [
    {
      "id": "664d2e3f4a5b6c7890123456",
      "title": "Ligar para João sobre proposta",
      "description": "Confirmar detalhes do contrato e data de assinatura",
      "type": "call",
      "priority": "high",
      "status": "overdue",
      "assigned_to": {
        "id": "664a1b2c3d4e5f6789012345",
        "name": "Maria Santos"
      },
      "deal": {
        "id": "664c1d2e3f4a5b6789012347",
        "title": "Proposta Enterprise ACME"
      },
      "contact": {
        "id": "664f1a2b3c4d5e6f78901234",
        "name": "João Silva"
      },
      "company": null,
      "due_date": "2026-06-08T14:00:00.000Z",
      "completed_at": null,
      "created_at": "2026-06-01T09:00:00.000Z",
      "updated_at": "2026-06-01T09:00:00.000Z"
    }
  ],
  "meta": {
    "total": 23,
    "has_more": false,
    "next_cursor": null
  }
}

Objeto tarefa

CampoTipoDescrição
idstringID da tarefa
titlestringTítulo
descriptionstring|nullDescrição
typestringcall, meeting, task, deadline, email, lunch, visit, message
prioritystringlow, medium, high, urgent
statusstringpending, overdue, completed
assigned_toobject|nullResponsável {id, name}
dealobject|nullNegócio vinculado {id, title}
contactobject|nullContato vinculado {id, name}
companyobject|nullEmpresa vinculada {id, name}
due_datestring|nullData limite
completed_atstring|nullData de conclusão
created_atstringTimestamp de criação
updated_atstringTimestamp de atualização

Regras de status

StatusCondição
completedisCompleted = true
overdueisCompleted = false e dueDate < agora
pendingisCompleted = false e dueDate >= agora