<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 id="isPasted"><strong>In this guide we will cover:</strong></p><p><strong>- What is the PandaDocs Integration?</strong></p><p><strong>- Connecting to PandaDocs</strong></p><p><strong>- Setup for creating Documents using a chosen template </strong></p><p><strong>- Setup for Creating Documents from an Uploaded file</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the PandaDocs Integration?</span></strong></p><p>The PandaDocs integration allows you to create documents in PandaDocs from your Halo instance. The document created in PandaDocs can contain data from Halo, including but not limited to tickets, invoices, quotes, agreements and purchase orders, streamlining the document creation procedure. There are two methods that can be used to create documents in PandaDocs, using a template or uploading a file. </p><p><br></p><p><strong>Template method</strong>- Allows you to have a document created using a chosen template in PandaDocs. Data from Halo will be used to create a document in PandaDocs in the format of the chosen template. The document that is created is much more customisable but setup for this is more complex as each field within the template will need to have a value or variable assigned. This method should be used when you would like to create documents containing data from Halo but formatted with existing templates you have in PandaDocs. </p><p><br></p><p><strong>File upload method</strong> - Allows you to have a document created in PandaDocs based on an attachment uploaded to the ticket. The document that is attached/uploaded will have a copy created in Pandadocs, using the same format and data. You could use this method to send quote PDFs created in Halo to PandaDocs. This has a much more straightforward setup. This method should be used when documents are created/formatted using templates within Halo, but you would like these to exist in PandaDocs too. </p><p><br></p><p>This integration is runbook based, each creation method uses it's own runbook. This means to set up the integration you will need to edit the runbook controlling how data is synced for your chosen method. We will run through how to do this in this guide.</p><p><br></p><p><strong><em>Note: We do not currently integrate with PandaDocs quote signing ability. </em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to PandaDocs</span></strong></p><p>First you will need to enable the integration module, head to Configuration > Integrations, enable the 'PandaDocs' integration module using the '+' icon. Enabling the module will automatically download the runbooks required for this integration. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdmYjU2ZmYyLWNkNjEtNDJhZC1iM2NjLTAzMDYzODVhYzE1NCJ9.FclHYXsywErJMmorQAFrzKSBUgbGTihMbZAMh51LKF8" class="fr-fic fr-fil fr-dib" width="178" style="width: 180px; height: 140.769px;" height="141"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enable integration module</span></strong></p><p><br></p><p>Once enabled click into the integration module to begin configuration. Here, you will see you need to enter an API key, this is used to authenticate your connection to PandaDocs. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJkYmNkMGFiLTQ2YTktNGM2Ny04NzgxLWQwOWEyMmVkN2NjMiJ9.L-r3B3Rodgqn3Rovn1qk4uZ7fTfvjD7If5R7zlMfejs" class="fr-fic fr-fil fr-dib" width="951" height="378"></p><p><strong><span style="font-size: 10pt;">Fig 2. Integration setup page</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Obtain API Key from PandaDocs</span></strong></p><p>The API key will need to be obtained from your PandaDocs instance. When logged into PandaDocs head to Settings > Integrations > Integrations > API, from here you can generate an API key, ensure you copy the key once generated. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2MGZiYjA3LTJlZTMtNDk3NC05YTY2LTBlZGE3ZjNkNDIzOSJ9.N5Tdt_IGwAPPPYUawV6G9W148qAJC2IqnufZJyHfj0M" class="fr-fic fr-fil fr-dib" width="1155" style="width: 1157px; height: 643.057px;" height="643"></p><p><strong><span style="font-size: 10pt;">Fig 3. Integrations area in PandaDocs</span></strong></p><p><br></p><p>Paste the API key field into Halo. </p><p><br></p><p><strong><span style="font-size: 14pt;">Configure Document creation</span></strong></p><p>Upon enabling the PandaDocs module two runbooks will be added to your instance. One creates documents in PandaDocs using the template creation method, the other creates documents in PandaDocs using the file upload method. </p><p><br></p><p>The runbook you need to edit will depend on the creation method you are planning on using, if you would like both options, you will need to configure/edit both runbooks. Follow the respective sections of this guide for setup instructions. </p><p><br></p><p><strong><span style="font-size: 14pt;">Setup for Creating Documents using a Chosen Template </span></strong></p><p>When creating documents in PandaDocs using a chosen template you will need to configure the runbook to contain the following:</p><ul><li>ID of the template in PandaDocs the document will be created with</li><li>Recipient of the document</li><li>Any additional data you would like to be included in the document</li></ul><p><strong><em><span style="color: rgb(0, 0, 0);">Note: Variables will be used to have data from the ticket/opportunity populate variables/fields in the PandaDocs template. </span></em></strong></p><p><br></p><p>First, open up the runbook used for this creation method, this can be opened using the button 'Create from template runbook' on the integration configuration page. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE1MGY3ZTcxLTAwZWItNDBhZi04MGVhLWI0MGQzODVjNDhjOSJ9.Mgg4jRJ2dqPtom5unZy9EJa7KWdyTKJqIwp6S7UHw28" class="fr-fic fr-fil fr-dib" width="855" style="width: 857px; height: 293.111px;" height="293"></p><p><strong><span style="font-size: 10pt;">Fig 4. Link to 'Create from Template' Runbook</span></strong></p><p><br></p><p>When opened you will be taken to the 'Details' tab of the runbook. Click into the 'Flow chart' tab. Edit the page and edit the first step. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI0MTAyZDMzLWUwNjUtNDZmOC1iZjg5LWI1NGZiYTJlZjIwMCJ9.cx5ZaBsqEeU1y1obGWb0QhYZ-R6XdcM3NX8qoFzqr5A" class="fr-fic fr-fil fr-dib" width="1058" style="width: 1060px; height: 523.636px;" height="524"></p><p><strong><span style="font-size: 10pt;">Fig 5. Edit runbook step </span></strong></p><p><br></p><p>Within the step you will see the method 'PandaDoc: Create from Template' is set, use the button 'Edit Method' then head to the 'Body' tab.</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVjN2NhOTYxLTRlNjYtNDRiNS1hZjU1LTM4MGFjNWVmMWY1NiJ9.LMq5M3pk7hEoCcVJt5oCgiGsW_2b7agyrdzrlJm45bQ" class="fr-fic fr-fil fr-dib" width="1036" style="width: 1038px; height: 597.095px;" height="597"></p><p><strong><span style="font-size: 10pt;">Fig 6. Edit method of step</span></strong></p><p><br></p><p>The method body contains the request that is being sent to the PandaDocs application. You will need to edit the body here to control/customise what data is sent to PandaDocs when a document is created. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFlNDgxNTc4LTUxMjctNGRhNi05YzU1LTQ3OTc1NDNmYTllMCJ9.iR6fB_8hI35ssjJ_Q3V1xpiWO-GzxM6VM3zGr6L-Z4s" class="fr-fic fr-fil fr-dib" width="1222" style="width: 1224px; height: 529.889px;" height="530"></p><p><strong><span style="font-size: 10pt;">Fig 7. Method body, request being posted to PandaDocs</span></strong></p><p><br></p><p><span style="font-size: 11pt;">The method set here out-of-the-box will set some PandaDocs fields on a template. However, depending on the template you are using/having created, you will need to add to the method to ensure additional fields are populated. For example, if you are creating a purchase order template you will need to include the PO fields on the PandaDocs template. <br></span></p><p><br></p><p>We will break down each section of the method here to edit. </p><p><br></p><p><strong>Specify which template to use</strong></p><p><span style="color: #a31515;">"template_uuid"</span><span style="color: #000000;">: </span><span style="color: #0451a5;">"UUID of the Template"</span> - Here, you will need to replace the blue text in quotations with the UUID of the template in PandaDocs you would like to be used to create a document. This will be the template used to format the information sent to PandaDocs.</p><p><br></p><p>To obtain the UUID of the template, open up the template in PandaDocs, when open you will see the template ID in the URL. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVkYjVmMmFiLTEzNjQtNGNkZS05MGZlLTU1YTZkMmU0ZDQ2ZCJ9.-gjTLdOP518psC64B5xWs5fZ8sn4C0d1D41Z_ZdrciA" class="fr-fic fr-fil fr-dib" width="1066" style="width: 1068px; height: 555.187px;" height="555"></p><p><strong><span style="font-size: 10pt;">Fig 8. Template UUID</span></strong></p><p><br></p><p><strong>Specify Which folder to create the template in</strong></p><div id="isPasted"><span style="color: rgb(163, 21, 21); font-size: 11pt;">folder_uuid"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">: </span><span style="color: rgb(4, 81, 165); font-size: 11pt;">"UUID of a Folder"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">- </span><span style="font-size: 11pt;">Here, you will need to replace the blue text in quotations with the UUID of the folder in PandaDocs you would like the document to be created in.</span></div><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">To obtain the folder UUID you will need to open up the folder in PandaDocs, then you will be able to see the UUID of the folder in the URL. </span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk1Nzk1ZjU1LTNmOGQtNDMyNy04N2M2LTYyM2M5NjlhMTFjNiJ9.rTZb27ku_XeuF4uWTaU_AjYfA1D2kjASPoMKtW4aaBk" class="fr-fic fr-fil fr-dib" width="1043" style="width: 1045px; height: 545.357px;" height="545"></p><p><strong><span style="font-size: 10pt;">Fig 9. Folder UUID</span></strong></p><p><br></p><p><strong><em>Note: Ensure the folder you are using is a document folder not a template folder.</em></strong></p><p><br></p><p><strong>Specify owner of the document</strong></p><div id="isPasted"><span style="color: rgb(0, 0, 0); font-size: 11pt;"> </span><span style="color: rgb(163, 21, 21); font-size: 11pt;">"owner"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">: { </span><span style="color: rgb(163, 21, 21); font-size: 11pt;">"email"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">: </span><span style="color: rgb(4, 81, 165); font-size: 11pt;">"admin@halodemo.com" </span><span style="font-size: 11pt;"> - Here, you will need to replace the blue text in quotations with the email address of the person you would like the be deemed the owner of the document that is created in PandaDocs. A valid email address will need to be entered here. </span></div><p><br></p><p><span style="font-size: 11pt;"><strong>Specify Document Tags</strong></span></p><div id="isPasted"><span style="color: rgb(0, 0, 0); font-size: 11pt;"> </span><span style="color: rgb(163, 21, 21); font-size: 11pt;">"tags"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">: [</span><span style="color: rgb(4, 81, 165); font-size: 11pt;">"Example Document Tag"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">] - </span><span style="font-size: 11pt;">Here, you can specify what tags the document is created with in PandaDocs. Replace the blue text in quotations with the tag that you would like to be applied. Multiple tags can be applied using a comma separated list, e.g. "tags": ["Invoice", "Important"].</span></div><p><br></p><p><span style="font-size: 11pt;"><strong>Specify other values </strong></span></p><p>Any other fields in the method can have variables set against them as the value, this allows data from the ticket to be used when creating the document in PandaDocs. For example, you may want to set the recipient details of the document to be the ticket's end user's details.</p><p><br></p><p>A list of available variables can be found on the right-hand-side of the page when viewing the step body. Use the dropdown menu to change the entities you are viewing variables for. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjcxMjg3N2ZhLTZiZGUtNDYwYS1iMzBhLTc0OTIxNDM4MTYwZCJ9.M2p9e1i-2ikD8xyz2VLBMAqEfkTsvwBNFQXjQbYWVQk" class="fr-fic fr-fil fr-dib" width="913" height="536"></p><p><strong><span style="font-size: 10pt;">Fig 10. Runbook variables</span></strong></p><p><br></p><p>The variables that show here are the 'pre-set' variables, these cover basic data stored against the ticket, as well as all ticket custom fields. If you require ticket data to be sent to PandaDocs that does not seem to be available in a variable here you can have it pulled across, however, additional runbook configuration would need to be completed that is not covered in this article. Alternatively, you could enter the data you require into a custom field against the ticket, then set the custom field data to be pulled across. </p><p><br></p><p><strong><em>Note: If your PandaDocs template contains a table that you would like data to be posted into (e.g. pricing table) when the document is created, you will need to enable data merge against the table in order for Halo to post data to PandaDocs in the format of this table. To do this open up the template you are using in PandaDocs, select the table > properties, now in the right-hand pane you will see 'data merge' settings. Click into here to configure data merge and enable it for this table. </em></strong></p><p><br></p><p>In the <strong>Fig 11</strong> example, I have set the recipients of the document to be determined by data in custom fields. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg3NjQ2YmZkLWViY2UtNDVhNy1iZGFjLTNjNmUwMzExMTc1NSJ9.GUNYSik-1-V_dOb4O40Ec_oNa1InhGG2ma1LV2nRuQI" class="fr-fic fr-fil fr-dib" width="833" style="width: 835px; height: 669.845px;" height="670"></p><p><strong><span style="font-size: 10pt;">Fig 11. JSON body of method, use variables to have Halo ticket data used to populate template in PandaDocs</span></strong></p><p><br></p><p><strong><em>Note: When posting custom fields in the JSON body they do not need "" around them. </em></strong></p><p><br></p><p>Once you have populated all the fields you require here remove any fields that you are not using, i.e. do not need to populate on the template. Also ensure you have removed any comments in the body, comments will be any characters in green prepended by '//'. <strong>Fig 12</strong> shows a basic complete body with fields not required and comments removed. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk2ZDE4ODUwLThjMjEtNDg1Ny04NTBiLTEzMDBhYjgzZWQzMSJ9._AmGpFg-21UqB8t_cV1OSvpg7rxJ1F0hpZsuDxfDqwo" class="fr-fic fr-fil fr-dib" width="1225" style="width: 1227px; height: 665.86px;" height="666"></p><p><strong><span style="font-size: 10pt;">Fig 12. Example body for PandaDoc to be created using template </span></strong></p><p><br></p><p id="isPasted">Save this step and the whole of the runbook.</p><p><br></p><p>Now you will need to edit the second step of the runbook (step 4). </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJmOGY0YjgyLWYyYTItNDMwMi1hNGYxLTlmYjgwMjkyZjIzNSJ9.DeCz0FnlXbQpZv4UE3MDlUqr3hXqweuRiBTuktPc5nU" class="fr-fic fr-fil fr-dib" width="1163" style="width: 1165px; height: 466.171px;" height="466"></p><p><strong><span style="font-size: 10pt;">Fig 13. Edit runbook step </span></strong></p><p><br></p><p>Within the step, edit method. Here, you will need to add an "!" to the endpoint being used at this step. This will just ensure the PandaDoc ID does not have speech marks around it, to allow the GET to be successful. Add the "!" as shown in <strong>Fig 14</strong>. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjExNWQyYWY2LWMxNGItNDI5My1iYTE0LTkzZmYwNzNiNGQ5NyJ9.Tk1Qj_2Uc1x4nwWHkYbX6DvBMF5kOaSF19BIJfJkc_s" class="fr-fic fr-fil fr-dib" width="1141" style="width: 1143px; height: 287.907px;" height="288"></p><p><strong><span style="font-size: 10pt;">Fig 14. Edit endpoint</span></strong></p><p><br></p><p><strong><em>Note: This may already be added to your endpoint, depending on your version of Halo. Do not add this if this is already present.</em></strong></p><p><br></p><p>Now your runbook configuration is complete, ensure this step and the whole runbook is saved. You will now need to create an action to trigger this runbook and create a document in PandaDocs. </p><p><br></p><p><strong><span style="font-size: 12pt;">Action to Trigger Document Creation in PandaDocs </span></strong></p><p>To create this action head to configuration > tickets > actions > new. Create an action with the following configuration:</p><ul><li>System Use = Send Webhook/Queue Integration Runbook</li><li>Webhook/Integration Runbook = PandaDoc Create From Template </li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4MDU2Y2YxLTZiZDYtNDI3OC1iZmFhLTNiOGIyNGVkMDBhMSJ9.h1Cc0c72y2mvTlvi3my_7MH0pQ0ct-v72Cqyj_YT07Y" class="fr-fic fr-fil fr-dib" width="407" height="399"></p><p><strong><span style="font-size: 10pt;">Fig 15. Action to have PandaDoc created from template</span></strong></p><p><br></p><p>Once this action is created add it to the relevant workflows to allow your agents to use it. </p><p><br></p><p><strong>Triggering Creation</strong></p><p>When this action is used the runbook will trigger and a document will be created in PandaDocs using the template set against the runbook and data from your Halo instance. </p><p><br></p><p id="isPasted"><strong><span style="font-size: 14pt;">Setup for Creating Documents from an Uploaded file</span></strong></p><p>When creating a document in PandaDocs using an uploaded attachment/file you will need to configure the runbook to do the following:</p><ul><li>Choose folder the document is created in (optional)</li><li>Set recipient of document</li></ul><p><br></p><p>First, head to Configuration > Integrations > PandaDocs > Create from file upload runbook, this will take you to the runbook used for this creation method. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE0ZDViNjQxLTkyMDctNDcwOC1iODdjLWQwZTA2NzJjYzVjNyJ9.Pmc-nygo9G3SiGQDPV4kbXYtJ2M93O3a8K5OXYyvCGM" class="fr-fic fr-fil fr-dib" width="971" style="width: 973px; height: 344.142px;" height="344"></p><p><strong><span style="font-size: 10pt;">Fig 16. Create from File Upload runbook button</span></strong></p><p><br></p><p>When the button is used you will be taken to the 'details' tab of the runbook, navigate to the 'Flow Chart' tab. From here edit the page and edit the first step of the flow. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZmNDkyYTMwLTk4OTUtNDBjYi1hMThlLWIwMTQ4YWU3MWVmYSJ9.8egjqwRpdNb6AsAzb516hz6yjWgKbLwtgpbPs5NsdHI" class="fr-fic fr-fil fr-dib" width="928" style="width: 930px; height: 461.471px;" height="461"></p><p><strong><span style="font-size: 10pt;">Fig 17. Edit step to create PandaDoc from file upload</span></strong></p><p><br></p><p>Now select edit method > Body. Here, you can edit the body to determine what information is passed across to PandaDocs when the document is created. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE2NGY1ZTY2LWM3NGMtNDQ3Yy1hZjg3LWZmOWZjOGFmZjA4ZCJ9.TnF6BGX9zHhJz5yQ3ZsGu-xwR4TJW491ko9iCleabcg" class="fr-fic fr-fil fr-dib" width="1210" style="width: 1212px; height: 541.16px;" height="541"></p><p><strong><span style="font-size: 10pt;">Fig 18. Step Body to create PandaDoc using file upload</span></strong></p><p><br></p><div id="isPasted"><span style="color: rgb(163, 21, 21); font-size: 11pt;">"name"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">: </span><span style="color: rgb(4, 81, 165); font-size: 11pt;">"New File Document" -</span><span style="font-size: 11pt;"> Here, you can set what the document will be called in PandaDocs upon creation. Enter the name you would like the document to have in the speech marks, replacing existing text.</span><span style="color: rgb(4, 81, 165); font-size: 11pt;"> </span></div><div id="isPasted"><span style="color: rgb(163, 21, 21); font-size: 11pt;">"folder_uuid"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">: </span><span style="color: rgb(4, 81, 165); font-size: 11pt;">"UUID of a Folder" - </span><span style="font-size: 11pt;">Here, you can set which folder in PandaDocs the document will be created in. You will need to enter the UUID of the folder here, this can be obtained by opening the desired folder in PandaDocs, when open you will see the folder ID in the URL. </span></div><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM5YTA1MmYyLTY2MzktNGQ5Ni05MjgwLTg1NmQ4ZGM4YTM2MiJ9.ugKrF_LB8JpcLtvUeFb1SbPZAGRtY4nLRGIOxHo6ixU" class="fr-fic fr-fil fr-dib" width="1118" style="width: 1120px; height: 514.962px;" height="515"></p><p><strong><span style="font-size: 10pt;">Fig 19. Folder ID in URL</span></strong></p><p><br></p><div id="isPasted"><span style="color: rgb(163, 21, 21); font-size: 11pt;">"recipients"</span><span style="color: rgb(0, 0, 0); font-size: 11pt;">: [ - </span><span style="font-size: 11pt;">Here, you can set who the recipient of the document created in PandaDocs will be. You can enter set data values in here if you would always like the recipient of the document to be the same. Alternatively, variables can be used here to have details from the ticket be used as the recipient details.<br><br></span></div><p id="isPasted">Fields in the method can have variables set against them as the value, this allows data from the ticket to be used when creating the document in PandaDocs. For example, you may want to set the recipient details of the document to be the ticket's end user's details.</p><p><br></p><p>A list of available variables can be found on the right-hand-side of the page when viewing the step body. Use the dropdown menu to change the entities you are viewing variables for. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ0YjNkZGNhLWNmN2UtNDQxZC1iZmM3LTEyZmNkZTkxZjI2MyJ9.c40w-EBMkzqaaIAL9O7bVvsGqKUlQbcOruXc5nDjGp0" class="fr-fic fr-fil fr-dib" width="665" style="width: 667px; height: 529.726px;" height="530"></p><p><strong><span style="font-size: 10pt;">Fig 20. Runbook variables </span></strong></p><p><br></p><p>The variables that show here are the 'pre-set' variables, these cover basic data stored against the ticket, as well as all ticket custom fields. If you require ticket data to be sent to PandaDocs that does not seem to be available in a variable here you can have it pulled across, however, additional runbook configuration would need to be completed that is not covered in this guide. Alternatively, you could enter the data you require into a custom field against the ticket, then set the custom field data to be pulled across. </p><p><br></p><p>In the <strong>Fig 21</strong> example, I have set the recipients of the document to be determined by data in custom fields.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdmYzRjNTU5LTcxYjUtNGI1NS05ZjM5LTcwZGJlYTZhNWM1NiJ9.3BOC3BRA0TQR-E0_bq7_QxnpkyJkyVwZfNAqNfnyhGo" class="fr-fic fr-fil fr-dib" width="1100" style="width: 1102px; height: 645.244px;" height="645"></p><p><strong><span style="font-size: 10pt;">Fig 21. Example body, recipients of document determined by custom field data </span></strong></p><p><span style="font-size: 11pt;"><br>Once you have configured the runbook step body here, make sure you remove any comment tags. Comments will be any characters in green prepended by '//', shown in <strong>Fig 22</strong>. </span></p><p><br></p><p><span style="font-size: 11pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNjMGJiMjJmLWE3ZGUtNDUyYy1iOTdkLTIyZmFkNGZhMGJlMCJ9.dH2ZEmcSPMQlD8kL5Z78fnE6qJkimzwXMjCJlr9XXS8" class="fr-fic fr-fil fr-dib" width="490" height="296"></span></p><p><strong><span style="font-size: 10pt;">Fig 22. Comment</span></strong></p><p><br></p><p>Make sure you save the step and the whole runbook (there will be multiple save buttons). </p><p><br></p><p>Now you will need to edit the second step of the runbook (step 4). </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA3ODMyNDZkLTdjMzYtNDRhZC05NDQyLWZiMzY5NTIwOWY4OCJ9.VvmJ_kRgTjksQ3DTeY3EPqbJVY17yKS8hphO-TkBXdg" class="fr-fic fr-fil fr-dib" width="918" style="width: 920px; height: 480.038px;" height="480"></p><p><strong><span style="font-size: 10pt;">Fig 23. Edit runbook step </span></strong></p><p><br></p><p>Within the step, edit method. Here, you will need to add an "!" to the endpoint being used at this step. This will just ensure the PandaDoc ID does not have speech marks around it, to allow the GET to be successful. Add the "!" as shown in <strong>Fig 24</strong>. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM4ODJhY2IxLWI1NjMtNDQ0Ny1hZDc4LWM2NDcyMmI1NDFhNyJ9.R8N0y9Bd__qtGcpcfyg-yFUVaBF97spNitDd6D-il7g" class="fr-fic fr-fil fr-dib" width="1163" style="width: 1165px; height: 253.599px;" height="254"></p><p><strong><span style="font-size: 10pt;">Fig 24. Edit endpoint</span></strong></p><p><br></p><p><strong><em>Note: This may already be added to your endpoint, depending on your version of Halo. Do not add this if this is already present. </em></strong></p><p><br></p><p>Now your runbook configuration is complete, ensure this step and the whole runbook is saved. </p><p><br></p><p><span style="font-size: 12pt;"><strong>Trigger Document Creation for File Upload Method</strong></span></p><p>Two things will need to be done to have a PandaDocs document created from a file upload:</p><ul><li>Add the 'PandaDoc Attachment' field to the ticket field list</li><li>Create an action that triggers this runbook</li></ul><p>To add the 'PandaDoc Attachment' field to the ticket field list head to configuration > tickets > ticket types > select a ticket type > field list tab > add field, search for 'PandaDoc Attachment' and save. </p><p><br></p><p>To create a new action to trigger the runbook head to configuration > tickets > actions > new. Create an action with the following configuration:</p><ul><li>System Use = Send Webhooks/Queue Integration Runbook</li><li>Webhook/Integration Runbook = PandaDoc Create from File</li></ul><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkyZTFkZGE1LTg5MTktNGRhNy04MmRmLWI0YmJhN2ZkZjIwYSJ9.N9sNLkJ87n5M3hH7I6k6YghmZU_fcA6AmLxnq-dRwOo" class="fr-fic fr-fil fr-dib" width="425" height="431"></p><p><strong><span style="font-size: 10pt;">Fig 25. Action to trigger PandaDocs creation from file upload</span></strong></p><p><br></p><p>Once this action is created ensure you add this to the relevant workflows so agents can use this action. </p><p><br></p><p><strong>Trigger Creation </strong></p><p>When you would like to trigger PandaDoc document creation using this method, you will first need to choose the file that you would like to be created in PandaDocs. Select this file in the 'PandaDoc Attachment' field against the ticket. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk4MTIyZmVjLTJlY2ItNGY4ZS1hZDVkLWNjYTU0OTEzYjg1NCJ9.oZn1bj5-ogS1OC9V8P109mcK2BnZa3YyKM5pIls2auA" class="fr-fic fr-fil fr-dib" width="304" style="width: 306px; height: 167.167px;" height="167"></p><p><strong><span style="font-size: 10pt;">Fig 26. PandaDoc attachment field</span></strong></p><p><br></p><p>You will be able to choose from attachments against this ticket, so ensure the file you want to create is uploaded to the ticket as an attachment. </p><p><br></p><p>Once the field is set, use the action created earlier (Create PD from attachment). This will result in the selected attachment being created in PandaDocs. To have another document created, simply change the 'PandaDoc Attachment' field and run the action again. </p><p><br></p><p><br></p>
