Vercel

Connect Vercel and every deployment of a linked project shows up where your team is already looking: on the card of the pull or merge request it was built from, and on issues whose key is in the branch name. Finished production deploys can be posted to a chat channel. Open Integrations → Vercel → Configure to set it up. You need permission to manage integrations.

Connecting Vercel

There are two ways to connect:

• Connect Vercel adds the Deckbell integration to your Vercel account or team (where available). It works on every Vercel plan.
• Access token works without the integration. Create a token in Vercel's Account Settings → Tokens, scoped to the team that owns your projects, and paste it in. For a team's projects, also enter the Team ID from the team's Settings → General (it starts with team_). Deckbell adds a deployment webhook for each project you link, which Vercel only allows on Pro and Enterprise plans; on Hobby, use Connect Vercel instead.

Linking projects

Under Projects, search for a Vercel project and choose Link. For each linked project you can pick:

• Deckbell project: deployments are only listed on issues of this project. Leave it on Any project to match issues anywhere in the workspace.
• Post production deploys to: a channel that gets a message when a production deployment finishes (with its address) or fails (with a link to the build logs). Preview deployments aren't posted.

Deployment updates are signed by Vercel; Deckbell ignores anything that isn't. Unlink removes the project and its webhook. Disconnect removes Vercel from the workspace.

Previews on pull requests and issues

When Vercel builds a commit from GitHub, GitLab or Bitbucket, Deckbell matches the deployment to the pull or merge request whose latest commit or branch it built. The request's card on the issue then shows Preview building, Preview ready (click to open the preview) or Deploy failed (click for the logs). Pull request cards that agents post in chat show the same badges.

Deployments of a branch that names an issue (like hrb-142-proration) but has no linked pull request are listed under Deployments on that issue.