Teamwork.com for Unblockd: available on request
Teamwork.com is available on request. Link a Teamwork.com project to an Unblockd project and its tasks come in as tasks, with their status kept in step.
Updated · About the Teamwork.com integration
On this page
Available on request
Teamwork.com is available on request while Teamwork.com approves Unblockd’s app, so most workspaces can’t connect it yet. Request it, and we email you if it becomes available for your workspace. The rest of this guide shows how it works from then on.
What Unblockd reads
Unblockd reads your Teamwork.com projects and the tasks in the ones you link to an Unblockd project. You choose which tasks to bring in; each becomes a task under a deliverable, with a link back to Teamwork.com as its first proof. From then on its status follows Teamwork.com.
It’s read-only. Unblockd never creates, edits, or deletes tasks in Teamwork.com.
A task that’s blocked in Teamwork.com opens a blocker your team sees first. Nothing reaches your sponsor until someone on your team chooses to share it.
The access token is encrypted before it’s stored. How Unblockd handles your data.
Before you start
- In Unblockd, a workspace admin connects Teamwork.com, once for the whole workspace. Members see it in Settings but can’t connect or disconnect it. Anyone on the team can then link it to a project.
- In Teamwork.com: A Teamwork.com user on the site whose projects you want to link. Unblockd reads what that user can see.
Request Teamwork.com
- Open Connected toolsSign in to Unblockd and open Settings, then Connected tools. Anyone on the team can request, not only admins.
- Press Request this connector beside Teamwork.comFind Teamwork.com in the list or type its name in the search box, then press Request this connector on its row. The row says Requested from then on. Signed out, use the request form on the Teamwork.com integration page.
- Watch for our emailWe read every request, and we email you if Teamwork.com becomes available for your workspace. Then a workspace admin presses Connect on its row and approves read access in Teamwork.com.
Link it to a project
- Open the project’s Sources tabOpen the project from Projects, then its Sources tab.
- Press Link a sourceIt’s under the list of linked sources. If more than one tool is connected, choose Teamwork.com under Tool.
- Pick the Teamwork.com projectUnder Teamwork.com project, pick the one this Unblockd project runs on. Only projects the connection can see are listed, and ones already linked here are left out.
- Choose where items landUnder New items land in, choose a deliverable, or leave Choose each time. It’s the first choice when you bring items in, and where new items go if automatic import is on.
- Press LinkThe Teamwork.com project appears in the Sources list, ready to bring items in.
Starting a new project? On New project, open “Bring work in from a tool”, choose Teamwork.com and the project, and leave “Bring in open items as tasks” on to start with its open tasks. It’s linked as the project is created.
Bring in items
- Press Bring in itemsOn the project’s Sources tab, press Bring in items on the Teamwork.com project’s row. Unblockd lists the open tasks that aren’t in this project yet.
- Choose the deliverableUnder Add them under, choose the deliverable they belong to. Each item comes in as a task under it.
- Choose the tasksTick the tasks you want, search by key or title, or press Choose all. Then press Bring in. Up to 50 come in at a time; run it again for more.
New tasks can also come in on their own. An admin turns on Bring in new items from linked sources in Settings, then Automations, and each source can opt out or pick its deliverable from its ⋯ menu, under New items. Up to 25 come in per sync, checked every hour and on every sync.
How sync works
A tag tells Unblockd a task is blocked: one named exactly Blocked or On hold. Each task becomes the first status that matches:
- Completed
- Becomes: Done
- Tagged exactly Blocked or On hold
- Becomes: Blocked
- Any progress above 0%
- Becomes: In progress
- Anything else
- Becomes: To do
| In Teamwork.com | Becomes |
|---|---|
| Completed | Done |
| Tagged exactly Blocked or On hold | Blocked |
| Any progress above 0% | In progress |
| Anything else | To do |
Unblockd checks Teamwork.com again when someone opens the project’s Sources tab and the last check is more than 10 minutes old, when you choose Sync now from the source’s ⋯ menu, and once a day. The row shows when it last synced. A large source catches up over a few checks.
- Done in Teamwork.com finishes the task in Unblockd, because the link back to Teamwork.com already counts as proof. A task that needs a sign-off stays where it is until the sign-off is recorded.
- Blocked in Teamwork.com marks the task Blocked and opens a blocker for your team only, and posts to your team’s chat channels if you’ve connected any. Someone on your team confirms it and can turn it into an ask for your sponsor. If the task moves on in Teamwork.com, the task follows; the blocker stays open until your team resolves it.
- A title changed in Teamwork.com changes in Unblockd too. A tool never puts a task In review: that needs a reviewer chosen in Unblockd.
- Tasks from a tool stay with your team. Your sponsor sees each deliverable’s progress, not the tasks under it.
Disconnect and revoke access
- Press DisconnectIn Settings, then Connected tools, press Disconnect on Teamwork.com’s row.
- ConfirmIf it’s linked to projects, Unblockd first says how many projects it will unlink. Press Disconnect Teamwork.com to confirm, or Keep.
- Deleted: the connection, its stored access, and every Teamwork.com project linked through it, across all your Unblockd projects.
- Kept: tasks already brought in stay as ordinary tasks with their history and proof links. They stop following Teamwork.com. Connect again and relink the same Teamwork.com project, and they follow it again.
- Teamwork.com keeps the access you granted until it's removed. Remove Unblockd from the apps connected to your Teamwork.com account.
To stop one project following Teamwork.com without disconnecting it for everyone, open the linked Teamwork.com project’s ⋯ menu on the Sources tab and choose Unlink. Its tasks stay, but stop following Teamwork.com.
Troubleshooting
- Needs reconnecting
- What to do: Teamwork.com turned down Unblockd’s access, for example because it was revoked or the person who connected it left. The row says “Reconnect to keep it in sync.” An admin presses Reconnect and approves access again; linked projects and their tasks carry on.
- Retrying
- What to do: The row says “Couldn’t reach it on the last try. It will try again.” Teamwork.com didn’t answer the last time Unblockd tried. Nothing is lost; the next sync picks up where it stopped.
- Rate limits
- What to do: Unblockd reads one item about every 0.65 seconds, up to 200 per check, to stay inside Teamwork.com’s limits. If Teamwork.com still says to slow down, Unblockd stops that check and picks up on the next one. Sync now waits 60 seconds between runs on the same source.
- A project is missing
- What to do: Only projects the connected account can see are listed. Check its access in Teamwork.com, or reconnect with an account that can see it.
- Only an admin can connect
- What to do: “Only a workspace admin can connect or disconnect tools.” Ask an admin, or have one change your role in Settings, then Members.
- The connection link expired
- What to do: “That connection link expired or was started by someone else. Try again from here.” Start again from Connected tools and finish within 10 minutes.
- A different account
- What to do: “This workspace is linked to a different account for that tool. Disconnect it first.” Each workspace connects one Teamwork.com account. Disconnect the old one first.
- Coming soon
- What to do: A tool that shows Coming soon instead of Connect can’t be connected yet.
| What you see | What to do |
|---|---|
| Needs reconnecting | Teamwork.com turned down Unblockd’s access, for example because it was revoked or the person who connected it left. The row says “Reconnect to keep it in sync.” An admin presses Reconnect and approves access again; linked projects and their tasks carry on. |
| Retrying | The row says “Couldn’t reach it on the last try. It will try again.” Teamwork.com didn’t answer the last time Unblockd tried. Nothing is lost; the next sync picks up where it stopped. |
| Rate limits | Unblockd reads one item about every 0.65 seconds, up to 200 per check, to stay inside Teamwork.com’s limits. If Teamwork.com still says to slow down, Unblockd stops that check and picks up on the next one. Sync now waits 60 seconds between runs on the same source. |
| A project is missing | Only projects the connected account can see are listed. Check its access in Teamwork.com, or reconnect with an account that can see it. |
| Only an admin can connect | “Only a workspace admin can connect or disconnect tools.” Ask an admin, or have one change your role in Settings, then Members. |
| The connection link expired | “That connection link expired or was started by someone else. Try again from here.” Start again from Connected tools and finish within 10 minutes. |
| A different account | “This workspace is linked to a different account for that tool. Disconnect it first.” Each workspace connects one Teamwork.com account. Disconnect the old one first. |
| Coming soon | A tool that shows Coming soon instead of Connect can’t be connected yet. |
Still stuck? Press Report a problem on Teamwork.com’s row in Connected tools, or choose Report a problem with Teamwork.com from a linked project’s ⋯ menu. One tap sends the tool and what the row shows about the connection (never a key or token) to the Unblockd team, and someone replies by email. You can send 5 reports every hour, or write to hello@unblockd.ai any time.
Connect Teamwork.com now
Open Connected tools in Unblockd and press Connect beside Teamwork.com. You’ll need to be a workspace admin.