Follow

Third party access (API keys)/Using Zapier

 

 

With the Third party access (API Keys) feature, users can use Zapier to integrate Discussions (that they are a Moderator for) with other web applications to perform automated tasks.

 

Generating your API key

*Before you begin, ensure you are already registered with a Zapier account

1. If your System Administrator has given you API management rights, you should see a gear icon at the top of your Discussions list. Click on it to open the Discussions Settings screen.

zap01.png

 

2. Under Third party access (API Keys) you should see two headings: Your endpoint URL and Key management

zap02.png

3. Go to Key Management and click Add a new key. In the Description field, give the key an  appropriate name (i.e. “Zapier”), and then click Add.

zap03.png

4. You should now see your API key in a yellow field. Click Copy and save it. This will be the only time you will see that key, so ensure you have it copied and saved.

zap04.png

To complete the rest of the setup you will need to log into your Zapier account.

 

 

Making a Zap

NOTEif you are not familiar with Zapier or Zaps, there are plenty of tutorials and guides available on the Zapier site.

Making a Zap is broken down into two parts, and each part has multiple steps. 

  • Part 1 (When this happens...) is where you'll select and set up the app you want to integrate with your Discussion.
  • Part 2 (Do this...) is where you'll select and set up the Jostle app* and configure the Discussion you want to integrate with the app from Part 1.

*There are many apps can be used for Part 1, but only the Jostle app can be used for Part 2. 

To begin, on the Zapier home page, expand the column on the left and click the Make A Zap button.

zap14.png

 

NOTE—to illustrate the following steps I’ll be using a Zap I created that posts a message in a Discussion whenever a certain event is added to my Google Calendar. Therefore, some of the content choices shown below will not be the same if you're setting up a Zap using a different app.

 

Setup: Part 1 - When this happens...

If you are unsure of anything at any time during the setup you can click the Guide button to the far right. This will slide open an info panel that you can follow through each step:

zap07a.png

1. Choose App & Event

After clicking the Make A Zap button , you'll the see the apps that are available to you. After you select an app, you will be able to select a related trigger event.

zap17a.png

 

2. Choose Account

Next, you'll enter your account connected with the app you've selected.

zap18.png

3. Customize Event

Next you'll enter specific details that will identify your event. For example, I chose for the Zap to search my Google Calendar for events posted under Customer Communication that have the word "Voice" in their title.

zap19.png

4. Find Data

To complete this part of the setup, Zapier will do a test search for a matching event. If successful, you can move on to Part 2.

zap20.png

 

Setup Part 2 (Do this...) 

1. Choose App & Event

Here is where you'll search for and select the Jostle app and the only action event available at this time, "Create a discussion post"

zap09a.png

2. Choose Account

In this step you'll encounter an access permission pop-up. Select Discussions and enter the API key you previously copied and saved into the appropriate fields and then click Yes, Continue

This will confirm your Jostle account and link it to Zapier.

newzap01.png

3. Customize Post

Here is where you'll build the content that you want the Zap to post for you.

For the Discussion Post Content you can enter either or both of the following:

  • customized text
  • pre-formatted data applicable to your chosen app/event.

For Discussion, click on the arrows and select the Discussion you want your Zap to post to. Remember, you will only see Discussions for which you are a Moderator.

newzap02.png

 

NOTE—these posts will appear in your Discussion timelines as normal posts from yourself. However, there will be an indication below your name to indicate that they are automated by Zapier.

 

zapauto.png

 

But if you want to emphasize that they are not being posted by you, in the next section, you can opt to remove your name and have the Zap posted from "Bot" instead.

 

newzap03.png

Whichever you choose, click Continue when you're done.

 

 4. Send Data 

Once you’ve configured your post, if you know you have a matching event already available you can send a test Zap. If all goes well, you should see a Success screen.

zap12b.png

And your test post will have been added to your chosen Discussion.

Zapauto3.png

When you return to your Zapier Home page, you should see now your new Zap listed there, with a toggle for when you want to turn it on or off.

zap05.png 

 

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

0 Comments

Please sign in to leave a comment.