Salesforce Commerce Cloud

The Salesforce Commerce Cloud (SFCC) integration allows you to sync your data, engage customers at key moments, and personalize your messages.

• Sync your customer, product, and behavioral data to Attentive with our best-in-class native integration with Salesforce Commerce Cloud.
• Send automated high-performing SMS messages such as back-in-stock, low inventory, price drop, and more.
• Segment customers based on past purchasing and browsing activity using product data such as name, category, tag, price, and other attributes.
• Branch SMS messaging journeys using product attributes or inventory. For example, only send a back-in-stock message if the product is available.

Note: To learn more about how you can use product data in Attentive, see Use your product data in Attentive.

With this integration, you can:

• Sync product catalog data from SFCC to Attentive at a frequency of your choosing.
• Sync historical orders (also referred to as “past purchases”) from SFCC to Attentive.
• Sync the following customer attributes to use for segmentation:
  
  • birthday
  • customerId
  • email
  • firstName
  • gender
  • lastName
  • phoneBusiness
  • phoneHome
  • phoneMobile
  • preferredLocale
  • primaryAddress
  • salutation
  • secondName
  • Suffix
  • Last logged in timestamp
  • Custom attributes
• Take advantage of high-performing journeys:
  
  • Back in stock trigger
  • Low inventory trigger
  • Price drop trigger

This integration can also ensure the following events are tracked and can be used to trigger journeys or segment your customers:

• Product view
• Add to cart
• Purchase

Prerequisites

Ensure that you meet the following requirements in order to set up this integration:

• A Salesforce Commerce Cloud account

Limitations

• You can only integrate with one SFCC storefront.
• Your SFCC account must be on one of these versions: 19.10, 21.2, 22.7, or 22.10.
• Your storefront can only integrate with one Attentive account.
• If you use a single storefront for different domains instead of separate storefront sites for each of the domains, your product and image links won’t work. In this case you’ll need to make a change to your cartridge code in attentiveCatalogueDataSync.js to set the variant and image links according to whatever values you have set.
• You can only import variants for products with images.

Now, complete the following steps to set up the integration for Salesforce Commerce Cloud and Attentive.

Step 1. Retrieve the Attentive LINK cartridge

Download the latest cartridge zip file here. This file contains the following cartridges, which are required for full functionality:

• int_attentivemobile – Implements the core storefront functionality
• bm_attentivemobile – Implements the Attentive Mobile Business Manager module for OAuth code
• int_attentivemobile_sfra – Implements the storefront functionality with SFRA code
• int_attentivemobile_controllers – Implements the storefront functionality with Site Genesis code

Note: Site Genesis and SFRA support is broken out into two separate cartridges, so your site only requires one of these: int_attentivemobile_sfra or int_attentivemobile_controllers. In the following procedures, we show the installation using int_attentivemobile_sfra. If your storefront uses Site Genesis, replace int_attentivemobile_sfra with int_attentivemobile_controllers.

Step 2. Add the cartridge to the Cartridges path

1. Log in to your Salesforce Commerce Cloud Business Manager.
2. Navigate to Administration > Sites > Manage Sites.
3. Click the name of the site you want to integrate with Attentive.
4. Select the Settings tab.
5. Add int_attentivemobile_sfra:int_attentivemobile:app_storefront_base to the Cartridges path.
6. Click Apply.
   

Step 3. Add the cartridge to the Business Manager Cartridges path

1. Navigate to Administration > Sites > Manage Sites.
2. Click Manage the Business Manager site.
3. Add bm_attentivemobile:int_attentivemobile to the Cartridges path.
   

Step 4. Upload and import metadata

The Attentive cartridge contains the following defined jobs, services, and site preferences .xml files that you need to upload and import:

• metadata/site-template/jobs.xml
• metadata/site-template/services.xml
• metadata/site-template/meta/custom-objecttype-extensions.xml
• metadata/site-template/meta/system-objecttype-extensions.xml

1. Import the operations metadata:
   1. Navigate to Administration > Operations > Import & Export.
   2. Under Import & Export Files, click Upload.
   3. Upload the jobs.xml and service.xml files listed above.
   4. Under Jobs, import the jobs.xml file.
   5. Under Services, import the services.xml file.
      
2. Import the site development metadata:
   1. Navigate to Administration > Site Development > Import & Export.
   2. Under Import & Export Files, click Upload.
   3. Upload the system-objecttype-extensions.xml and custom-objecttype-extensions.xml files listed above.
   4. Under Meta Data, import the system-objecttype-extensions.xml and custom-objecttype-extensions.xml files.
      

Step 5. Configure your site’s Attentive preferences

1. Navigate to your Business Manager home.
2. Select the desired site from the tabs across the top of the page.
3. Navigate to Merchant Tools > Site Preferences > Custom Preferences > AttentiveMobile.
4. Fill out the settings, as shown in the table below.
5. Click Save at the top of the page.

Step 6. Set service credentials

1. In Business Manager, navigate to Administration > Operations > Services.
2. Select the Credentials tab.
3. Click New.
4. Add the following new credential:
   
   • Name: AttentiveMobile.http.default.credentials
   • URL: https://api.attentivemobile.com/v1
5. Click Apply.
   

Step 7. Add the Business Manager module

1. Navigate to Administration > Organization > Roles & Permission.
2. Click Administrator.
3. Select the Business Manager Modules tab.
4. Select the site to which you want to add the module.
5. Click Apply.
   
6. Search for the Attentive Mobile OAuth row.
7. Check the Write column for that row.
8. Click Update.
9. Navigate to Merchants Tools > Products & Catalogs Section.
10. Click Attentive Mobile OAuth.
11. Click Install.
12. Enter your Attentive username and password.
13. Authorize permission by clicking Authorize.
    A confirmation message appears, and a new OAuth token is added to the site preference Attentive Mobile Access Token.
    

Step 8. Schedule jobs

1. Navigate to Administration > Operations > Jobs.
2. Click the first Attentive job. (The Attentive jobs should all start with AttentiveMobile-.)
   
3. Select the Job Steps tab.
4. Click the token next to Scope.
5. Select the sites to which you want to assign this job and click Assign.
6. Select the Schedule and History tab, and schedule the jobs as follows:
   • Schedule the CatalogDataSync, CatalogueIngestionStatusCheck, and CustomDataSync jobs to run at least once a day.
   • Schedule the OrderDataSync job to run every 15 minutes. The job will send 1,000 orders to Attentive per execution, or about 96,000 orders per day, until all orders between Attentive Mobile Sync Orders Since and Attentive Mobile Sync Orders Until have been downloaded into Attentive.
7. Repeat this procedure for all four Attentive jobs.
   Your Salesforce Commerce Cloud account is now connected and configured to send data to Attentive.

Step 9 (optional): Collect email marketing subscribers at checkout

If you want to collect email marketing subscribers at checkout, follow these steps to enable this feature in SFCC:

1. In the Enable OptIn subscription checkbox in checkout dropdown, select Yes.
2. Work with your CSM to get a new integration sign-up unit created.
3. Paste the sign-up unit ID in the Attentive Signup Source Id field.
   

Questions?

We’re here to help! Contact whiteglove@attentivemobile.com to ask about the Attentive + Salesforce Commerce Cloud integration.