# Slack Integration Connect Zaphiri to Slack so your team's work and conversation stay together. Share a task link in a channel and it expands into a detailed card, or turn any message into a task without leaving Slack. > [!quote] Where your team already talks > A lot of team conversation happens in Slack. The Slack integration works there: you can create tasks from a message, and task links show their details in the channel. > [!note] Part of Team Projects > The Slack integration works with [[Team Projects]]. ## What the Slack integration does The integration connects a Slack workspace to Zaphiri and works in two directions: - **From Slack into Zaphiri**: create tasks with a slash command or a message shortcut - **From Zaphiri into Slack**: task and comment links unfurl into detailed cards in your channels ### Link unfurling When someone shares a Zaphiri team task link in Slack, it expands into a card showing: - **Title** of the task - **Status** with its project colour - **Priority** indicator - **Assignee** when the task has one - **Project** name and a button to open the task in Zaphiri Paste a **comment link** and Slack shows a comment card with the author, the message and the task it belongs to. This lets you point to a specific decision or discussion without copying text around. ### Create tasks from Slack You can capture work as a task while you are still in the conversation: > [!success] Two ways to create > **Slash command**: type `/tickup create` (optionally with a title) to open the Create task window > **Message shortcut**: use the **Create Zaphiri task** action on any message. The message text fills in the task description In the Create task window you choose where the task goes: - **Destination**: a personal workspace or a specific Team Project - **Status**: when you pick a Team Project, choose the status the task should start in - **Title and description**: edit them before you create the task After you create a task, Zaphiri posts a confirmation with a link to the new task. ## Setting up the Slack integration ### Connect your workspace ![[integrations-slack-section.png]] 1. **Open Zaphiri Settings**: select the settings icon in your sidebar 2. **Go to [[Integration Settings|Integrations]]**: select the Integrations section 3. **Connect Slack**: choose the Slack integration and authorise access to your workspace 4. **Link your account**: follow the prompt to connect your Slack user to your Zaphiri account ### Slash command reference > [!tip] The `/tickup` command > - `/tickup` or `/tickup help`: show what the integration can do > - `/tickup create`: open the Create task window > - `/tickup create [title]`: open the window with the title filled in ## Working with the integration ### Keep discussion and work connected - **Share for visibility**: drop a task link in a channel so the team sees its status at a glance - **Point to a comment**: share a comment link when you want to point to a specific decision - **Capture quickly**: turn an action item from a thread into a task with the message shortcut, so it doesn't get lost in scrollback ### Choosing a destination - **Personal workspace**: for tasks only you need to act on - **Team Project**: for shared work the whole project should see, placed straight into the right status ## Troubleshooting > [!warning] Common issues > **A task link does not unfurl**: make sure the link is a team task you have access to, and that the integration is connected for your workspace > **Cannot create a task**: check that your Slack account is linked to Zaphiri under Integration Settings > **Wrong destination**: reopen the Create task window and check the destination and status before you create the task --- **Next:** See how your team works together inside Zaphiri with [[Team Comments and Mentions]].