signNow for Salesforce Setup Guide

Learn how to set up and customize the signNow for Salesforce app.

Download the SignNow for Salesforce Quick Start Guide

What’s Included:

  • Adding the signNow API Endpoint
  • Creating a ‘Send with signNow’ Button
  • Placing Your New Button on the Account View
  • Adding the Document Status Canvas
  • And more…

Sending Quotes for Signature With SignNow for Salesforce

Need to get Salesforce quotes signed? Follow these instructions to learn how!

Here you can create the content that will be used within the module.

Prerequesites

This guide is written under the assumption you have already successfully installed the signNow for Salesforce package in your Salesforce account, and have knowledge of the signNow components and how they work. If not, please follow the directions in the Quick Start Guide on this page: https://signnow2016.wpengine.com/integrations/salesforce/.

*UPDATE* Sending quotes for signature is now done with an extension package with the latest version of signNow for Salesforce. Please make sure you are running the latest version of the signNow package by checking the version on Salesforce AppExchange and comparing it with the version you have installed in your Salesforce account – https://appexchange.salesforce.com/listingDetail?listingId=a0N3000000B5E7FEAV. Updating to the latest package is easy, just click the Get It Now button and follow the instructions. If you already have signNow installed on your Quote objects, you will be prompted to download the Quotes Extenstion package when you try to send a quote. Follow the instructions and you will be quoting from Salesforce in no time!

Direct download link for signNow Quotes Extension package: https://na34.salesforce.com/packaging/installPackage.apexp?p0=04t15000000ouzM

Step 1 – Add The signNow Components To Your Quote Objects

If you have not yet set up your Quote object for sending documents for signature:

Edit the Quote object layout and drag the Canvas App snstatus into the object layout so you can view the status of documents sent from the Quote record.

Create a new button for sending quotes for signature and drag it into the Custom Buttons area of your Quote layout. The code to use is below:

window.location = '/apex/cudasign__cn_quotes?id={!Quote.Id}&type=quote';

Step 2 – Create A New Quote For An Opportunity

Navigate to one of your oppportunities and click the “New Quote” button to create a new quote.

screenshot

Type in a name and click save.

screenshot

Step 3 – Create The Quote PDF

Click the Create PDF button and select “Standard Template”. This is the standard Salesforce quote template that comes preset with your Salesforce account.

*Note* At this time, automatic quote sending is designed to work with the Salesforce Standard Template only. Please do not edit the Standard Template as it may cause errors in the esignature sending flow.

screenshot

Next, you will be presented with a PDF Preview. Note how the line items section will include whatever line items or products you have added to the quote, and the totals are automatically calculated.

Click the “Save to Quote” button.

screenshot

Note how we now have one quote PDF created in the Quote record.

screenshot

Step 4 – Sending the Quote

Click your Quote With signNow button to begin the quote sending process

screenshot

Choose the quote PDF you’d like to send. If you have multiple PDFs on this record, you will be able to select which one you would like to send for signature. Click the “Send to signNow” button.

screenshot

Rename the document if necessary, then click “Create”.

screenshot

Add your signer’s email and adjust the sending settings (optional). You can also customize the email subject and body if you’d like. Click the send button at the bottom when you are ready to send the document for signature.

screenshot

Congratulations! You have just sent a quote for signature with signNow.

screenshot

Step 5 – What Happens Next

Go back to your Salesforce record and view the Quote status.

screenshot

Your signer will recieve an invite to his or her email. Opening the invite will prompt the user to sign the document.

screenshot
screenshot

Behind the Scenes Secrets

This quoting process makes use of signNow’s “Magic Field” technology, which scans the text on the document for certain triggers that tell signNow where to place a field and what kind of field it should be. The Salesforce standard quote template is one example of how this technology helps signNow and our customers optimize their document workflows!

Adding Salesforce Data Into Templates (Using Annotations)

The signNow for Salesforce app enables you to pull information from Salesforce (like Name, Title, etc) and have insert it into templates automatically, where you’ve indicated.

Adding Salesforce Annotations

These annotations are added in your signNow account, by editing the appropriate template. Click on “More” next to the template you’d like to use then click on “Salesforce Annotations.”

screenshot

Placing Annotations On The Template (Standard Object and Fields)

For standard Salesforce objects and fields (i.e. you haven’t created them yourself) the format will be as shown below.

screenshot

The proper format is “objectname.fieldname”. So to get the Name field from a Contact object, you would enter contact.name.

Placing Annotations On The Template (Custom Objects and Fields)

For CUSTOM Salesforce objects and fields (i.e. you HAVE created them yourself) the format will be as shown below.

screenshot

