# E-Sign Message

## What is an e-sign message?

An e-sign message can be used within your OpenDialog chatbot to collect and gather signatures from your users. Users can input their signature and then send it over, to be stored by you and used in the future.

<div><figure><img src="https://3203401256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdP6xFXXyeBbibro1Ywnq%2Fuploads%2FBBBrGDpTaBLPQC5LDBoM%2FScreenshot%202024-06-04%20at%2011.25.53.png?alt=media&#x26;token=bdbb6988-3baf-4754-835f-bdcfa52a2bd7" alt="" width="209"><figcaption><p>Here is where the user can input their signature</p></figcaption></figure> <figure><img src="https://3203401256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdP6xFXXyeBbibro1Ywnq%2Fuploads%2FymvSdHTMdVnrmtcJ3ofL%2FScreenshot%202024-06-04%20at%2011.26.02.png?alt=media&#x26;token=5f54f88d-5b0f-4768-8aba-0c06e74c7a28" alt="" width="209"><figcaption><p>An example of a user signature that's been inputted</p></figcaption></figure> <figure><img src="https://3203401256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdP6xFXXyeBbibro1Ywnq%2Fuploads%2FwY7lBd1TxqOShMfQW9sq%2Fe-sign.png?alt=media&#x26;token=f14c802b-f75f-4e44-ab75-586bfd8b35e3" alt="" width="210"><figcaption><p>An example of a signature that has been submitted</p></figcaption></figure></div>

## When to use e-sign messages

E-sign messages are best used when collecting data from the users. For example, if a user is signing up to a new insaurance policy, and the contract requires a signature to be completed.

## How to create an e-sign message

### Via the custom message in Message Editor

Navigate to the [Message Editor](https://docs.opendialog.ai/opendialog-platform/conversation-designer/message-design/message-editor) and create a *Custom Message.* Copy the [XML snippet](#xml-snippet) at the bottom of this page into the black box, or select `esign-message` from the drop down, and your chat message will appear in the Preview panel.&#x20;

Fill in the template with the [properties](#properties) of your particular message and when you are happy with it make sure to save your message and test it in the Test Preview chat window.&#x20;

<figure><img src="https://3203401256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdP6xFXXyeBbibro1Ywnq%2Fuploads%2FysG1zlCsFJcf1iAjlhO4%2FGroup%2020.png?alt=media&#x26;token=5ac6fc76-2275-46c4-81b4-b4195682856c" alt=""><figcaption><p>How to create an e-sign message in the custom message block</p></figcaption></figure>

{% hint style="success" %}

* Open your OpenDialog application
* Select the Scenario that you wish to edit
* Select Design from the left hand panel and select Messages
* Go into the message that you want to add a message block to
* Add a 'Custom Message' block
* Select 'e-sign' from the drop down
* Add in your own text to the fields you want to customise
* To preview your message, go to the Preview section
  {% endhint %}

#### XML Snippet

```xml
<esign-message>
  <text>ESign Text</text>
  <callback>Continue</callback>
  <attribute_name>esign_attribute_name</attribute_name>
  <signature>true</signature>
  <submit_text>ESign Submit Text</submit_text>
  <resign_text>ESign Resign Text</resign_text>
  <confirm_text>ESign Confirm Text</confirm_text>
  <checkbox_text>ESign Checkbox Text</checkbox_text>
  <cancel_text>ESign Cancel Text</cancel_text>
  <cancel_callback>esign_cancel_callback</cancel_callback>
  <document_text>Document Text</document_text>
  <document_title>Document Title</document_title>
  <file_name>signature.pdf</file_name>
  <file_path>/signatures/test</file_path>
</esign-message>
```

## How to use e-sign messages

{% embed url="<https://www.loom.com/share/45f79a718bf840aa8cddf5b0e62fcb9e?sid=1ad5760c-3545-45fe-a0e8-51cb9b089dab>" %}

{% hint style="success" %}
**Saving a message:** Always remember to hit 'Save Message' before closing or navigating away from the edit screen.
{% endhint %}

## How to construct an e-sign message

When structuring a message, you are able to use multiple different message blocks together to create the message that you are looking for. However, when it comes to ordering and structing these, there are some rules that need to be followed. To learn more about this, please head to the [Constructing Messages ](https://docs.opendialog.ai/opendialog-platform/conversation-designer/message-design/constructing-messages)page for more information.

{% hint style="info" %}
For all message types, a key element to take into consideration is **Accessibility**, especially for messages that include customisation with multimedia types such as buttons, images and links. For all information on accessibility within OpenDialog, please click [here](https://docs.opendialog.ai/opendialog-platform/conversation-designer/designing-accessible-chatbots).
{% endhint %}