Zapier (Salesforce, Slack, Twitter, Github, Trello, MATRIX LMS etc.)

Zapier is a cloud-based tool designed for connecting commonly used applications so that an event in one application triggers an action in another. For example, it can be used to post a Slack message whenever somebody registers for a GoToMeeting webinar. Zapier can also be used to track usage of these applications in Watershed. Every time a user favorites a Tweet or reports an issue in JIRA, it could be tracked in Watershed. Every time a programmer commits code or posts to Slack, that can be tracked too. Zapier offers a really quick way to get data out of a range of commonly used programs and into Watershed reports.

The aim of Zapier is to make integrating these applications as easy as possible. With a few clicks and settings you can have an integration (known as a Zap) set up in a few minutes. It’ll then run automatically in the background until you turn it off.

Zapier has an impressive list of apps that it works with, and it’s possible to develop Zaps for products not on that list. That’s exactly what we’ve done for Watershed.

This guide introduces you to Zapier and explains how to connect applications to Watershed LRS using our Zapier Zap.

This guide has 3 main sections with additional sub-sections:

Zapier vs. Your Own Integration

Why would you want to use Zapier instead of developing your own integration? Zapier is especially useful for creating an integration for a proof of concept or a pilot project for the following reasons:

  • It’s cheap or even free for small scale projects.
  • It’s really quick to set up.
  • It’s easy to swap out applications e.g. if you are trialing more than one product.
  • You often don’t need to involve a developer.

Zapier can be used for larger scale projects too, but some organizations might prefer to develop their own integration after the pilot/proof of concept. If so, it can still be worthwhile trying the integration out in Zapier as a proof of concept. This is a useful way to collect feedback and get buy in ahead of developing your own integration.

Connecting to specific applications

The easiest way to connect applications to Watershed via Zapier is to use pre-configured shared Zapier integrations that we've created. Right now, the three most popular shared Zapier integrations are:

Find out how to set these and others up below.

Salesforce

Salesforce is a leading enterprise customer relationship manager (CRM) application. You can track various Salesforce events to Watershed LRS using Zapier. We've included some examples below. Talk to us if you want to track other events or data.

New Task

Use this integration to track whenever a salesperson creates a new task. Click Use this Zap on the widget below and follow the instructions on screen to set this up.

Data from this event can be used in conjunction with data from other sources. If viewed on it’s own, it can viewed using the Skills and Leaderboard cards.

To set up the Skills card, follow the instructions for Creating and Managing Skills up to step three. Instead of naming the skill and searching for an activity, click Advanced Edit.

In the editor that appears, remove everything and replace it with the JSON below:

{
  "name": "Create a sales task",
  "components": [
    {
      "name": "verb.id",
      "value": "http://activitystrea.ms/schema/1.0/create"
    }
  ],
  "andSkills": [
    {
      "components": [
        {
          "name": "object.definition.type",
          "value": "http://id.tincanapi.com/activitytype/sales-task"
        }
      ]
    }
  ]
}

With the skill created, simply follow the instructions to set up and configure the Skills card.

Key questions answered: How many sales tasks have people created?

To set up the Leaderboard card, start a new exploration and select the Leaderboard card. Go into Advanced configuration.

Replace the contents of the configuration box with:

{
  "dimension": {
    "type": "PERSON"
  },
  "measures": [
    {
      "name": "Sales Task Count",
      "field": {
        "type": "STRING",
        "id": "object.definition.type"
      },
      "aggregation": "COUNT",
      "match": "http://id.tincanapi.com/activitytype/sales-task"
    }
  ]
}

You can now return to Simple configuration to edit the Card Title, filters and how the data is organized.

Key questions answered: Who creates the most sales tasks? What times of year see the most sales tasks created?

New Event

Use this integration to track whenever a salesperson creates a new event. Click Use this Zap on the widget below and follow the instructions on screen to set this up.

Data from this event can be used in conjunction with data from other sources. If viewed on it’s own, it can viewed using the Skills and Leaderboard cards.

