How to Integrate Replit with Teamwork

1// check-teamwork-secrets.js
2const required = ['TEAMWORK_API_KEY', 'TEAMWORK_SITE'];
3for (const key of required) {
4  if (!process.env[key]) {
5    throw new Error(`Missing: ${key}. Add it in Replit Secrets (lock icon 🔒).`);
6  }
7}
8const site = process.env.TEAMWORK_SITE;
9if (site.startsWith('http')) {
10  console.warn('Warning: TEAMWORK_SITE should be the subdomain only, e.g., yourcompany.teamwork.com — not https://...');
11}
12console.log('Teamwork secrets configured.');
13console.log('Site:', process.env.TEAMWORK_SITE);
14console.log('API Key prefix:', process.env.TEAMWORK_API_KEY.slice(0, 8) + '...');

1// teamwork-client.js — Teamwork REST API client
2const SITE = process.env.TEAMWORK_SITE;
3const API_KEY = process.env.TEAMWORK_API_KEY;
4const AUTH = 'Basic ' + Buffer.from(`${API_KEY}:x`).toString('base64');
5const BASE_V3 = `https://${SITE}/projects/api/v3`;
6const BASE_V1 = `https://${SITE}`;
7
8async function twRequest(method, url, body = null) {
9  const options = {
10    method,
11    headers: {
12      'Authorization': AUTH,
13      'Content-Type': 'application/json',
14      'Accept': 'application/json'
15    }
16  };
17  if (body) options.body = JSON.stringify(body);
18
19  const response = await fetch(url, options);
20  if (!response.ok) {
21    const errText = await response.text();
22    throw new Error(`Teamwork API ${response.status}: ${errText}`);
23  }
24  if (response.status === 204) return null;
25  return response.json();
26}
27
28// Create a project
29async function createProject(name, description = '', companyId = null) {
30  const body = {
31    project: { name, description }
32  };
33  if (companyId) body.project.company = { id: companyId };
34  const result = await twRequest('POST', `${BASE_V3}/projects.json`, body);
35  return result?.project;
36}
37
38// Get all projects
39async function getProjects() {
40  const result = await twRequest('GET', `${BASE_V3}/projects.json`);
41  return result?.projects || [];
42}
43
44// Create a task list within a project
45async function createTaskList(projectId, name) {
46  const result = await twRequest('POST', `${BASE_V1}/projects/${projectId}/tasklists.json`, {
47    'todo-list': { name }
48  });
49  return result?.['TASKLISTID'];
50}
51
52// Create a task within a task list
53async function createTask(taskListId, title, description = '', assigneeId = null, dueDate = null) {
54  const task = { 'content': title, 'description': description };
55  if (assigneeId) task['responsible-party-id'] = assigneeId;
56  if (dueDate) task['due-date'] = dueDate; // YYYYMMDD format
57  const result = await twRequest('POST', `${BASE_V1}/tasklists/${taskListId}/tasks.json`, {
58    'todo-item': task
59  });
60  return result?.id || result?.['TASKID'];
61}
62
63// Log a time entry (v1 API)
64async function logTime(projectId, taskId, hours, minutes, date, description, personId) {
65  const body = {
66    'time-entry': {
67      description,
68      'person-id': personId,
69      date, // YYYYMMDD
70      hours: String(hours),
71      minutes: String(minutes),
72      isbillable: '1'
73    }
74  };
75  const url = taskId
76    ? `${BASE_V1}/tasks/${taskId}/time_entries.json`
77    : `${BASE_V1}/projects/${projectId}/time_entries.json`;
78  return twRequest('POST', url, body);
79}
80
81// Get time entries for a project
82async function getTimeEntries(projectId) {
83  const result = await twRequest('GET', `${BASE_V1}/projects/${projectId}/time_entries.json`);
84  return result?.['time-entries'] || [];
85}
86
87// Example
88(async () => {
89  try {
90    const projects = await getProjects();
91    console.log(`Found ${projects.length} projects`);
92    projects.slice(0, 3).forEach(p => console.log(` - ${p.id}: ${p.name}`));
93  } catch (err) {
94    console.error('Error:', err.message);
95  }
96})();
97
98module.exports = { createProject, getProjects, createTaskList, createTask, logTime, getTimeEntries };

