Guide to integrate Electronic Signature in WhatsApp Flows

In simple terms: This guide shows you how to add electronic signature capability to your WhatsApp flows. Users will be able to sign documents digitally directly within WhatsApp conversations.

When creating a WhatsApp Flow, you can select the Electronic Signature option from the validator blocks. This module lets you send a document, template, or envelope created in your ZapSign account so the user can review the files and complete the signing process inside WhatsApp.

Create ZapSign and Truora integration

To start using Electronic Signature as a validator, you must first configure the ZapSign integration in your Truora account. This process can be completed from the Truora platform or through the API.

To do it from the platform, follow these steps:

1. After accessing the Truora platform, go to the Digital Identity section.
2. Select Integrations.
3. Find ZapSign, click Options, and then click Connect.
4. Enter the API token generated in ZapSign.

Generate your ZapSign token

1. Sign in to your ZapSign account or create one.
2. In ZapSign, go to Settings > Integration.
3. In the API section, copy your ZapSign token.

Create the flow

1. Log in to the Truora dashboard. If you need help creating the flow itself, see Create a WhatsApp flow.
2. Once the flow is created and named, go to the flow builder.
3. Select Electronic Signature from the left-hand menu.
4. Drag and drop the block into your flow.

Configure the Electronic Signature block

When you select the Electronic Signature block, the properties panel appears on the right side of the screen. You must configure the integration before saving and publishing the WhatsApp Flow.

• Click Configure Integration.
• Select the format you previously created in ZapSign.
• You can choose between Document and Template.
• After choosing the type, the available items created in ZapSign will appear so you can associate one with the validation.

Use templates

If you select the Template option, the variables created in ZapSign will appear in the configuration. You can either prefill those fields or leave them empty so the user can complete them during the signing process.

Choose the signing method

When configuring the Electronic Signature block, you can choose between two signing methods:

• Digital Signature: This is the default method. The user manually draws their signature on the screen when signing the document. This creates a visual representation of the signature.
• OneClick Signature: This method lets the user sign in a simple way without leaving the WhatsApp experience. See Sign with OneClick.

Sign with OneClick

Truora’s OneClick lets the user sign in a simple way without leaving the WhatsApp experience.

• OneClick is available for WhatsApp flows only.
• No prior configuration is required in ZapSign: any document or template in your account can be signed with OneClick.

Legal validity and validations

You can use OneClick to sign documents of any legal weight you require. The validity of the signature increases with the validations attached to it, because the information collected by those validations is added to the signature certificate.

Adding validations before the Electronic Signature block is not mandatory. However, for important documents, we recommend adding as many validations as possible to the flow before the signature:

• Phone Verification
• Email Verification
• Face validation
• Document validation

Documents with annexes (envelopes)

The selected document or template can include attached files grouped as an envelope. In that case, the signer is accepting the complete set of files, not only the main document. This behavior is the same for documents and templates with extra files.

In the flow builder, when the selected item includes annexes, the block configuration displays:

• The main document.
• The annexed or complementary documents included in the envelope.

This makes it easier to understand which file is the principal document and which files are supporting attachments that are also part of the signature request.

In WhatsApp, the system sends all files in the envelope to the user before signing. The user can review every document and then press the signing button to continue.

This is important because the signer’s consent applies to the full envelope. Showing all annexed documents improves transparency and reduces the risk of a user signing files they did not review.

Save and test your flow

Finally, save and test your flow. Remember that the testing link is only intended for validation purposes and expires after 15 minutes. You can also review how to generate Inbound or Outbound messages from the dashboard.