New AdminPlaybooks

Install the Unmanaged Package or Solution

By December 2, 2019December 10th, 2020No Comments

Install the Unmanaged Package or Solution

Step by step guide to installing Playbooks files to your CRM



Depending on your CRM, the steps and files you need will be a bit different.  Select your CRM from the options below to see the appropriate steps.


Before installing Playbooks in your CRM, review the requirements below.

  1. Review the Salesforce minimum requirements
  2. User completing the installation must have the Salesforce System Permission to “Download AppExchange Packages”.
  3. At least 11 available Custom Task fields.
  1. Review the Microsoft Dynamics minimum requirements.
  2. Must be using Dynamics Enterprise Edition.
  3. Must have ‘Full User’ license.
  4. The following versions of Dynamics are supported:
    • 8.0
    • 8.1
    • 8.2
    • 9.0


There are three unmanaged packages to choose from:

  • Playbooks Essentials (without Email or Inbound Reporting)
    This is the latest version of the unmanaged package. This is the most basic package, so only install this version if your Salesforce environment does not have adequate space for additional custom fields.
  • Playbooks Essentials + Email Reporting
    This is the same Playbooks Essential package but with additional email fields.
  • Playbooks Essentials + Email and Inbound Reporting
    This has the same fields as the other two packages but with additional inbound call fields.

Click here to review what is included in each unmanaged package.

  1. When an account is provisioned, the Integration User will get a Welcome email. Click the GET PLAYBOOKS button in the email to get started.
  2. In a new Chrome tab, the Integration User must login to your Salesforce org.
    NOTE: Do NOT “Login As” the Integration User from the user details page. You must be natively logged in as the Integration User.
  3. Return to the Chrome tab with the Setup Wizard.
  4. Login to Playbooks. Depending on the credential type you requested during the provisioning process, you will either need to enter the Integration User’s email address and newly created password or use the “Sign in with Salesforce” option.
  5. Next, you will be brought to the “Install Unmanaged Package” screen. For details about what is included in each of the unmanaged packages, review this article.
    • If you are ready to install the unmanaged package click on the ‘INSTALL NOW’ text.
    • If you’d like to wait or skip this step entirely, check the box to indicate “I have installed the required package”.
  6. If you selected to install the unmanaged package, a new Salesforce App Exchange tab will be opened, and you will be directed to the Playbooks Fields & Reports unmanaged package.
    1. Change the option for “What if existing component names conflict with ones in the package” to the bottom option of “Rename conflicting components in package”.
    2. Select the middle option to ‘Install for All Users’.
      NOTE: Installing for all users does NOT enable
      Playbooks application for all users in your Salesforce organization.  Rather, it enables all new app-specific profile permissions added by Playbooks so that the application will function properly. This will make it much easier to add users from various profiles to Playbooks application in the future.
  7. Click Install. The installation process should take only a couple minutes to complete. You will see a completion alert as well as an email from once it was successfully installed.
  8. Return to the ‘Setup Wizard’ Chrome tab and check the box “I have installed the required package” box.
  9. Then click the NEXT button.

There Are 2 Solutions to Import:

  1. XANT Playbooks Solution – contains the fields and security role needed for installation
  2. Playbooks Activity Solution – contains views, charts, and dashboards

Click here to review what is included in the Solutions.

Download and import the correct Solution File for the version of Dynamics you are running (8.0, 8.2, or 9.0). This is indicated at the end of the Solution name.

Playbooks Solution Links

Importing the Solution Files

To Import the Solution into Dynamics

  1. In Dynamics, navigate to Settings > Customizations > Solutions.
  2. Click the Import button, then browse to the Playbooks Solution.
  3. When prompted, click Next, then Import.

Playbooks User Role

Some Playbooks functions are dependent on user access to specific fields. The Playbooks for Dynamics Unmanaged Solution includes a role that contains the required field permissions, Playbooks User.

Adding this permission to each user’s profile enables them to add records to Playbooks, synchronize activities with Dynamics, and more.

To Assign the Playbooks User Permission

  1. Navigate to Dynamics Settings.
  2. Click Security.
  3. Click Users.
  4. Click Select User Record.
  5. Click [Manage Roles].
  6. Click the checkbox next to Playbooks User.
  7. Click OK.



Was this article helpful?