To set up the Skills card, follow the instructions for Creating and Managing Skills up to step three. Instead of naming the skill and searching for an activity, click Advanced Edit. In the editor that appears, remove everything and replace it with the JSON below:

{
  "name": "Create a sales event",
  "components": [
    {
      "name": "verb.id",
      "value": "http://activitystrea.ms/schema/1.0/create"
    }
  ],
  "andSkills": [
    {
      "components": [
        {
          "name": "object.definition.type",
          "value": "http://id.tincanapi.com/activitytype/sales-event"
        }
      ]
    }
  ]
}

With the skill created, simply follow the instructions to set up and configure the Skills card.

Key questions answered: How many sales events have people created?

To set up the Leaderboard card, start a new exploration and select the Leaderboard card. Go into Advanced configuration and replace the contents of the configuration box with:

{
  "dimension": {
    "type": "PERSON"
  },
  "measures": [
    {
      "name": "Sales Event Count",
      "field": {
        "type": "STRING",
        "id": "object.definition.type"
      },
      "aggregation": "COUNT",
      "match": "http://id.tincanapi.com/activitytype/sales-event"
    }
  ]
}

You can now return to Simple configuration to edit the Card Title, filters and how the data is organized.

Key questions answered: Who creates the most sales events? What times of year see the most sales events created?

Slack

Slack is a platform for team communication: everything in one place, instantly searchable, available wherever you go. Offering instant messaging, document sharing and knowledge search for modern teams. You can track various Slack events to Watershed LRS using Zapier. We've included some examples below. Talk to us if you want to track other events or data.

New Message Posted

Use this integration to track whenever a team member posts a message. Click Use this Zap on the widget below and follow the instructions on screen to set this up.

Data from this event can be used in conjunction with data from other sources. If viewed on it’s own, it can viewed using the Skills and Leaderboard cards.

To set up the Skills card, follow the instructions for Creating and Managing Skills up to step three. Instead of naming the skill and searching for an activity, click Advanced Edit. In the editor that appears, remove everything and replace it with the JSON below:

{
  "name": "Post a Slack message",
  "components": [
    {
      "name": "verb.id",
      "value": "http://activitystrea.ms/schema/1.0/send"
    }
  ],
  "andSkills": [
    {
      "components": [
        {
          "name": "object.definition.type",
          "value": "http://id.tincanapi.com/activitytype/chat-message"
        }
      ]
    }
  ]
}

With the skill created, simply follow the instructions to set up and configure the Skills card.

Key questions answered: How many Slack messages have people posted?

To set up the Leaderboard card, start a new exploration and select the Leaderboard card. Go into Advanced configuration and replace the contents of the configuration box with:

{
  "dimension": {
    "type": "PERSON"
  },
  "measures": [
    {
      "name": "Message Count",
      "field": {
        "type": "STRING",
        "id": "object.definition.type"
      },
      "aggregation": "COUNT",
      "match": "http://id.tincanapi.com/activitytype/chat-message"
    }
  ]
}

You can now return to Simple configuration to edit the Card Title, filters and how the data is organized.

Key questions answered: Who posts the most Slack messsages? What times of year see the most messages posted?

New User

Use this integration to track whenever somebody joins your team Slack. Click Use this Zap on the widget below and follow the instructions on screen to set this up.

This data might be useful as a leaderboard showing numbers of people joining Slack each month.

Create a new Leaderboard card and select Advanced configuration. Delete all the contents of the Advanced configuration box and replace it with:

{
  "filter": {
    "activityIds": {
      "ids": [
        "https://your-team-domain.slack.com"
      ]
    }
  },
  "measures": [
    {
      "name": "New Members",
      "field": {
        "id": "verb.id",
        "type": "STRING"
      },
      "aggregation": "COUNT",
      "match": "http://activitystrea.ms/schema/1.0/join"
    }
  ],
  "dimension": {
    "type": "MONTH"
  }
}

