Building Team Workflows in Cosmic JS


Cosmic JS provides tools and resources to create your own unique content publishing workflow that satisfies your team's needs. In this tutorial I'll demonstrate setting up a simple workflow for an Editor and Contributor team that needs to manage content in a draft, review and publish process. We'll also use Webhooks to integrate with Slack to notify the Editor when content is drafted by the Contributor. Let's get started.


Note: While the example that I'm demonstrating is for a publication, editorial or marketing team, you can think of the editor / contributor relationship as the management / execution layer of any team. 


Start by Inviting Your Contributors

Navigate to the left hand nav bar within your Cosmic JS Bucket Dashboard, click Settings and then click Users. You can extend user permissions via email for collaboration within your Bucket. 



When inviting my contributors, Cosmic JS gives me granular control over what Object Types this new Contributor is allowed to draft. I choose Blogs for this example, meaning my new content contributor can only draft Objects within the Blogs Object Type. 


Now that I’ve sent a notification to the contributor, I will set up notifications in Slack so I can be notified when my contributor has set a blog post to draft.

 

Set up Webhooks to receive Slack Notifications 

When my contributor drafts content within the Cosmic JS Bucket Dashboard, I want to receive a notification so that I can check their work and either send it back to them for additional review or publish. Note: as the Admin, Developer or Editor roles you can always edit and overwrite contributor content changes at any time. 

To receive notifications I will need to have my developer set up Cosmic JS Webhooks. Webhooks are used to trigger a POST request to the endpoint of your choice when an event occurs in your Bucket. Options for the channel notifying your team are numerous, but a couple of quick examples would be via Slack or SendGrid. 


Connect your Cosmic JS Buckets to Slack: 


1. Install the Cosmic JS Slack app to your Slack account by clicking here.

2. Select which channel you would like to receive the notifications and click "Authorize".


3. After you install the Slack app, copy the webhook link provided.



4. Paste the webhook link into the Endpoint input field. Documentation and a list of available Webhook events can be found here

Now every time my contributor creates and saves a draft within my Bucket, I'll be notified through Slack to review the work and schedule publishing. When it comes time for edits (and peace of mind) Cosmic JS provides audit logs with time-stamped revision updates that track authors as well as Revision History, which allows you to revert back to previous versions. 


Conclusion

I've just created a simple content publishing workflow for my team. In just a few steps I've invited a contributor to my Bucket and set up an automated system for notifying our team of new content changes being drafted. This is one of many possible workflows you're able to create with Cosmic JS User Permissions and Webhooks.

If you have any comments or questions about building content workflows with Cosmic JS, reach out to us on Twitter and join the conversation on Slack.

Was this article helpful?

Thank you! Your input helps us improve our articles and resources. If you have any other questions or comments, please contact support.

You may also like


Website built using the Next.js Website Boilerplate. Fully responsive down to mobile, SEO ready, includes a contact form and full site search.
This article shows you how to create a blazing fast Gatsby JS blog using Cosmic JS source plugin. Let’s get started.
This is a JAMstack app with the power of Cosmic JS. In JAmstack, Vue.js is used as Javascript part, Cosmic JS as API and Nuxt.js as Markup.
The beauty of using a static site generator is that your backend can be completely separate. In this video, I switch from markdown files to Cosmic JS!
The Cosmic JS team was honored to to speak at Toyota Connected for the Ember.js Dallas Meetup this week. Cosmic JS co-founder Tony Spiro presented "Building Modern Apps with API Services" to illustrate the growing trend of offloading core dev tasks onto best-in-class API services.
Build a documentation app in a afternoon leveraging the powered of Gatsby and Cosmic JS.