GoCo

How can I get notified when there has been a status change on a workflow task in GoCo?

Need a way to know when a workflow task status changes in GoCo? Keep reading to learn more or use the links to skip ahead.


What are Workflows?

Setting up the Integration

Connecting to Slack

Setting your Triggers

Customizing Slack Message

Turning on the Recipe

Alternatives to Slack

What are workflows?

GoCo makes HR work ✨flow✨. In your GoCo account, you are able to orchestrate and automate any HR workflow, process, or checklist with standardized workflow templates. You can invite anyone in your company to collaborate in your workflows and can assign tasks and streamline communication. Finally, your single dashboard view will help you track and manage all of your HR workflows. For more information on Workflows, check out our Workflows help articles here.

Why set up a trigger to get notified?

The main use is to get notified when there has been a status change to a workflow task so that nothing is missed.

So how do I set up this integration?


  • Log into GoCo as usual as a Full Access Admin & navigate to your GoCo Marketplace. You can do so from the Navigation tabs on the left side of the screen or by finding the Marketplace card on your Company homepage & clicking the "View" button.

    Screen Shot 2022-11-16 at 3.12.19 PM
    Screen Shot 2022-11-16 at 3.07.57 PM
  • In your Marketplace, you'll find all of our available GoCo's Apps & Integrations. In the Preferred section scroll down to find the GoCo card and click on the blue "+Add" button to get started. 
Screen Shot 2022-11-16 at 3.14.15 PM

 

  • This will take you to view pre-made Recipe Templates as well as give you the option to Build Your Own. For more information on how to "Build Your Own" recipes, check out our help article here!

    Screen Shot 2022-11-16 at 3.19.14 PM

  • Locate the premade template that reads When a workflow task status changes, send a message in Slack and click on the "Use this recipe" button.

Screen Shot 2022-11-16 at 3.22.56 PM

  • This will open a new screen to edit this recipe, click the Use This Recipe button again at the top right. GoCo will begin to create your account (pssst.. this may take a moment)

    Screen Shot 2022-11-16 at 3.27.26 PM

  • A pop-up window will appear asking you where you want to save your copy of the recipe. Select a project in the dropdown menu or click the "+ New project" button to create a new project folder.
    Screen Shot 2022-11-16 at 3.32.01 PM
  • Give your project a name and optional description. Then click Copy and save.Screen Shot 2022-11-16 at 3.33.59 PM
  • Once you’ve made a copy of the recipe, a confirmation screen will appear letting you know that your recipe is ready! If you are already connected to Slack, hit the "Test recipe" button. If not, when you hit this you will be taken back to the previous screen to do this.Screen Shot 2022-11-16 at 3.38.55 PM
  • On this screen, you will see an error message letting you know that you have to connect to Slack. Hit the highlighted error to begin.

Screen Shot 2022-11-16 at 3.49.04 PM

  • A screen will slide out on the right asking to connect to slack, hit the blue "Connect" button.

Screen Shot 2022-11-16 at 3.51.46 PM

  • A pop-up screen will appear asking for permission to access your Slack workspace. Click "Allow".
    Screen Shot 2022-11-16 at 3.54.16 PM
  • You are now connected to Slack! All that is left to do, is determine the triggers that will kick off this recipe. To do this, first, click on the GoCo trigger to modify which workflow or tasks you want to be notified about.
    Screen Shot 2022-11-16 at 4.00.06 PM
  • A slide-out window will appear on the right, here click the toggle for "Set trigger condition".Screen Shot 2022-11-16 at 4.05.20 PM
  • If you wish to be notified of ALL tasks for ALL workflows then you are good to skip ahead to turning your recipe on!
  • If you need to set parameters for your recipe, update your "Trigger Data". For example, if you wish to pull only tasks labeled "Expense Approvals" from your workflow titled, "Expense Request" you would update like so:

    Screen Shot 2022-11-17 at 4.57.22 PM
  • To do this, you will first set an "If" filter to pull the task name. Use the search bar on the right to find the correct field for "Workflow Task Name" & then update the "Condition" to "contains" & input the title of the task you are trying to pull into the value field.  Screen Shot 2022-11-17 at 5.11.27 PM

🚨 Please Note: When setting a "Condition" values, it is case sensitive. For example, using "expense approval" will NOT work if the title of your workflow task is "Expense Approval". The same applies to all condition values (starts with, ends with, equals, etc.)

  • To set the filter for your workflow to be pulled, you will need to add a "And" filter. Use the search bar on the right to find the correct field for "Workflow Name" & then update the "Condition" to "contains" & input the title of the workflow you are trying to pull into the value field. Screen Shot 2022-11-17 at 5.38.39 PM

🚨 Please Note: The recipe is using the workflow instance name, so if you are using this recipe for Hiring Workflows, remember that the name that GoCo produces for each instance is  "Employee: Employee Name" so ensure that you are using the "contains" filter for these cases.

  • Now finally, it’s time to set up the Slack channel that you’d like the notifications to be sent. You can also edit the type of information being triggered, as well as the basic text we provided. Then click Save in the top right corner. Once saved, click Exit in the top right corner.

  • Now that you’ve set up your trigger data and slack channel, you can click on the Start recipe button in the top right corner. After the recipe has been initiated, you should be all set!

 

If you don’t want to use Slack as your destination for notifications, you can always customize the action to have notifications set up through email, text, etc.

  • To do this, you will want to click the Edit recipe button in the top right corner (if you are currently using the recipe with Slack, you will first want to Stop recipe in the top right corner).

  • Click the three dots next to Slack and click Delete

  • From there, you can create your own recipe with the desired action (for example, Gmail).

For any additional questions, please reach out to us at help@goco.io 💚