<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><p><strong>In this guide we will cover:</strong></p><p id="isPasted"><strong>- What is the Adobe Acrobat Sign Integration?</strong></p><p><strong>- Connecting Halo to Adobe Acrobat Sign</strong></p><p><strong>- Sending Quotes Back into Halo</strong></p><p><strong>- Signing a Quote in Adobe Acrobat Sign</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Adobe Acrobat Sign Integration?</span></strong></p><p>The Adobe Acrobat Sign Integration can be used for signing quotations created in Halo and then transferring them back into Halo. The E-signature can be drawn or a signature can be generated from a text input from within the Adobe link sent to the user. Once the quote is sent back to Halo, the status will be updated to Accepted (the status that has been set on the integration page). As at this point, the user has signed off on the document via their inbox.</p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting Halo to Adobe Acrobat Sign</span></strong></p><p>Enable the Integration by clicking the "+" sign on the module (you will find the below in Configuration > Integrations > *Search for Adobe*):<br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUxNTM2YmY4LTcxYjItNDJkMy05ZDc4LTYzNTgwNzNhZjk3MCJ9.WDsQt4KVEufC-xdFkkFYSrpsK6EVE9_6gSo5OqJSy20" class="fr-fic fr-fil fr-dib" width="568" height="258"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the module.</span></strong></p><p><br></p><p>The settings dropdown should be populated with a default tenant, tenants can be created via the "new" button located on the top right of the screen.</p><p><br></p><p>To connect your tenant you will need to create an API application within Adobe sign, to authorise the connection with Halo. </p><p><br></p><p>Head to your Adobe sign instance > API > API applications > New application. Here, gve the application a sensible name and choose the domain if using the partner domain user that later authenticates the connection must be able to create agreements in Adobe. If using your own connection, the agreement_write scope must also be present in the OAuth application configuration. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ3M2EwNTYzLTAxNzUtNDk4Yy04ZTQyLTVmOThkMTA1ZTE0MSJ9.IptHdAaKh5hyEC9xsdzd6H_kjdyGemUREvgFuFTfaO0" class="fr-fic fr-fil fr-dib" width="543" style="width: 545px; height: 463.736px;" height="464"></p><p><strong><span style="font-size: 10pt;">Fig 2. Create new API application in Adobe.</span></strong></p><p><br></p><p>Once you have created the application you will need to add in the required redirect URI. Do this by selecting the application in Adobe > Configure OAuth. The redirect URI used will differ depending on the version and Halo product you are using. </p><p><br></p><p id="isPasted">On versions prior to v2.200 one of the following redirect URI will need to be used (in line with the Halo product you are using):</p><ul><li><a data-fr-linked="true" href="https://auth.halopsa.com/externalauth" id="isPasted">https://auth.halopsa.com/externalauth</a></li><li><a data-fr-linked="true" href="https://auth.halopsa.com/externalauth" id="isPasted">https://auth.haloitsm.com/externalauth</a></li><li><a data-fr-linked="true" href="https://auth.halopsa.com/externalauth" id="isPasted">https://auth.halocrm.io/externalauth</a></li></ul><p><br></p><p>On versions v2.200+ you the following redirect URI will need to be used:</p><ul><li><a data-fr-linked="true" href="https://YOURHALODOMAIN/authcallback">https://YOURHALODOMAIN/authcallback</a></li></ul><p>But the exact redirect URI you need can be found on the setup page for the integration in Halo.</p><p><br></p><p id="isPasted"><strong><em>Note: If you have disconnected to the integration and are reconnecting, if your Halo instance is on v2.200+ you will need to use the new redirect URI (<a data-fr-linked="true" href="https://YOURHALODOMAIN/authcallback">https://YOURHALODOMAIN/authcallback</a>).</em></strong></p><p><br></p><p>Once you have added the redirect URI save the application. Copy the application ID and secret and paste these into the relevant fields in Halo. </p><p><br></p><p>You will also need to enter the correct region code for in Halo (in the Login Shard field) . Once you have saved the connection details, use the connect button after naming and saving the tenant, you will be redirected to a login screen for Adobe Acrobat Sign.</p><p><br></p><p><strong><span style="font-size: 14pt;">Send Quotes to Adobe</span></strong></p><p>Create the webhook on the webhook tab, it is as simple as generating a new secret and then creating a webhook.</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkyMTI5NDdmLWE4ZjktNGU1Yy1hZTU1LWVkNzkzNzExZGVmZSJ9.MlKYcaF0D41NlVGXRreA0lbVisQHBSKIIjPM-Q5LGoM" class="fr-fic fr-fil fr-dib" width="1579" height="649"><strong><span style="font-size: 10pt;">Fig 3. Enabling webhooks.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Sending Quotes Back into Halo</span></strong></p><p>Within the API section of Adobe Acrobat Sign, you can create a webhook which will send the quotes back into Halo (without the signature).</p><p><br><strong>Create the webhook with the following settings:</strong></p><p><br></p><ul><li><strong>Scope: </strong>Account</li><li><strong>URL:</strong> The URL will be that of the webhook generated from the integrations page in Halo<strong><br></strong></li><li><strong>Events:</strong> Agreement Participant Completed</li><li><strong>Notification Parameters: </strong>Agreement Info, Agreement Participant Info, Agreement Signed Document.</li></ul><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk2MDg4MzU3LTczNTAtNGUwNC05ZDgwLTUxYWI2NTNmZmU5MyJ9.UK7ShSacLr07Sr9VmW6Cc8PmtwGBcBi6LtVbWEwpB2s" width="582" height="441" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 4. Configuration of the webhook.</span></strong></p><p><br></p><p>The status update on the quote may take a few minutes to pull through. After the quote has been signed for via the end-users inbox (The email it sends to will be the email associated with the user of the quote), the status of the quote will be updated to the "Status if Accepted" single select option, which is in the settings dropdown of the Adobe integration page in Halo.</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRiODNjZTBkLTgzOTgtNGMwNS1iMTE2LTg2YWFkMmE2OTcxZCJ9.wgqZpMfBDE2ZbW-5jm2Su4pCcy-l__iwDXHUVl2kwuQ" width="1017" height="528" class="fr-fic fr-dii"><br><strong><span style="font-size: 10pt;">Fig 5. Settings.</span></strong></p><p><br>You will need to add in the above tags onto your PDF template, for the signature, company, and email fields to pull through to Adobe Acrobat Sign. By default the signature field and the email field will be available on the quote screen in Adobe. These tags are not synced to the Halo side, the formatting of tags are for the quotation page of Adobe. So editing the PDF Template for your quote, means you can decide the position of the tags on the adobe quotation.<br><br></p><p><strong><span style="font-size: 12pt;">Tags</span></strong></p><ul style="font-size: initial;"><li style="font-size: 11pt;"><p>{{Sig_es_:signer1:signature}}</p></li><li style="font-size: 11pt;"><p>{{Cmpy_es_:signer1:company}}</p></li><li style="font-size: 11pt;"><p>{{Em_es_:signer1:email}}<br><br></p></li></ul><p><strong><span style="font-size: 14pt;">Signing a Quote in Adobe Acrobat Sign</span></strong><span style="font-size: 14pt;"><br></span><span style="font-size: 11pt;">Go to a quote and attach the adobe tenant to the quote via the right hand side details pane, and then use the sync to third party button.</span></p><p><br><img data-custom="AAMkADk5ZWIxM2Y4LWY4ZTgtNDY4Zi04YjMxLWVmNGNmMDk5NDExMwBGAAAAAABxm548liSBRIX%2BC0wr8NNfBwDskgdib8uxQLAhxcfPtAgTAAAAAAEJAADskgdib8uxQLAhxcfPtAgTAAC0kpDJAAABEgAQAGUy6I%2FPyvFGmM%2Bb6RGouYs%3D" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE0MDYyMmMzLWQwMWEtNDA3Mi1hZDQ5LTA4MTg0NTNkMGIzZCJ9.J2WKC0hDZed3Z9lEA3whEX12-kBKCLwkgdYXSFfsRVM" size="113217" style="border: 0px; font: inherit; padding: 0px; color: inherit; animation: 0.1s ease-out 0s 1 normal none running Do8Zj; max-width: 100%; min-width: auto; min-height: auto; cursor: pointer; height: auto;" class="fr-fic fr-dii" height="auto" width="1759"></p><p><strong><span style="font-size: 10pt;">Fig 6. Adobe button on a quotation.</span></strong></p><p><br></p><p>Sync to the third party (make sure the user on the quote has a valid email address), then it will show on the Adobe side.</p><p><br></p><p><img data-custom="AAMkADk5ZWIxM2Y4LWY4ZTgtNDY4Zi04YjMxLWVmNGNmMDk5NDExMwBGAAAAAABxm548liSBRIX%2BC0wr8NNfBwDskgdib8uxQLAhxcfPtAgTAAAAAAEJAADskgdib8uxQLAhxcfPtAgTAAC0kpDJAAABEgAQAI8oeEnQcvFArTHCKb87vCU%3D" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI5ZWFmZmU5LWZiN2ItNGRmMi1hMzBhLWE5M2UzZTMzMmYwNCJ9.GGbB7tWNihXcxGhubtaPqmHuI4uE-ol9EJ1Lg00awmI" size="35402" style="border: 0px; font: inherit; padding: 0px; color: inherit; animation: 0.1s ease-out 0s 1 normal none running Do8Zj; max-width: 100%; min-width: auto; min-height: auto; cursor: pointer; height: auto;" class="fr-fic fr-dii" height="auto" width="2049"></p><p><strong><span style="font-size: 10pt;">Fig 7. Adobe showing In Progress.</span></strong></p><p><br></p><p><img data-custom="AAMkADk5ZWIxM2Y4LWY4ZTgtNDY4Zi04YjMxLWVmNGNmMDk5NDExMwBGAAAAAABxm548liSBRIX%2BC0wr8NNfBwDskgdib8uxQLAhxcfPtAgTAAAAAAEJAADskgdib8uxQLAhxcfPtAgTAAC0kpDJAAABEgAQAPX2nwMll%2FlGuxtfVw5wFXw%3D" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM4MTEyNjc1LTIyZDAtNDk4ZS1hYjdhLWI0ZDcwOWE1YTg2ZiJ9.CGApyqPcnGO0ZKlUTA_EtXAkfVG1trq4NTacvNvksyo" size="22977" style="border: 0px; font: inherit; padding: 0px; color: inherit; animation: 0.1s ease-out 0s 1 normal none running Do8Zj; max-width: 100%; min-width: auto; min-height: auto; cursor: pointer; height: auto;" class="fr-fic fr-dii" height="auto" width="1900"></p><p><strong><span style="font-size: 10pt;">Fig 8. In Progress list.</span></strong></p><p><br></p><p>From here you can view the quote.<br><br></p><p>An email will be sent to the recipient shown above, the recipient being the end-user of the Quote. This document can be signed from the users inbox and then it will be sent back into Halo via the webhook created on Adobe Acrobat Sign, and update the status of the quote to "Accepted" status which has been set on the integration page.</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAxNTJlY2NiLTc2YTAtNGUzZS05ZmI3LTgzMDY4YWVjZjZmMiJ9.8GR7UWoSIOr773tHt-pRBskdkmi5x7WnEo4VTTaMiBQ" class="fr-fic fr-fil fr-dib" width="249" height="100"></p><p><strong><span style="font-size: 10pt;">Fig 9. Status is Accepted.</span></strong></p>
