# 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]].