The proper format is “customobjectname__c.customfieldname__c”. So to get a field called Subscription from an object called Customer, you would enter customer__c.subscription__c (that’s two underscores before the letter “c”).

How to Find the Correct ID for Object and Field Names

In order to make sure that you’re using the correct ID for objects and fields, you can use the Salesforce Developer Console to confirm that. Click on your name at the top, then select Developer Console. A window will pop up. Click File — Open.

screenshot

Select the Object You’d Like to View

Under “Entity Type” click on Objects then on the right find the name of the specific object. Double click that object name to proceed. In this case, you see that “account” is what you would use in your Salesforce Annotations for the Account object.

screenshot

Verify the Correct ID for the Field

Once your object details appears, you can sort the fields by Name to make it easier to find what you need. In this case, we’re looking at (1) the Account object, then the (2) Billing State field, which you can see below. Once you’ve selected “BillingState” click on (3) Query to verify the correct ID for that field. Here we see that it’s (4) BillingState. So the Salesforce annotation would be “account.billingstate” (you can use all lowercase).

screenshot

NOTE: If you do not see the desired field listed here, that means Salesforce has not made it accessibleand we are therefore unable to import the data into the signNow template.

*FINAL NOTES*

It’s important to understand that Salesforce Annotations are object specific. If your annotation says “account.name” and you try to use that template to pull data from an Opportunity object, IT WILL NOT WORK. Your template must only pull data from one object type, and you must always match up the correct template to the object you are sending from.

signNow for Salesforce – Template Settings Instructions

Template Settings takes your workflow customization to the next level.

PREREQUISITES

This guide is written under the assumption you have the signNow for Salesforce integration up and running already and have working knowledge of Salesforce and the signNow integration components.

As a general best practice, when editing your signNow integration, we recommend downloading the latest version of the package from the Salesforce AppExchange here https://appexchange.salesforce.com/listingDetail?listingId=a0N3000000B5E7FEAV. If you are up to date on your signNow package, you may proceed with setting up your Template Settings.

Step 1 – Accessing the Template Settings Object

Click the “+” on the top menu bar to view all your Salesforce objects.

screenshot

Find the Template Settings object and click it.

screenshot

Step 2 – Creating Your Template Settings

Click the “New” button to create a new Template Setting.

screenshot

Now its time to add the details of this specific Template Setting.

Give your template settings a name.

Type in a custom email subject, body, TemplateSetting name, and document name. Leave the trigger field blank. You can use data from the fields on your object, like how you see {Contact.Name} and {Contact.Email} in the following code and screenshot, which will be replaced with the appropriate data from the Salesforce record.

The code for your roles will be in JSON format. If you are not a coder, don’t worry! Once you know what you’re looking at it’s easy to understand. Here is the code in the following screenshot:

[
  {
    "order": "1",
    "name": "FIN",
    "email": "{Contact.Email}",
    "allow_forwarding": "yes"
  },
  {
    "order": "2",
    "name": "MSP",
    "email": "m2@mailinator.com",
    "allow_forwarding": "no"
  }
]
screenshot

So how does this JSON code work? There are four required attributes which cover the customizable aspects of your template. Copy the format in the code snip above and modify it to your needs. You can adjust the number of roles as needed and change any of the attributes based on the table below:

screenshot

SAVE YOUR NEW TEMPLATE SETTINGS!

Next, copy the record ID from your new Template Setting Object URL and save it for later.

screenshot

Step 3 – Creating a New Send Button For Your Template Settings

In this example we made our Template Settings for the Contact object, so we will add a button to the Contact Object.

Use the following code, and be sure to place your Template Settings record ID in the correct location:

window.location = '/apex/cuda_signnow__sn_global_attachment?id={!Opportunity.Id}&type=attachment&TemplateSettingsId=TEMPLATESETTINGSIDGOESHERE';

Remember to select “Detail Page Button” for Display Type, “Execute Javascript” for the Behavior, and “OnClick Javascript” for the Content Source.

screenshot

Save your new button!

Next, drag the new button into your object layout and save it.

screenshot

Step 4 – Adding Text Tags to a Document to Apply the Template Settings to

The text tags on this document must match the roles you created with the JSON code in the Template Settings. For more information on text tags, please visit: https://techlib.barracuda.com/cudasign/generatetexttags/

Here are what text tags for this example looks like:

screenshot

Step 5 – Uploading The Document to Notes & Attachments

Click “Attach File” and follow the instructions to upload the document.

screenshot

Step 6 – Sending the Attachment With Your Template Settings

Click your new Template Settings button (labeled “Intronis Template” in the screenshot) to start the sending process.

screenshot

Next you will be presented with all the attachments you have added to this Salesforce record. Be sure to select the correct attachment that has text tags that match your template settings.

screenshot

