NOTE: This app and the associated code is NOT production quality, its pure purpose is to demonstrate the full flow of custom interactions in Journey Builder
- Node.js (if you'd like to test locally)
- A Marketing Cloud Account with Journey Builder
- A publicly accessible web server (this template was built using a free Heroku account with SSL support
- An App Center account (you'll need to register if you don't have an account already)
This guide covers Heroku, skip this step if you are familiar on how to deploy a Node.js app
- Clone this repository
- Login into Heroku
- Click on New > Create new app
- Give a name to the app and click on "Create App"
- Choose your preferred Deployment method (Github or Heroku Cli are nice to work with)
- Click on "Deploy branch"
- Once your branch is deployed, click on the "View" button and verify you see the welcome message
- Login or create an account in App Center
- Select "Create New App" and then select "Package"
- Enter a Name and Package information
- Enter Login URL as [url of your activity]/login
- Enter Logout URL as [url of your activity]/logout
- Enter Redirect URL as [url of your activity]
- Click "Next" to go to the Integrate tab
- Select Producton or Sandbox based on the type of account your activity will live in and click on "Integrate"
- Login into your Marketing Cloud account and select the Business Unit you'd like to integrate this package with and click "Next" when done
- Select propper data access for your integration
- Copy the App Signature value from the Summary page and save it for later
- Go to the Journey Builder activity tab and click on the plus sign
- Provide a Name for your activity
- Provide a unique value for Key, it can be a random GUID. Copy this value and save for later
- Enter [url of your activity] as your Endpoint URL
- Enter [url of your activity]/help as your help URL
- Select "Messaging" for category
- Click on "Save Changes"
- Open /public/config.json and:
- Replace application_key_from_appcenter_here for the value you got from step 14 from the previous section
- Replace [your-domain-here] with the domain for your website
- Open /public/images and replace with the icons for the activity to your liking
- Log back into Heroku and navigate to your app
- Click on "Settings"
- Click on "Reveal config vars"
- Add a new var called jwtSecret and paste the App Signature you got from step 11 when configuring App Center
- Login into Marketing Cloud and navigate to Journey Builder
- You should be able to see your custom activity and drag it into the canvas!
If you'd like to learn more about building custom Journey Builder Activities and our collection of Custom Activities available to you today, email us at info@devsutd.com
Also, follow us on LinkedIn to get the latest updates and great articles about Salesforce Marketing Cloud!