Pisano Integration Document

Pisano Link Shortening Service (psn.vc)

The link shortening service provided by Pisano, accessible through the psn.vc domain API, can be used in situations such as:

• Shortening personalized feedback links sent via SMS
• Printing feedback links on marketing materials

How to Use Pisano Link Shortening Service

Pisano's link shortening service does not provide an interface other than the HTTP API. Therefore, it cannot be used with tools like web browsers.

Request

To call the link shortening service, a POST request should be sent to https://psn.vc/shorten with the following parameters and headers.

Sending Custom Values Along with URL Parameters

You can add custom values to the feedback links created on the Pisano platform, in addition to the answers provided by the customer, by following the format below.

Encrypting Custom Values

Pisano requires these values to be encoded in base64 to prevent malicious customers from altering the values embedded in the URL, which could lead to misleading feedback. You can follow these steps to learn how to encode these values.

1. Adding Question Keys Corresponding to Custom Values in the Flow Before sending custom values with URL parameters, you need to identify the keys of the questions in the flow assigned to your channel. These keys determine which question in the flow the custom values correspond to.

2. Creating the responses URL Parameter After identifying the question keys as described in the first step, you can start sending the custom values corresponding to these questions. The responses URL parameter is a JSON object array converted to a string and encoded with base64.

Each object in the array has the following format:

To send each custom value, add these custom value objects to an array. After adding all the objects, convert the resulting array to a string and encode the string with base64 to obtain the responses URL parameter. You can then add this parameter to the end of the feedback link. The demo link provided as an example will look like this after the process:

https://demo-web.pisano.co/web_feedback?node_id=d330b0c2-e0aa–44e3-a5f7–8256fbc218ae&responses=ENCODED_CUSTOM_VALUES

Below is a direct example written in JavaScript of the steps described above.

When you follow the steps above, the hash you obtain will be as follows:

You can add this hash to the feedback URL along with the responses parameter. As a result, the final link will be https://demo-web.pisano.co/web_feedback?node_id=d330b0c2-e0aa–44e3-a5f7–8256fbc218ae&responses=W3sicXVlc3Rpb24iOiJrdWxsYW5pY2lfaWQiLCJhbnN3ZXIiOiJMZW8gUGlzYW5vIn1d.

Below you can find a sample screenshot of feedback left through this link.

Sending Feedback Emails Through the Pisano Platform

You can send emails to collect feedback from your customers using the Pisano platform.

Sending Emails Through the API

Endpoint POST /v1/email_campaigns/:campaign_id/email_sharings/

Parameters

Headers (HTTP Header)

Sample cURL Request

Successful Response

Sending SMS Through the Pisano Platform

Pisano can integrate with the SMS services used by companies through its adapter infrastructure to collect customer feedback via SMS.

Sending SMS Through the API

Endpoint POST /v1/sms_campaigns/:campaign_id/sms_sharings/

Parameters

Headers (HTTP Header)

Sample cURL Request

Successful Response