Sidequest and Slack Workflow Builder

Start workflows from tasks, and create tasks from workflows. Each feature is turned on per workspace. Admins find them in Workspace settings โ†’ ๐Ÿงช New features.

Start workflows from tasks (Workflow webhooks)

  1. 1

    Create a workflow that starts from a webhook.

    In Slack Workflow Builder, create a workflow that starts from a webhook. Add the variables you need. All of them are always sent (empty when there is no value), so declare the *_id variables as text: schema_version, event, task_number, task_title, task_details, task_url, status, importance, due_date, start_date, channel_id, recipient_id, requester_id, author_id, actor_id, first_assignee_id, assignees, changed_fields, team_id.

  2. 2

    Copy the webhook URL.

    It looks like https://hooks.slack.com/triggers/โ€ฆ.

  3. 3

    Add the webhook in Sidequest.

    Open Workspace settings โ†’ Workflow integrations โ†’ Add webhook. Paste the URL, choose the events (task created, edited, assigned, taken, unassigned, completed, reopened, deleted, due today, overdue) and optionally filter by channel and importance.

  4. 4

    Send a test event.

    Send test event posts a sample task to your workflow right away.

Deliveries are retried when Slack is busy. A webhook whose URL no longer exists, or that fails 20 times in a row, is turned off and its creator gets a message with a Re-enable webhook button.

Create tasks from workflows (Intake channels)

  1. 1

    Set up an intake channel.

    Pick a channel for incoming requests, add Sidequest to it and add it under Workspace settings โ†’ Workflow integrations โ†’ Add intake channel (default recipient, and who may post).

  2. 2

    Post into the channel from your workflow.

    In your workflow (e.g. a form), add a step Send a message to a channel that posts into that channel:

    sidequest: create
    title: {form answer}
    details: {form answer}
    from: {person who submitted the form}
    to: #support
    assign: @someone
    due: tomorrow
    importance: high

    Only sidequest: create, title and (for workflows) from are required. Insert people and channels as workflow variables or mentions (plain @name text is not accepted). Dates: YYYY-MM-DD, today, tomorrow or +3d. Also available: cc: (watchers) and start:.

  3. 3

    Sidequest replies in the thread.

    Sidequest creates the task and replies in the message's thread: โœ… Created #123: โ€ฆ with a link, or โš ๏ธ and what to fix.

Turning a feature off keeps your webhooks and intake channels; nothing is sent or created while it is off.