Difference between revisions of "SignEasy"

From SmartWiki
Jump to: navigation, search
 
(3 intermediate revisions by 2 users not shown)
Line 7: Line 7:
 
* Key Type: SignEasy
 
* Key Type: SignEasy
 
* Key name: set to SignEasy
 
* Key name: set to SignEasy
* API Key**:
+
* Client ID: unique code for the client (for SignEasy V3 accounts, this can be found in your SignEasy Account - Apps (click on the app you created for SmartSimple integration) - Authentication tab - OAuth credentials)
* Client ID**: unique code for the client (see below for a description of where these are found)
+
* Client Secret (for SignEasy V3 accounts, this can be found in your SignEasy Account - Apps (click on the app you created for SmartSimple integration) - Authentication tab - OAuth credentials)<br /><br />In your V3 SignEasy Account:<br />- Enter the Redirect URL (listed on Integration Key Management - SignEasy (Type) - Redirect URL) into your SignEasy Account by going to Apps > Edit Settings > Redirect URL<br />- Check all the scopes by going to Apps > Edit Settings > Scopes<br />- Enter the Webhook URL (listed on Integration Key Management - SignEasy (Type) - Webhook URL) into your SignEasy Account by going to Apps > Webhooks > Create Webhook
  
 
3. Back in SmartSimple, Click '''Save''' once both values have been entered.<br />
 
3. Back in SmartSimple, Click '''Save''' once both values have been entered.<br />
4. On the Integrations tab, look for the '''Online Signature Provider''' section, and select '''SignEasy'''. You will then need to click the button labeled "Activate SignEasy Access". Once you've saved, the text next to the button should read: '''SignEasy Access: Enabled'''.<br />
+
4. On the Integrations tab, look for the '''Online Signature Provider''' section, and select '''SignEasy'''. You will then need to click the button labeled "Check SignEasy Access". Authorize SmarrtSimple to access using your SignEasy account.<br />
 
5. Configure your Web Page View field and use the tags outlined below to incorporate '''SignEasy''' functions with your SmartSimple data. Make sure these two field options are enabled:
 
5. Configure your Web Page View field and use the tags outlined below to incorporate '''SignEasy''' functions with your SmartSimple data. Make sure these two field options are enabled:
  
Line 20: Line 20:
 
6. Make sure you've created a role for your Signees, and that the intended person is added as a Contact using this role. Your Web Page View field will need to contain list syntax that specifies the roleid; this is how SmartSimple knows to whom the e-signature request should be sent.
 
6. Make sure you've created a role for your Signees, and that the intended person is added as a Contact using this role. Your Web Page View field will need to contain list syntax that specifies the roleid; this is how SmartSimple knows to whom the e-signature request should be sent.
  
* for API Key and Client ID, follow [https://docs.signeasy.com/docs/generating-api-keys-for-production these instructions].
+
* for API Key and Client ID, follow [https://docs.signeasy.com/v2.0/docs/generating-api-keys-for-production these instructions].
  
 
Tip: Within the Web Page View window, you can click the Online Signature button to view the status of the current request once it's been sent.
 
Tip: Within the Web Page View window, you can click the Online Signature button to view the status of the current request once it's been sent.

Latest revision as of 15:58, 12 December 2023


Construction warning.png Please note that this page is currently under construction. There is more information to come.

Configuring Global Settings

1. Go to Global Settings - Integrations - Integration Key Management.
2. Click on New Integration Key. You will be presented with the following fields:

  • Key Type: SignEasy
  • Key name: set to SignEasy
  • Client ID: unique code for the client (for SignEasy V3 accounts, this can be found in your SignEasy Account - Apps (click on the app you created for SmartSimple integration) - Authentication tab - OAuth credentials)
  • Client Secret (for SignEasy V3 accounts, this can be found in your SignEasy Account - Apps (click on the app you created for SmartSimple integration) - Authentication tab - OAuth credentials)

    In your V3 SignEasy Account:
    - Enter the Redirect URL (listed on Integration Key Management - SignEasy (Type) - Redirect URL) into your SignEasy Account by going to Apps > Edit Settings > Redirect URL
    - Check all the scopes by going to Apps > Edit Settings > Scopes
    - Enter the Webhook URL (listed on Integration Key Management - SignEasy (Type) - Webhook URL) into your SignEasy Account by going to Apps > Webhooks > Create Webhook

3. Back in SmartSimple, Click Save once both values have been entered.
4. On the Integrations tab, look for the Online Signature Provider section, and select SignEasy. You will then need to click the button labeled "Check SignEasy Access". Authorize SmarrtSimple to access using your SignEasy account.
5. Configure your Web Page View field and use the tags outlined below to incorporate SignEasy functions with your SmartSimple data. Make sure these two field options are enabled:

  • Online Signature: This will enable a new button in the Web Page View called "Online Signature".
  • Enable Save to Server: This will allow a copy of the signed PDF document to be saved within SmartSimple.
  • You can also create an Upload field if desired, in which to store the signed PDF file. Use the Store-To Value option in the Web Page View field to point to this additional field.

6. Make sure you've created a role for your Signees, and that the intended person is added as a Contact using this role. Your Web Page View field will need to contain list syntax that specifies the roleid; this is how SmartSimple knows to whom the e-signature request should be sent.

Tip: Within the Web Page View window, you can click the Online Signature button to view the status of the current request once it's been sent.

SignEasy Tags

Function Tag Format Example Notes
Populate the email body
<!--SignatureEmailBody Place body text here.-->
<!--SignatureEmailBody This is a test.-->
Configure the CC email list
<!--SignatureCC email;Name,email2;Name2-->
<!--SignatureCC abc@fake.com;ABC Smith,qa1@fake.com;QA1-->
Emails will be copied to the list of people included here.
Configure the email flow for multiple signees
<!--SignatureFlow Indicator-->
<!--SignatureFlow P-->
If you specify the signature flow as P (Parallel), emails will be sent to all signees at the same time.

If you specify the signature flow as S (Sequential), emails will be sent sequentially; for example: email will only be sent to the second signee after the first signee has completed signing the document, and so on. (if left out, behaviour will default to Parallel)

Note

For SignEasy to retrieve signee emails, names etc, you will have to embed them in your HTML. They will then be used in the email sent to signees. For example:

  [#(?object=contact;criteria=roleid='12527';orderby=firstname) <!--SignatureFlow P--><!--signature ~email~;SIGNER;~firstname~;~lastname~;~Index~;~companyname~-->#]

If you have 3 signees assigned to the Level 1, the HTML in your Web Page View will be embedded with the info for all three:

<!--signature ttest@smartsimple.com;SIGNER;Tony;Test;1;SmartSimple Software -->
<!--signature fake@smartsimple.com;SIGNER;Fake;Man;2;Fake Co. -->
<!--signature fake2@smartsimple.com;SIGNER;Fake2;Mann;3;Fake2 Co. -->