SharinPix Form Universal Link Syntax and Parameters

Overview

The SharinPix Form supports universal links that allow you to launch a form directly inside the SharinPix Mobile App from any external application—such as the Salesforce Mobile App, Field Service Lightning App, or any custom mobile or web application.

Universal links provide a simple, URL-based way to:

• Open a specific SharinPix Form using a secure form token

• Pass additional parameters such as

  • Prefilled values

  • Enable comparative mode to make a comparative analysis

  • Re-launch an existing form submission

This document explains how the universal link works, its syntax, and all the optional parameters supported.

Universal Link Syntax

The base format of a SharinPix Form universal link is:

https://app.sharinpix.com/native_app/form?token=< sharinpix-form-token>&< parameter1>=&=&....

Components

Component	Description
https://app.sharinpix.com/native_app/form	Entry point used by the SharinPix Mobile App to recognize and open a form
token=<sharinpix-form-token>	Required. A secure token to identify the form instance
&form=<formURL>	Only required when using generic tokens
&<parameter>=<value>	Optional additional parameters

Understanding the SharinPix Form Token

A token is a secure identifier used by SharinPix to authenticate and open forms through a universal link. Without a valid token, the universal link cannot launch a form in the SharinPix Mobile App.

There are two ways to generate tokens depending on your use case:

1. Token for a Single Form

You can generate a token that is strictly linked to one specific form URL.

• This type of token is intended for one-to-one usage

• The universal link will always open that exact form

• Parameters like prefilled values, refill, or comparative mode can still be appended

You can generate this token using the link provided in the main SharinPix documentation: [“Generate Token for a Single Form” ]

Example:

https://app.sharinpix.com/native_app/form?token=

2. Generic Token for Multiple Forms

You can also generate a generic token that can be reused for multiple different forms. This approach is recommended when:

• You have multiple forms in your workflow

• You want to avoid generating and managing many tokens

• Your automation or integration must remain flexible

With a generic token, the form is identified using an additional parameter:

&form=<formTemplateURL>

This allows one token to launch multiple different forms , depending on the URL you append.

Examples Using One Token for Three Forms

https://app.sharinpix.com/native_app/form?token=&**form=formTemplateURL1 ** https://app.sharinpix.com/native_app/form?token=&form=formTemplateURL2 https://app.sharinpix.com/native_app/form?token=&**form=formTemplateURL3 **

Benefits of a Generic Token

• Easier token management

• Ideal for apps or workflows that launch different forms dynamically

• More scalable for large deployments

Additional Parameters

Additional parameters can be used to access additional features when using the SharinPix Form. The features that can be used are:

1. Prefilled values

2. Comparative

3. Re-launch (Refill)

1. Prefilled Values

SharinPix Form can automatically retrieve and display values from related Salesforce records. This feature, known as prefill functionality , allows form fields to be dynamically populated with data from the record where the form is launched.

Configuration Steps

1. Set up in Form Builder The prefill configuration must first be defined within the** SharinPix Form Builder**.

2. Construct the Deeplink Once configured, you must construct the deeplink (SharinPix Form URL) with the values to prefill.

Prefill Parameter

To enable the prefill option, you must use the **pv**parameter followed by the API name of the form element. **Syntax: **pv<ElementApiName>=<Encoded Prefill Value>

The value must be URL-encoded before being passed.

Example Universal Link with Prefill

The following example shows a universal link that pre-fills the Name field with John Doe : https://app.sharinpix.com/native_app/form?token=<Your Form Token>&pvName=John%20Doe

In this case:

• pvName = API name of the form element

• John%20Doe = URL-encoded value for “John Doe”

Multiple Prefills Using Formula Fields

If you need to prefill multiple fields in the same form, you can concatenate the parameters in a Salesforce Formula field. **Formula Example: **"pvName=" & TEXT(Name) & "&pvAddress=" & TEXT(Address)

Note:

When constructing deeplinks, ensure that all values are properly URL-encoded before being passed. This prevents unexpected behavior and guarantees that special characters are interpreted correctly.

To encode a field value in Salesforce, you can use the following formula: SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(FieldName__c, '%', '%25'), '+', '%2B'), '&', '%26'), '#', '%23'), '?', '%3F'), ' ', '%20'), '_', '%5F'), '-', '%2D'))

** Universal Link Example with Formula Field:** https://app.sharinpix.com/native_app/form?token=<Your Form Token>&sp_params={!Formula_Field__c}

This way, you can dynamically pass several prefill values at once using a single formula field.

**Info: ** For more information on the Prefill Feature, please follow the article below: Default or Prefill Values

2. Comparative Mode

The comparative mode enables comparison of previous and current form states. This is especially valuable for follow-up forms, recurring inspections, or progress tracking, where referencing past inputs helps provide updated or more accurate information.

Comparative Parameter

To enable the comparative option, you must include the ref_response_url parameter in the universal link. **Syntax: **ref_response_url=latestFormResponse

Example Universal Link with Comparative View

The following universal link demonstrates how to add the comparative parameter to a deeplink: https://app.sharinpix.com/native_app/form?token=<Your Form Token > &ref_response_url=latestFormResponse

Info: For more information on the Comparative Feature, please follow the article below: Initial/Follow-up Form Responses (Comparative)

3. Re-launch (Refill)

Reopens an existing submitted form with previous answers preloaded.

Best Practices

• Always URL-encode parameter values

• Use generic tokens when managing multiple forms