Integrating Kademi with DocuSign

Blank 23/11/2022 12:54 - 23/11/2022 12:54

DocuSign is the world's most popular platform to electronically sign off on documents and agreements from anywhere in the world. 

In this blog post, we will go over how to integrate your DocuSign account with Kademi.

Installation

The very first step is to install the DocuSign application into a website.

On the left navigation menu, click on Website Manager and then click on the  icon next to the website that you want to install DocuSign to.

undefined

Click on 'Find more apps' to enter the market place.

undefined

From the Market Place, search for 'DocuSign' and then click on the application.

undefined

Then click on 'Install in {website name}' and wait for it to finish installing. 

undefined

Integrating DocuSign with Kademi

The next steps are to link your DocuSign account with Kademi. If this is your first time using the DocuSign app you will need to sign up for a DocuSign developer account before you can proceed.

After you've installed the application, navigate to 'Talk & Connect' then to 'DocuSign'.

You will see this screen. Click on 'Link with DocuSign' to start the setup wizard.

undefined

Again, make sure that you have a DocuSign account ready to go before proceeding and clicking on 'Get Started'.

undefined

In the next step, click whether you are using a sandbox or production environment type for your Docusign account then click on next step.

DocuSign Account Details

From here, you'll want to create a Connect Key in your DocuSign account. If you already have one, then you can skip these next steps. First, you'll want to head over to the 'Admin' page for your account.

In your DocuSign settings on the left pane, scroll down to the INTEGRATION section and then to Connect.

undefined
From here, you'll want to click on CONNECT KEYS. To generate your key, click on ADD SECRET KEY. 

undefined

 

Once you have generated your key, make sure that you copy and store it somewhere safe immediately as the full key will only be fully shown and copyable the first time it is generated.

Linking your DocuSign account with Kademi

Now, that you have your connect key, return to the docusign set up wizard in Kademi. Select the website you want to use Docusign with and paste your Connect Key into the field pictured below.

Click 'Link with DocuSign'. 

undefined

Click 'Allow Access' to link your Kademi account with DocuSign.

 

 

undefined

The final step is to select the account you will use with DocuSign, then click on 'Confirm Account'.

 

undefined

Setting up a Journey to use DocuSign 

Now that you've linked your Kademi account with DocuSign, we are now going to setup a journey to test its functionality. If you need a refresher on how journeys work, then take a minute to look over these tutorials as well as this tutorial on onboarding journeys.

For this section, we'll be using templates from DocuSign. You can use this tutorial from DocuSign to create your templates

 

We'll be creating an onboarding journey that will capture any user registrations as well as any accepted invitations to the program. It will then send off a document for the user to sign. 

First, we'll set up the beginning of the onboarding journey as detailed in the tutorials.  

undefined

Next, in the 'Nodes List' to the right, look up the DocuSign nodes. You'll want the 'Send a DocuSign Envelope' and 'DocuSign eSignature Event' nodes.

undefined

Next, connect the nodes like so. Click the  for the 'Send a DocuSign Envelope'  to access its settings.

First, under the 'Template' setting, select the template from DocuSign that you wish to use. 

undefined

After you have selected your template, the recipient settings will populate depending on how you configured the recipients on DocuSign. In the example below, there are two recipients that need to sign.

undefined

First, is the owner of the document. In the journey, fill out their email address in the field under the Owner role. 

The second is the main recipient/lead profile for the journey (the person who has registered or been invited to the program). We will be using a KCode to grab the lead profile's email address. You can simply copy and paste the KCode below without any spaces.

* |currentLead/leadCustomerProfile/email| *

Your settings should then look something like this. 


 

Make sure that all recipient's email addresses are filled out and hava a valid matching profile within your Kademi accountNote that super user profiles will be invalid. 

For the 'DocuSign eSignature Event', it isn't strictly necessary to configure any settings for it. You can however, create processes for when the user signs or declines signing the document. To keep things simple, we won't cover that here. Important - a valid CSRF Token is required for webhooks to work. More info can be found here.

undefined

To test out the journey, we can have a test user go through the registration process or send an invitation email to them. 

Make sure that the website that you're using has 'Force HTTPS' enabled.

Once you have done that, the user should recieve an email from DocuSign.undefined

 

By clicking 'Review Document', they will be taken to DocuSign website, where they will be able to sign the document.

undefined

IDPs

  • Kademi created a new IDP Expression called DynamicPathIDPExpression - dynamicPath - This will allow apps to provide URL prefixes to exclude
  • Clients with existing IDP configs on their websites will need to manually update the file to have this: