Skip to main content
Conversations: Salesforce Integration

Connect and use Salesforce for Conversations in Meltwater Engage.

Cheyenne V. avatar
Written by Cheyenne V.
Updated yesterday

This user guide is intended to assist you with connecting and using the Salesforce integration feature in Meltwater Engage.

This article will cover:


Prerequisites

Before you connect your Salesforce account to Meltwater, it is important to verify that your Salesforce account has all the required permissions enabled to ensure a successful Salesforce connection. Additional setup may be required within your Salesforce instance to grant proper permission. These settings cannot be verified or updated by Meltwater, so we suggest you contact your company's Salesforce Administrator to assist with verifying and editing permissions as needed. Without proper permissions, your Salesforce connection will cause errors when using it within Engage.

Necessary Salesforce permissions

  • Required Salesforce Edition: Enterprise or Unlimited

  • The connected Salesforce organization must have API Access enabled

  • The connecting Salesforce account must have view, create, and edit permissions for Salesforce Leads and Cases


Salesforce Account Setup

Note: This section is intended for Salesforce administrators to use to assist with verifying and updating the required permissions before connecting your Salesforce account to Meltwater.

Follow the steps below to access and review your Salesforce user permissions to ensure their access is correct. All actions are taken directly within Salesforce.

  1. Go to the setup screen by clicking the cog in the top right corner

  2. Then select Setup

  3. Once in setup, on the left, expand Users under the Administration section. If you already know the user(s) permission set, select Permission Sets, then click here to skip ahead.

  4. If you do not know the user(s) permission set, select Users.

  5. Click on the user(s) whose permissions you need to check/update.

  6. In the user details screen, underneath their name in the top left, select Permission Set Assignments.

  7. This screen will display the Permission Set Label for this user. Click the link for this user's permission set to go to the Permission Sets details screen.

Permission Sets

  1. Once in the permission set, go to System Permissions near the bottom of the page.

  2. On the next page, click the Edit button at the top of the table.

  3. Once in edit mode, you can make any necessary edits to a user's permission as needed. Permissions are in alphabetical order and can be searched for, using the search bar at the top of the page.

Enable API Access

The Meltwater user that will be connecting Salesforce to Meltwater will need API Enabled with their Salesforce permission set. This permission gives the user access to any Salesforce.com API. If the user does not have this permission enabled, you must enable the API Enabled option.

  1. Click Save at the top and yes to any prompts or popups.

Enable Access for Salesforce Objects

The Meltwater user connecting Salesforce to Meltwater will also need to be able to view, create, and edit permissions for Salesforce Leads and Cases within their Salesforce user settings.

  1. From the same Permission Set screen as above, select Object Settings near the top.

  2. From the object settings page, search for the Salesforce Object you want to modify access controls for. We will need to make edits for both Leads and Cases. In this example, we’ll enable full access to cases by finding Cases in the list of objects

  3. Select Cases to open this screen.

  4. If the user does not have all appropriate object permissions enabled, like above, click Edit.

  5. Under Object Permissions, check Enabled beside all permission names: Read, Create, Edit, Delete, View All, and Modify All

  6. Click Save.

  7. Then, follow the same exact steps, except for the Leads object.

  8. Once these above settings are updated, you may connect Salesforce to Meltwater!


Connecting Salesforce to Meltwater

Unlike social account connections in Engage, which are found under Social Connections, Salesforce connections are made under Third party integrations.

Here, you can connect your Salesforce instance, which is owned and managed by your company. Only one Salesforce account may be connected per Meltwater account. Connections do not expire, and they do not require the assignment of individual Engage users for access.

  1. Select the Account drop-down in the left-hand navigation bar

  2. Click Third party integrations


Salesforce Cases in Conversations

Creating Salesforce Cases from Conversations

After successfully connecting your Salesforce account to Meltwater, you will be able to create a new Salesforce Case within Conversations for any fan message from any user for any social channel.

  1. To access Salesforce options for a message, click the kebab menu next to the message

  2. Click Salesforce.

  3. A new Salesforce pop-up will appear featuring four tabs: Create Case, Create Contact, Create Lead, and View Cases. By default, the Create Case tab will display first for any message that does not already have a created case. If a case does exist already, this tab will instead read Edit Case.

    Let's focus on the first option, Create Case. This contains several required and optional fields:

    • Case Subject (required)

    • Name (optional)

      • This field is prepopulated with the message author but can be edited.

      • This field shows up in Salesforce as ‘Web name’

    • Status (required)

    • Priority (required)

    • Email (optional)

    • Mobile Phone (optional)

    • Related Contact (optional)

      • This dropdown populates with any contacts already existing in salesforce that match the text in the ‘Name’ field.

      • If no existing Salesforce contact matches the Name field, you can create a new contact or leave it blank.

    • Related Account (optional)

      • This field populates with any salesforce accounts that are associated with the chosen Related Contact

      • If no Related Contact is shown, this will pre-populate with all existing Salesforce accounts.

    • Description (optional)

      • This field is pre-populated with:

        • Message Type

        • Date and Timestamp of message

        • Social profile name

        • The text content of the message

        • URL of message on the native social channel

      • Users can remove or append this description field as needed.

    • Update (optional)

      • This field corresponds to feedview updates on a case within Salesforce.

      • Users can add as many updates to a case upon creation as they would like.

  4. Once all required fields are completed, the Create Case button will be available.

  5. Click Create Case to create a new case for this fan message in Salesforce!

  6. After clicking Create Case, the pop-up will close and you will receive a confirmation message in the lower lefthand corner that the case has been created in Salesforce.

  7. Once a case has been created in relation to a message, the threaded view will show a Salesforce cloud icon to indicate that a case exists for that message.

