DocuSign Connect

You can have DocuSign make updates to Salesforce after the completion of an envelope using DocuSign Connect. These updates include attaching the signed contract back to a Salesforce record, updating fields in Salesforce and creating records inside of Salesforce.

In the example provided to you on this page, we will set up DocuSign to update the Account Billing Information, attach the signed DocuSign contract to the Opportunity record, and update the Opportunity Stage field to Closed.

Note: You must integrate DocuSign with the app and add a DocuSign delivery option. For more information see DocuSign Delivery Option.

Configure DocuSign Connect for standard objects

Configure your DocuSign connect settings to ensure your Salesforce org is connected to DocuSign.

  1. On the Connect for Salesforce configuration page, scroll down to the Connect Objects section.

  2. Click New Object, then select Salesforce Object.

    • You are now adding an object to update within your Connect settings. You must configure the Object page properly to successfully update a Standard Salesforce object.

  3. Under General Settings, select Active Object.

Field Description
Object Label Enter a label for the object you intend to update. This is primarily for management purposes. This label will be visible to the DocuSign Admin within the Connect Page.
Select Salesforce Object Objectt: This drop-down provides you with a list of all your Salesforce objects. You must select the object you wish to update here.
  • Add if no match: Check this box if you wish to insert a new Salesforce record if the record Id referenced in the Select Where: section cannot be found.
    		•
    Select Where
    • Salesforce fieldt: Select what will be used to identify a specific record to update. It is best practice to select the object's (Id) field.
    • DocuSign field: Fill the Salesforce field with a value from DocuSign. The DocGen Package automatically sends standard object Ids to DocuSign, so you can select Envelope External Object in the drop-down, where Object is the Salesforce object you select in the Select Salesforce Object list.
    Update Fields
    •  Salesforce field: Provides a list of all fields available in the object selected in the Select Salesforce Object field. Select the field(s) you want to update here.

    Note: Note: You can update one or several fields per object.

    •  DocuSign field: If you want to update the Salesforce fields with dynamic values such as Sign Fields (Example: Date Signed) or Recipient Secure Fields, you can specify them here.
    •  Value: If you do not want to update the Salesforce fields with dynamic values, then you can update them with static values by entering the values here.

    Attachments

    • Attach DocuSign Documents - Selecting this box will attach the signed contract to the Notes and Attachments object on the record specified.

    • Completed Envelope Only - Selecting this box will attach the completed DocuSign contract Only. If this box is not selected, DocuSign will attach the contract to the specified record every time DocuSign Connect is run, which can occur several times within one signing.

    In the example above, we have set up DocuSign Connect to update the Opportunity Stage field to Closed and automatically attach the signed contract to the Opportunity record.

    Update Salesforce with Recipient Secure Fields

    In addition to updating Salesforce with static values, DocuSign can update Salesforce with values entered into Secure Fields by the envelope recipients.

    You must choose which Salesforce field to update and then select Recipient Secure Field in the DocuSign Field column. Finally, you must select which specific secure field is being assigned to each Salesforce field by entering the Secure Field's group names, in the column of fields to the right of Recipient Secure Fields.

    You can easily access the Secure Field Group Names by navigating to a list view of all Secure Fields tied to a Recipient.

    Configure DocuSign Connect for custom objects

    Let's say you have custom objects created in Salesforce, and want data to write-back to certain fields for that custom object. These instructions provide guidance on configuring DocuSign Connect for a custom object.

    1. Get the object Id.

      1. Select the record ID field of your main object from the field tagger. The main object must contain the fields you wish to update.

    2. Add record Id to custom envelope field.

    3. Navigate to DocGen Packages tab -> DocGen Package Record -> -> Delivery option (DocuSign) -> custom envelope field]. Locate the name of new DocuSign field.

    4. Assign a custom field to your DocGen Package DocuSign Delivery.

    5. Use the following syntax.

      1. CustomField,<<Object_Id>>

      2. Where:

        1. CustomField is an arbitrary name you assign it

        2. <<Object_Id>> is the record id you retrieve from the field tagger.

    6. Navigate to: [objects page -> DocuSign Admin -> DocuSign console ->preferences -> envelope custom field -> Add]

    7. Add “DocuSign field” to Envelope Custom Fields.

    8. Assign your arbitrary custom field name to your new DocuSign envelope field.

    9. Add object to Connect settings.

      1. Navigate to: [DocuSign Admin --> DocuSign Console --> Preferences --> Connect --> Add Object]

    10. In the Object Name field, name the object.

    11. In the Select Custom Salesforce Object field, select the custom object.

    12. In the Salesforce field, Select Where field enter the Record ID for the Salesforce field and custom DocuSign field.

    13. In the DocuSign Field, select the custom field in the DocuSign field picklist.

    14. In the Update Fields field, add the field and group names.

    15. Add fields and group names for pass back Salesforce fields.