By using Make with your StoryChief account, you can create custom workflows that trigger when you complete actions.
In this article:
🔔 Note: This help article is a basic guide; Make has lots of possibilities to tinker with.
Error handling, retry policies etc. won't be covered in this article.
Start connecting to Make
1. StoryChief as trigger
Step 1. On Make, create a new scenario. In the bar on top, select 'create scenario'.
Or, in the scenario's tab, select 'Open scenario builder'.
Step 2. Click on '+' to add a first step. In the modal, choose 'Webhooks' and 'Custom webhook'.
Step 3. Choose 'Create a webhook' and give it a readable name.
Leave the API key empty.
Enable the advanced settings:
IP restrictions -> Empty or 52.18.212.210 (See help article firewall)
Get request headers -> Yes
Get request HTTP method -> Yes
JSON pass-through -> No
For the data structure, click 'Add'. Give it a name (e.g. StoryChief articles) and click 'Generate'. Here, paste the JSON in data-raw from the publish event from our documentation: https://developers.storychief.io/#fb73b0fc-39f6-4c2e-b231-6687a2646287
After adding the data structure, feel free to tweak it by providing descriptions or other changes.
🔔 Note: Also include the meta fields (event, mac) in the data structure as it might help map fields later on.
Step 4. Add another webhook module named 'Respond to webhook'. Configure the following fields:
Status: 200
Body:
ID: An ID of the content on the platform where it's published
Permalink: A public URL to check that the article is live
Mac: The encryption key from your website (see step 4)
🔔 Note: The Permalink field will probably still be changed, depending on other modules. E.g. a link to a Slack thread, a social post.
Step 4. In StoryChief, go to the channels, API and choose "Add new destination".
Here, you can paste the webhook URL and retrieve the encryption key for your workflow (optional).
Also check out the help article on how to set up a custom website 👉 Quick link.
A flow could look like this:
Incoming webhook call (article published)
JSON parsing (optional)
Post a Slack message to notify colleagues
Reply to StoryChief with Slack message permalink
2. StoryChief actions
Prerequisite: In StoryChief, go to the API section and fetch your API key 👉 Quick link.
On the dashboard, open the menu and go to Settings.
In the settings, select 'API' and 'Your keys'.
Choose '+ New Token'.
Step 1. In a new or existing workflow, select "+" to add a new action to the flow. In the pop-up, choose "HTTP".
Step 2. In the HTTP options, you will see 'Make a request', which opens a settings modal.
Step 3. In this modal, choose the correct request method (GET, POST, ..) and paste the corresponding URL (see https://developers.storychief.io/).
Depending on the "?includes[]" fields, it's possible to send parameters along.
In this example, we'll create a social post based on the daily weather.
🔔 Note: Use Postman to fetch the correct Destination ID's: https://developers.storychief.io/#cb37ebb5-7c32-4b11-8e0e-606589a25319
🎉 You're done, grab a cookie, you deserve it!
Check out the other help articles for more in-depth guides.