> For the complete documentation index, see [llms.txt](https://docs.valorx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.valorx.com/valorx-wave/wave-advanced/manage-campaigns-and-sales-cadences.md).

# Manage Campaigns and Sales Cadences

Use Wave [grid actions](/valorx-wave/wave-experience/create-a-new-grid/grid-wizard-in-salesforce.md#grid-action) to manage Campaign and Sales Cadence membership directly from your grid. You can select multiple Contacts or Leads and add them to a Campaign, add them to a Sales Cadence, or remove them from a Sales Cadence without leaving the Wave Embedded grid.

## Why Use These Grid Actions?

When working with a list of Contacts or Leads, you may need to **perform the same Campaign** or **Sales Cadence** action for **multiple records**.

Instead of managing each record separately, you can select the records directly in your Wave grid and perform the action in one step.

For example:

> You have 5 Contacts in a Wave grid and want to add them to a Campaign. Select the Contacts, choose **Add to Campaign**, select the Campaign and Member Status, and complete the action.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F6wMLiUVnS2Y3QPYKVyi3%2FAssign%20Campaign.gif?alt=media&amp;token=344ea699-8cd7-4105-9bd3-8fbc841230fc" alt=""><figcaption><p>Add Contact to Campaign</p></figcaption></figure>

The selected records are then processed by Salesforce.

### What can you do?

<table><thead><tr><th width="152.0001220703125">Action</th><th>What it does</th><th>Result</th></tr></thead><tbody><tr><td><strong>Add to Campaign</strong></td><td>Adds selected Contacts or Leads to an active Campaign</td><td>The selected records become Campaign Members</td></tr><tr><td><strong>Add to Cadence</strong></td><td>Adds selected Contacts or Leads to an active Sales Cadence</td><td>The selected records are assigned to the selected Sales Cadence</td></tr><tr><td><strong>Remove from Cadence</strong></td><td>Removes selected Contacts or Leads from a Sales Cadence</td><td>The selected records are removed from the applicable Sales Cadence</td></tr></tbody></table>

These actions are configured as Wave grid actions using Salesforce Screen Flows.

***

## Before You Start

Before configuring these grid actions, make sure the following are available in your Salesforce org.

* The supplied flows are deployed and active:
  * **Add to Campaign**
  * **Add to Cadence**
  * **Remove from Cadence**
* Users have access to the required flows and Salesforce objects.
* For **Add to Campaign**, at least one active Campaign is available.
* For **Add to Cadence** and **Remove from Cadence**, Salesforce Sales Engagement is enabled and the required Sales Engagement access is available.
* You are configuring the actions on a **Contact** or **Lead** grid.

The supplied flows use a variable named `selectedRecordIds` to receive the records selected in the Wave grid.

> **Tip:** If you want the same action on both a Contact grid and a Lead grid, configure the grid action separately on each grid.

### Get the source code

The source code is provided as separate packages so you can deploy only the functionality you need.

#### Manage Campaign

Use this package if you want to add the **Add to Campaign** grid action to your grid.

**Download:** `Manage Campaign.zip`

{% file src="/files/400g6LxgGOK3HOSEkogi" %}

#### Manage Sales Cadence

Use this package if you want to add **Add to Cadence** and/or **Remove from Cadence** grid actions to your grid.

{% hint style="warning" %}
**Developer Note:** The **Sales Cadence** object must be available and accessible in the Salesforce org to use this functionality. If the required access is not available, the **Add to Cadence** and **Remove from Cadence** actions cannot be added or used.
{% endhint %}

**Download:** `Manage Sales Cadence.zip`

{% file src="/files/eq2N0YdDhyIdNH6JGprj" %}

***

## Deploy The Source Code

After downloading the package, you can deploy the metadata to your Salesforce org using **Salesforce Inspector Reloaded** or your preferred Salesforce deployment method.

#### Using Salesforce Inspector Reloaded

1. Download the source code package for the functionality you want to use.
2. Open **Salesforce Inspector Reloaded** in your Salesforce org.
3. Click on **Download Metadata button.**
4. Click **Import package .xml or package zip file** button.
5. Upload the zip files.
6. Then click open to deploy the metadata to your org.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FmcaTRSYwV2toHJW9W7zB%2FUpload%20Add%20to%20Campaign.gif?alt=media&amp;token=dd726eb4-d2a5-407d-b163-e8081b27538a" alt=""><figcaption></figcaption></figure>

> **Note:** The exact Salesforce Inspector Reloaded options may vary depending on the version of the extension you are using.

***

## Configure the Grid Action on the Contact Grid

### Configuration Steps

{% stepper %}
{% step %}

#### Adding the Button

* Select an existing Contact/Lead grid or create a new Contact/Lead grid.
* Go to the **Actions** tab.
* Click on the **Grid Actions** tab
* Click **+ Grid Action** button.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FtYjW1KpSlJtdCIS0Kr2x%2FConfigure%20Grid%20Action.gif?alt=media&amp;token=fb48cc2f-1725-4127-8558-9c629931e110" alt=""><figcaption><p>Go to Actions tab</p></figcaption></figure>

* Enter the grid action details:
  * **Label:** Enter the name you want users to see.
  * **Tooltip:** Add a short description of the action.
* Click **Next**.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FtSGkzSbOoYCnCDJJXdhZ%2FStyling%20Grid%20Action.gif?alt=media&amp;token=df5ed6c6-c3f3-47dc-9e38-f21c72a09111" alt=""><figcaption><p>Set the Label and Tooltip</p></figcaption></figure>
{% endstep %}

{% step %}

#### Connect the Button to the Flow Component

* **Salesforce Component:** Select **Flow**.
* **Flow:** Select the Flow that matches the action.

For example:

| If you want to add...           | Select this Flow      |
| ------------------------------- | --------------------- |
| Campaign membership             | `Add to Campaign`     |
| Sales Cadence membership        | `Add to Cadence`      |
| Remove Sales Cadence membership | `Remove from Cadence` |

* Enter the success message to display after the email is sent.
* Click **Next**.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FAIMHfD0NSrMG2hpJ3zXn%2FSet%20the%20Action%20button.gif?alt=media&amp;token=2ab81f04-61ae-402a-a888-a2ca539ead5f" alt=""><figcaption><p>Connect the Button to the LWC Component</p></figcaption></figure>
{% endstep %}

{% step %}

#### Set the Variable and Save

Add the `selectedRecordIds` variable so the Flow knows which Contacts or Leads the user selected in the grid.

Configure it as:

<table data-search="false"><thead><tr><th>Setting</th><th>Value</th></tr></thead><tbody><tr><td>Variable Name</td><td><code>selectedRecordIds</code></td></tr><tr><td>Data Type</td><td>String</td></tr><tr><td>Parameters</td><td><code>selectedRecordIds</code></td></tr></tbody></table>

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FGas45hkUx1kjrDuowzjM%2FSet%20the%20Action%20variables.gif?alt=media&amp;token=e634a178-26ae-4687-90e6-e9f722a03700" alt=""><figcaption><p>Set the Variable and Save</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## What Each Action Does

Once the grid actions are configured, users can select multiple records directly from the grid and choose the action they need.

### Add to Campaign

Use this action when users want to add selected Contacts or Leads to a Campaign.

After selecting the records, the user chooses:

1. A Campaign
2. A Campaign Member Status
3. Whether to update the status of existing Campaign Members

The selected records are then added to the Campaign as Campaign Members.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FmQjIS9kW1YDWV9iR3JAq%2FAdd%20to%20Campaign%20.gif?alt=media&amp;token=d70b4f66-d0cf-4902-9930-31019418560d" alt=""><figcaption><p>Add to Campaign</p></figcaption></figure>

***

### Add to Cadence

Use this grid action when users want to add selected Contacts or Leads to a Sales Cadence.

After selecting the records, the user chooses:

1. A Sales Cadence
2. Who the targets should be assigned to:
   * **Record owner**
   * **Me**
   * **Another Sales Engagement user**

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FcwPFFMdLMc9l6DzaURr0%2FAdd%20to%20Sales%20Cadence.gif?alt=media&amp;token=5d48c921-acc9-4b27-b6a3-f342c0bee4f0" alt=""><figcaption><p>Add to Cadence</p></figcaption></figure>

***

### Remove from Cadence

Use this grid action when users want to remove selected Contacts or Leads from a Sales Cadence.

The user can choose to remove the records from:

* All cadences where the target is assigned to them
* All cadences for the target
* A specific cadence

The user can also select an optional **Disposition**, such as **Customer Connected**, **No Response**, or **Not Interested**.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2Fo9CCJ7SLuGgfntNgj2ey%2FRemove%20from%20Sales%20Cadence.gif?alt=media&amp;token=314be21d-d57b-4aea-8f64-600393731573" alt=""><figcaption><p>Remove from Cadence</p></figcaption></figure>