Managing an Existing Salesforce Case

Once a case has been created in relation to a message from within Conversations, you can then view the case details and updates.

  1. Click the kebab menu for a message

  2. Select Salesforce when a case already exists, the Create Case tab will instead read Edit Case and will populate the current Salesforce case details.

  3. Each time you click Salesforce from within Meltwater, we make a live call to Salesforce. This means you will always see the most up-to-date information, including any updates that were made in relation to the case directly within Salesforce.

  4. The case is completely editable, so make sure to save any edits to an existing case by clicking Save Case. This will update the case in Salesforce, present a success message in Meltwater, and close the Salesforce pop-up

Deleting an Existing Salesforce Case

The Edit Case tab also includes a Delete Case option.

If a user selects Delete Case:

  • A message will display, asking for confirmation to delete the case.

  • If confirmed, this will delete the case in Salesforce, present a success message in Meltwater, and close the Salesforce pop-up.


Salesforce Contacts in Conversations

Searching for Existing Contacts and Linking

Before creating a new contact in Salesforce, it's best practice to first search and confirms that there isn’t already an existing contact in Salesforce. This way, if a contact already exists in Salesforce, you can link the message owner in Meltwater to that already existing Salesforce contact.

  1. Click the kebab menu next to the message

  2. Select Salesforce.

  3. A new Salesforce pop-up will appear featuring four tabs. The second tab is Create Contact.

  4. To check for existing Salesforce contacts, enter the social profile’s name or email address into the provided search bar.

    Note: You can also search for and link contacts via the Related Contact option in the Create Case tab.

  5. If any matching Salesforce contacts are found, they will return in a dropdown.

  6. Click on the existing profile to link the selected message

  7. After clicking the contact, a pop-up will display a Salesforce contact box with all available details that are present in Salesforce for that contact. You can then use this information to verify that the profile and contact relate to the same individual in Meltwater.

  8. If you determine that this is the correct contact, you can click Link Profile to link the Salesforce contact to the user profile in Meltwater.

  9. Clicking Link Profile will close the pop-up, and display a success message.

  10. If it is not the right contact, you can select another dropdown option or perform another search.

  11. If no related Salesforce contact is found and verified as correct, you can select the Create Contact option at the bottom of the pop-up.

Creating a New Contact

If you are unable to find a profile to link to and need to create a new contact:

  1. Click Create Contact. This will display the following form.

    Several fields are available, with only one required:

    • First Name (optional)

      • Prepopulated from inferred first name using social handle, but can be edited.

    • Last Name (required)

      • Prepopulated from inferred last name using social handle, but can be edited.

    • Email (optional)

    • Mobile Phone (optional)

    • Parent Account (optional)

      • Prepopulates with all existing Salesforce accounts.

    • Description (optional)

      • This field is pre-populated with:

        • The message type of the related message

        • Date and Timestamp of related message

        • Social profile name

        • The text content of the related message

        • URL of message from fan on the native social channel

      • You can remove or append this description field as needed.

  2. Once all required fields are completed, click Create Contact to create a new contact in Salesforce, and link that profile to the user in Meltwater.


Salesforce Leads in Conversations

Searching for Existing Leads and Linking

Before creating a new lead in Salesforce, it's best practice to first search and confirms that there isn’t already an existing lead in Salesforce. This way, if a lead already exists in Salesforce, you can link the message owner in Meltwater to that already existing Salesforce lead.

  1. Click the kebab menu next to the message

  2. Select Salesforce.

  3. A new Salesforce pop-up will appear featuring four tabs. The third tab is Create Lead.

  4. To check for existing Salesforce leads, enter the social profile’s name or email address into the provided search bar.

  5. If any matching Salesforce leads are found, they will return in a dropdown

  6. Click on the existing profile to link the selected message.

  7. After clicking the lead, a pop-up will display a Salesforce leads box with all available details that are present in Salesforce for that lead. You can then use this information to verify that the profile and lead relate to the same individual in Meltwater.

  8. If you determine that this is the correct lead, you can click Link Profile to link the Salesforce lead to the user profile in Meltwater.

  9. Clicking Link Profile will close the pop-up, and display a success message.

  10. If it is not the right lead, you can select another dropdown option or perform another search.

  11. If no related Salesforce lead is found and verified as correct, you can select the Create Lead option at the bottom of the pop-up.

Creating a New Lead

If you are unable to find a profile to link to and need to create a new lead,

  1. Click Create Lead. This will display the following form.

    Several required and optional fields are available to complete:

    • First Name (optional)

      • Prepopulated from inferred first name using the social handle, but can be edited.

    • Last Name (required)

      • Prepopulated from inferred last name using the social handle, but can be edited.

    • Company (required)

      • Text field.

      • THIS IS NOT RELATED TO ACCOUNTS. This is one of the main differences between Salesforce contacts and leads. Contacts should be related to existing accounts while leads do not.

    • Source (optional)

      • Dropdown listing social channels.

      • Pre-populated based on related messages but editable.

    • Description (optional)

      • This field is pre-populated with:

        • The message type of the related message

        • Date and Timestamp of related message

        • Social profile name

        • The text content of the related message

        • URL of message from fan on the native social channel

      • Users can remove or append this description field as needed.

  2. Once all required fields are completed, click Create Lead to create a new lead in Salesforce, and link that profile to the user in Meltwater


💡 Tip

Need more help? Feel free to reach out to us via Live Chat or check out our Customer Community.

Find answers and get help from Meltwater Support and Community Experts.


Did this answer your question?