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 triggered, high-performing SMS messages with back-in-stock journeys, low inventory journeys, price drop journeys, 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.

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
  • Low inventory
  • Price drop

This integration can also help 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.

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

Step 2. Add the cartridge to the Cartridges path

1. Log in to your Salesforce Commerce Cloud Business Manager.
2. Go 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. Go 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. Go 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. Go 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. Go to your Business Manager home.
2. Select the desired site from the tabs across the top of the page.
3. Go 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, go 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. Go 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. Find the Attentive Mobile OAuth row.
7. Check the Write column for that row.
8. Click Update.
9. Go to Merchants Tools > Products & Catalogs Section.
10. Click Attentive Mobile OAuth.
11. Click Install.
12. Enter your Attentive username and password.
13. Click 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. Go to Administration > Operations > Jobs.
2. Click the first Attentive job. Attentive jobs should all start with AttentiveMobile-.
   
3. Click 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:
   1. Schedule the CatalogDataSync, CatalogueIngestionStatusCheck, and CustomDataSync jobs to run at least once a day.
   2. Schedule the OrderDataSync job to run every 15 minutes. The job sends 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

Follow these steps if you want to collect email marketing subscribers at checkout:

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.