Review and/or modify template settings, then click the send button.

screenshot

View the document status from the Salesforce record.

screenshot

Final Notes

You can create as many individual template settings as you want. For each different template setting you will need to create a new custom button by using the standard template setting button code and replacing the correct template setting ID. Always make sure the attachment you are sending has text tags with roles that match the roles specified in your template setting or else the process WILL NOT WORK.

Template Settings: Using the Master Object

A new feature in Template Settings is the ability to set a Master Object. This will allow you to merge data from objects connected to the object you are sending from. Currently this works for the Opportunity object only. Implementing the Master Object in your template settings will allow you to send a document from an Opportunity and merge data from the connected Account and Contact objects.

Step 1 – Accessing the Template Settings Object

Click “Setup” in the upper right hand corner.

Navigate to: Build > Create > Objects – in the left side menu.

screenshot

Find the object titled “TemplateSetting” Click on it (not the edit button).

screenshot

Step 2 – Activating the Master Object

You should now be looking at the TemplateSetting Object.

Find “Master Object” in the “Custom Fields & Relationships” section of the page and click on it.

screenshot

You should now be looking at the Master Object.

Click the “View Field Accessibility” button.

screenshot

You should now be looking at the Field Accessibility screen for TemplateSetting. You should see “Hidden” as the Field Access value for most if not all of your profiles. Start with the first row and click “Hidden”.

screenshot

You will now see the Access Settings for the Master Object field. In the Page Layout section, check the “Visible” box, then click “Save”.

screenshot

You will be taken back to the Field Accessibility screen. In my case field access for every profile has automatically changed to “Editable”. This is not always the case. If you have some profiles that still show “Hidden”, we recommend clicking on them and checking the “Visible” box like you did for the first row.

screenshot

Step 3 – Adding the Master Object to Your TemplateSetting

Click the “+” on the top menu bar to access all your objects.

screenshot

Next, click on TemplateSettings

screenshot

If you have multiple TemplateSettings you will be presented with all of them. Click to open the one you would like to use the Master Object with.

screenshot

Click the “Edit” button.

screenshot

Now, type “Opportunity” into the Master Object field and click save.

screenshot

Step 4 – Adding A Primary Contact to Your Opportunity

In order for the Master Object to pull data from connected objects, you must set a Primary Contact on your Opportunity.

To do this, open your opportunity. Hover over “Contact Roles” and click the “New” button to add a contact role if you do not already have one on this opportunity.

screenshot

If you already have a contact role on the opportunity, please make sure you check the box to left of the contact’s name to make him or her the Primary Contact. Save any edits!

screenshot

And Thats It!

Any time you use this specific TemplateSetting to send a document for signature (and you must send from an Opportunity, as that is the Master Object), you will be able to pull data from the connected Account and Contact. Take a look at the TemplateSetting screenshot above, and you will see the body and document name reference fields from the Account and Contact object. You can even use a tag like {Contact.Email} in the Roles JSON code, and it will automatically send the invite to the Contact’s email.

Creating Permission Sets For signNow in Salesforce

On some editions of Salesforce, such as the Group or Professional editions, setting permissions for the signNow apps is different than the instructions in the Quick Start Guide found here: https://www.signnow.com/whitepapers/SignNow-for-Salesforce-Quick-Start-Guide.pdf This mini guide is a replacement for step 6 from the Quick Start Guide.

This guide is written under the assumption that you have working knowledge of Salesforce and the signNow integration components.

Step 1 – Creating a New Permission Set

Click “Setup” in the upper right hand corner.

screenshot

Navigate to: Manage Users > Permission Sets.

Then click “New” to create a new permission set.

screenshot

Give the permission set a label, API name, and description. Leave “User License” as “None”.

Click Save.

screenshot

Step 2 – Assining Connected Apps

Open your new permission set and click “Assigned Connected Apps”.

screenshot

Click “Edit”.

screenshot

Step 3 – Enabling The signNow Apps

Select the signNow apps and move them to the right column. The four apps you must move are: signnow-docstatus, snfilltemplate, snstatus, and sntemplates.

screenshot

Step 4 – Assign The New Permission Set To Your Users

Navigate to: Manage Users > Users.

Click on the User’s name to open up the user details. You must assign the permission set to each user who will be using the signNow integration.

screenshot

Scroll down to the section labeled “Permission Set Assignments” and click “Edit Assignments”.

screenshot

Select the signNow permission set and move it to the right.

Save your work.

screenshot

Congratulations, you now have a permission set for the signNow for Salesforce integration.

Refer to the Quick Start Guide here: https://signnow.com/whitepapers/SignNow-for-Salesforce-Quick-Start-Guide.pdf to complete your SignNow for Salesforce setup.