Once you have done that, switch back to Simple configuration and add your team Slack site in the Activity filter. There should be no other activities in the filter.

Key questions answered: What times of year see the most new Slack users?

Twitter

Twitter is a social network that lets you publish 140-character messages, called "Tweets", that can be seen by an international audience in real-time. You can track various Twitter events to Watershed LRS using Zapier. We've put together a complete and detailed walkthrough outlining how to connect and report on Twitter data.

Github

GitHub is the perfect place to share code and work collaboratively on private and open source software. Github has an impressive array of events in Zapier, most of which have a lot of potential data fields associated with them. We've included some examples below. Let us know if you'd like help with creating Zapier integrations for other GithUb events or data.

Commit authored within a repository

Use this integration to track whenever a developer authors a commit within a particular repository. Click Use this Zap on the widget below and follow the instructions on screen to set this up.

Please note: In practice, number of commits is a bad measure of developer performance as it says nothing about the quality of work; we’ve included it as an example because it’s easy to use with a public Github repository as a demonstration.

Data from this integration can be used in conjunction with data from other sources. If viewed on it’s own, it can viewed using the Skills and Leaderboard cards.

To set up the Skills card, follow the instructions for Creating and Managing Skills up to step three. Instead of naming the skill and searching for an activity, click Advanced Edit. In the editor that appears, remove everything and replace it with the JSON below:

{
  "name": "Author some code",
  "components": [
    {
      "name": "verb.id",
      "value": "http://activitystrea.ms/schema/1.0/author"
    }
  ],
  "andSkills": [
    {
      "components": [
        {
          "name": "object.definition.type",
          "value": "http://id.tincanapi.com/activitytype/code-commit"
        }
      ]
    }
  ]
}

With the skill created, simply follow the instructions to set up and configure the Skills card.

Key questions answered: How often do developers author code?

To set up the Leaderboard card, Start a new exploration and select the Leaderboard card. Go into Advanced configuration and replace the contents of the configuration box with:

{
  "dimension": {
    "type": "PERSON"
  },
  "measures": [
    {
      "name": "Commits Count",
      "field": {
        "type": "STRING",
        "id": "object.definition.type"
      },
      "aggregation": "COUNT",
      "match": "http://id.tincanapi.com/activitytype/code-commit"
    }
  ]
}

You can now return to Simple configuration to edit the Card Title, filters and how the data is organized.

Key questions answered: Which developers author the most code? During what time periods was the most code authored?

Trello

Trello is team collaboration tool that lets you organize anything and everything to keep your projects on task. You can track various Trello events to Watershed LRS using Zapier. We've included some examples below. Talk to us if you want to track other events or data.

User activity on a board

Use this integration to track user activity on a Trello board when you don't need to know what the specific action was. Click Use this Zap on the widget below and follow the instructions on screen to set this up.

Data from this event can be used in conjunction with data from other sources. If viewed on it’s own, it can viewed using the Skills and Leaderboard cards.

To set up the Skills card, follow the instructions for Creating and Managing Skills. Search for the name of your Trello board(s) when selecting activities to be associated with the skill.

With the skill created, simply follow the instructions to set up and configure the Skills card.

Key questions answered: How much do people use Trello?

To set up the Leaderboard card, follow the instructions for Setting up and Configuring a Leaderboard Card. Use the names of your Trello board(s) to filter activities and select the Statement Count measure.

Key questions answered: Who uses a Trello board most? How has usage changed over time?

MATRIX LMS

MATRIX is a simple, powerful, cloud-hosted LMS for businesses that makes it easy to deliver online training. You can track various MATRIX events to Watershed LRS using Zapier. We've included some examples below. Talk to us if you want to track other events or data.

Use this integration to track when a learner completes a course within MATRIX. Click Use this Zap on the widget below and follow the instructions on screen to set this up.

Data from this event can be used in conjunction with data from other sources. If viewed on it’s own, it can viewed using the Skills and Leaderboard cards.