1# teamwork_client.py — Teamwork REST API client for Replit (Python)
2import os
3import requests
4from datetime import datetime
5
6SITE = os.environ['TEAMWORK_SITE']
7API_KEY = os.environ['TEAMWORK_API_KEY']
8AUTH = (API_KEY, 'x')  # Teamwork Basic Auth: api_key as username, 'x' as password
9BASE_V3 = f'https://{SITE}/projects/api/v3'
10BASE_V1 = f'https://{SITE}'
11
12HEADERS = {'Content-Type': 'application/json', 'Accept': 'application/json'}
13
14def tw_request(method: str, url: str, body: dict = None) -> dict:
15    """Make an authenticated Teamwork API request."""
16    response = requests.request(method, url, auth=AUTH, headers=HEADERS, json=body)
17    response.raise_for_status()
18    if response.status_code == 204:
19        return {}
20    return response.json()
21
22def get_projects() -> list:
23    """Get all projects the API user has access to."""
24    result = tw_request('GET', f'{BASE_V3}/projects.json')
25    return result.get('projects', [])
26
27def create_project(name: str, description: str = '') -> dict:
28    """Create a new Teamwork project."""
29    result = tw_request('POST', f'{BASE_V3}/projects.json', {
30        'project': {'name': name, 'description': description}
31    })
32    return result.get('project', {})
33
34def create_task_list(project_id: str, name: str) -> str:
35    """Create a task list within a project. Returns the task list ID."""
36    result = tw_request('POST', f'{BASE_V1}/projects/{project_id}/tasklists.json', {
37        'todo-list': {'name': name}
38    })
39    return str(result.get('TASKLISTID', ''))
40
41def create_task(task_list_id: str, title: str,
42               description: str = '', due_date: str = None) -> str:
43    """Create a task in a task list. due_date format: YYYYMMDD"""
44    task = {'content': title, 'description': description}
45    if due_date:
46        task['due-date'] = due_date
47    result = tw_request('POST', f'{BASE_V1}/tasklists/{task_list_id}/tasks.json', {
48        'todo-item': task
49    })
50    return str(result.get('TASKID', result.get('id', '')))
51
52def log_time(project_id: str, hours: int, minutes: int,
53            description: str, date: str = None, task_id: str = None) -> dict:
54    """Log a time entry. date format: YYYYMMDD (defaults to today)."""
55    if not date:
56        date = datetime.now().strftime('%Y%m%d')
57    entry = {
58        'time-entry': {
59            'description': description,
60            'date': date,
61            'hours': str(hours),
62            'minutes': str(minutes),
63            'isbillable': '1'
64        }
65    }
66    url = (f'{BASE_V1}/tasks/{task_id}/time_entries.json'
67           if task_id else f'{BASE_V1}/projects/{project_id}/time_entries.json')
68    return tw_request('POST', url, entry)
69
70def get_time_entries(project_id: str) -> list:
71    """Get all time entries for a project."""
72    result = tw_request('GET', f'{BASE_V1}/projects/{project_id}/time_entries.json')
73    return result.get('time-entries', [])
74
75if __name__ == '__main__':
76    projects = get_projects()
77    print(f'Found {len(projects)} projects:')
78    for p in projects[:5]:
79        print(f'  {p["id"]}: {p["name"]}')

1// teamwork-server.js — Express server for Teamwork API proxy and webhooks
2const express = require('express');
3const {
4  createProject, createTaskList, createTask, logTime, getProjects
5} = require('./teamwork-client');
6const app = express();
7app.use(express.json());
8
9// POST /projects — create a project with default task lists
10app.post('/projects', async (req, res) => {
11  try {
12    const { name, description, taskLists = [] } = req.body;
13    if (!name) return res.status(400).json({ error: 'name required' });
14
15    const project = await createProject(name, description);
16    const projectId = project.id;
17    const createdLists = [];
18
19    // Create standard task lists
20    for (const listName of taskLists) {
21      const listId = await createTaskList(projectId, listName);
22      createdLists.push({ name: listName, id: listId });
23    }
24
25    res.status(201).json({ projectId, taskLists: createdLists });
26  } catch (err) {
27    console.error('Create project error:', err.message);
28    res.status(500).json({ error: err.message });
29  }
30});
31
32// GET /projects — list projects
33app.get('/projects', async (req, res) => {
34  try {
35    const projects = await getProjects();
36    res.json(projects.map(p => ({ id: p.id, name: p.name, status: p.status })));
37  } catch (err) {
38    res.status(500).json({ error: err.message });
39  }
40});
41
42// POST /time — log a time entry
43app.post('/time', async (req, res) => {
44  try {
45    const { projectId, taskId, hours, minutes, description, date } = req.body;
46    if (!projectId || hours === undefined) {
47      return res.status(400).json({ error: 'projectId and hours required' });
48    }
49    const result = await logTime(projectId, taskId, hours, minutes || 0, description, date);
50    res.status(201).json({ success: true });
51  } catch (err) {
52    res.status(500).json({ error: err.message });
53  }
54});
55
56// POST /webhook/teamwork — receive Teamwork webhook events
57app.post('/webhook/teamwork', (req, res) => {
58  res.status(200).json({ received: true }); // Respond immediately
59
60  setImmediate(() => {
61    const event = req.body;
62    const eventType = event.eventType || event.type;
63    console.log('Teamwork webhook:', eventType);
64
65    if (eventType === 'task.completed' || eventType === 'TASK_COMPLETED') {
66      const task = event.task || event.item;
67      console.log('Task completed:', task?.name, 'in project:', task?.project?.name);
68      // TODO: notify Slack, update external systems, log to analytics
69    } else if (eventType === 'time.created' || eventType === 'TIME_CREATED') {
70      const entry = event.timeEntry || event.item;
71      console.log(`Time logged: ${entry?.hours}h ${entry?.minutes}m by ${entry?.person?.name}`);
72      // TODO: update billing dashboard, check against budget
73    } else if (eventType === 'milestone.completed' || eventType === 'MILESTONE_COMPLETED') {
74      const milestone = event.milestone || event.item;
75      console.log('Milestone reached:', milestone?.name);
76      // TODO: send client update email
77    }
78  });
79});
80
81app.listen(3000, '0.0.0.0', () => {
82  console.log('Teamwork integration server running on port 3000');
83  console.log('Set webhook URL in Teamwork: https://yourapp.replit.app/webhook/teamwork');
84});