Skip to content

reelevant-tech/salesforce-marketing-integration

Repository files navigation

Salesforce Marketing Cloud Integration [SMC] - Reelevant

This project is a Block Widget for SMC's Content Builder.

A Block Widget is a simple web-hosted application iframed inside Content Builder, that use Content Builder Block SDK. The Content Builder SDK is a cross-document wrapper, which lets your custom block’s HTML page update the content block within the app in real time. (behind the scene it uses postMessage browser's API)

This app enable direct access to Reelevant's generated blocks inside SMC.

Usage

Production

Since the current authentication system use a cross_site authentication (you need to log within https://app.reelevant.com to access blocks within the widget) and to avoid CSRF we whitelist with CORS the URL of where this widget is hosted, which is currently: https://smc.reelevant.com. If you want to host your own instance, you'll need to communicate URL of your instance so we can whitelist it.

Development

The easiest way to debug this widget is to use the blocktester app (docs):

  • Run yarn start
  • Go to blocktester app
  • Enter http://localhost:8083 as the widget URL
  • Click on a "block" zone at the right to load the widget.
  • The widget UI will appears on the left, right zones represent what will be rendered within SMC.

Notes

Apart from shared components, this app conforms to Ligthning Design Principles from Salesforce. We have also added a CSS rule to force Salesforce Sans

Documentation links