To set up the Skills card, follow the instructions for Creating and Managing Skills up to step three. Instead of naming the skill and searching for an activity, click Advanced Edit. In the editor that appears, remove everything and replace it with the JSON below:

{
  "name": "Complete a course",
  "components": [
    {
      "name": "verb.id",
      "value": "http://adlnet.gov/expapi/verbs/completed"
    }
  ],
  "andSkills": [
    {
      "components": [
        {
          "name": "object.definition.type",
          "value": "http://adlnet.gov/expapi/activities/course"
        }
      ]
    }
  ]
}

With the skill created, simply follow the instructions to set up and configure the Skills card.

Please note: This skill includes all courses completed, not just courses completed within MATRIX LMS.

Key questions answered: How many courses have people completed?

To set up the Leaderboard card, follow the instructions for Setting up and Configuring a Leaderboard Card. Use the names of your MATRIX LMS courses to filter activities and select the Completion Count measure.

Key questions answered: Who has completed the most courses? Which courses are most popular? How has the number of course completions changed over time?

Connecting to other applications

We want you to be able to connect all of Zapier’s Zapbook to Watershed LRS so we’ve created a Watershed Zap! You can use this Zap to listen for a events in one or more of the applications available within Zapier and send a Tin Can statement to Watershed when that event happens. Here’s how to set it up.

Please note: This section is for advanced users who have an understanding of Tin Can statement design. We recommend that most users make use of the Zapier integrations shared above. Please talk to us if the integration you need is missing and we can help to create it.

  1. Register for Zapier. The free account gives you enough tasks to send 100 statements per month, which is enough to test with. For anything bigger than a proof of concept you’ll need a paid account.
  2. In the My Zaps tab on your Dashboard within Zapier, click Make a New Zap. This opens the New Zap wizard.
  3. On the left, choose the application and event that you want to track. On the right hand side, select WATERSHED LRS and Send a Statement.
  4. Follow the instructions on-screen to connect Zapier to the application you want to track and to Watershed. You will need to add Zapier as an Activity Provider in Watershed to get your Key, Secret, and Endpoint. Complete any settings specific to the application you want to track (step 4 of the Zap wizard). Ask us if you need any help connecting to your Watershed account.
  5. In step 5 of the Zap wizard you’ll craft the Tin Can statement to be sent to the LRS. If you understand Tin Can statements, you can complete this section yourself following our Statement Design Guide. If not, or if you get stuck, you can ask us to help. You should fill in as many of the fields as are relevant, following the instructions on the screen. You’ll use a combination of fixed values and variables from the source application.
  6. Finally, test the Zap and turn it on. The test should send a Tin Can statement to your Learning Record Store (LRS). You can see this statement in Watershed using the Statement Viewer.

That’s it! Tin Can statements will now appear in Watershed whenever the event you selected happens. You can use Watershed’s cards to display and analyse the data.

Please note: To ensure you get the most out of the data you collect, please follow the Statement Design Guide when configuring the Zap. We recommend that you choose at least one Watershed card to target with the data and test your statements with that card. Read more about creating cards here.

Trigger actions from xAPI statements

This article has mainly discussed having other applications trigger xAPI statements. The reverse is also possible; you can have Zapier look for a particular xAPI statement and then trigger an action. Given the range of apps in Zapier, the possibilities of this are endless. Some random example include:

  • Email out a reminder resource 1 week after somebody completes a course.
  • Tweet a congratulations message when a customer gets certified to use your product.
  • Turn on a lawn sprinkler when the learner gets a question wrong.

You can even trigger another xAPI statement to be sent to the same or a different LRS.

To set this up, simply select Watershed LRS as the Trigger App when creating a Zap and choose the New Statement trigger. Select the LRS you want to monitor and populate the filter to fetch only those statements you want to watch. Test and save the trigger then continue to build the rest of the Zap as normal. It’s really easy.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

If you can't find what you need or you want to ask a real person a question, please contact customer support.