Helpscout integration for Facebook Workplace via AWS Lambda

This repository contains an AWS Lambda function which will post Helpscout updates to a Facebook Workplace group of your choosing. For an overview of the approach, see this document.

Setup

To make this work, first follow the instructions here. Then you'll need to set things up on Helpscout.

In addition to the environment variables you've set following the document above, you'll also need to set:

HELPSCOUT_KEY - Set this to a sufficiently long/complicated secret key you want to use to sign Helpscout requests. Take note of it

We now just need to make sure Helpscout calls your endpoint whenever something happens.

From Helpscout, go to Manage ... Apps. Select Webhooks from the list.
In the Secret Key field, put in the value you created for HELPSCOUT_KEY.
In the URL field, put in the URL for the API Gateway trigger.
Select the events you want to post to Workplace. Hit Save and you should be good to go!