Skip to main content

Hi, Is there a way that I can add job postings from my google sheet or slack channel that we use to post job postings and trigger these to be posted in our community?

It looks like though webhooks by Zapier I can do this, but I'm not trained in developer docs - I found Gainsight Communities API documentation for starting a conversation - https://api2-us-west-2.insided.com/docs/community/
 

I don't know how to input what's needed for Step 3 - The Post section for webhook by zapier.
 

  1. URL: https://api2-us-west-2.insided.com/v2/conversations/start
  2. Payload type: form, JSON, xml, raw
  3. Data:
  4. Wrap Request in Array: No or Yes
  5. File
  6. Unflatten: No or Yes
  7. Basic Auth
  8. Headers

 

If you’re using Zapier, “API Request (Beta)” under the Gainsight CC Zapier Actions will simplify things quite a bit for you. You won’t need to worry about headers, etc. (Also if you’re using webhooks by Zapier, you’d first need to do an API call to authenticate with the API, so the Gainsight CC saves you a step)

For the data, follow the example Payload the API documentation provides. 

{
  "title": "Welcome to the community",
  "content": "Is this your first visit to our community-driven Help Center? Well then welcome to our small world of awesomeness!",
  "categoryId": 31,
  "poll": {
    "title": "Which option sounds better?",
    "options":  
      "Option A",
      "Option B",
      "Other"
    ]
  },
  "tags":  
    "new",
    "welcome"
  ],
  "sticky": false,
  "closed": false,
  "moderatorTags": e
    "highlighted"
  ]
}

 

 

It’s a set of key value pairs where you’re 1.) listing the field of the post, and 2.) providing the content for it. Not all of them are required, just Title, Content, and categoryId. 

But here’s the tricky part, the content of your post probably needs some formatting. If you provide the content in HTML, that styling will come through. However, some HTML characters may mess up the data structure of the JSON payload and cause the API call not to work. (That’s where my expertise ends, I’ve had to get more technical colleagues to help me for similar use cases in the past, and even then we ended up abandoning the use case.)

Reply


Terms & ConditionsCookie settings