API document for Sharing the survey via WhatsApp, SMS, Email

API document for Sharing the survey via WhatsApp, SMS, Email

What is SurveySensum Platform:


SurveySensum is a SAAS application, using the application anyone can create multiple surveys. These surveys can be shared to the customers through multiple channels like WhatsApp, Email, SMS. Once customers receive the survey, they click on the survey link (survey link which is shared via different channels), once user fills the survey on web application the response is captured SurveySensum platform. All the responses and the reporting can be viewed in SurveySensum reporting module. Below is the flow when user is manually sharing the survey form the platform.

Feedback collection flow: 

Displaying Frame 1.png 

Need of API integration:

API integration is essential when you need to automate survey distribution in real-time after a transaction or key customer interaction. This ensures timely feedback collection without manual intervention.

Common Use Cases for Real-Time API Integration:

  1. Customer Onboarding – Trigger a survey after a user completes the signup process.

  2. Customer Query Resolution – Send a feedback survey once a support ticket is closed.

  3. Account Closure – Collect insights when a customer closes their account.

In these scenarios, SurveySensum provides a REST API to seamlessly communicate with the survey share module, allowing businesses to trigger surveys programmatically after a transaction or event. This ensures that feedback is gathered at the right moment for better insights and improved customer experience.

 

 Prerequisites for API integrations:

 

1.     The survey should already be there in the SurveySensum. You can build the survey using the build module of SurveySensum, the SurveyGuid is required in the API call. Survey GUID can be copied from the platform URL as following screenshot:



 


2.       Access token for authentication

a.     Login to your SurveySensum account and go to your Account Settings.

b.     On the settings page, go to Integration and Apps, Created Apps and then click 'Create Your App'

c.     Enter the app name and a short description of your app and click on Create New App.

d.     Once you create an app, an Access token will be visible on the screen with all permissions.

e.     You can change permissions if you want to. But make sure to re-generate your Access token to apply those new permissions.


Displaying Frame 7.png



3.     Contact properties codes: Each customer of your organization is identified in SurveySensum as a contact, in the api payload property code is required.  Your customer may have information like name, email, phone number, city info, store id, region etc. Developers can ask the business user which user info they require in the survey response for further analysis. For knowing the codes you can go to SurveySensum platform-> Contacts-> Contact Properties , in the contact properties grid there is a column named “code”, in this field you can know the code for each property

 Displaying Frame 12.png

Api Specs:


You can access the request API from the created app under API URL, see the below screenshot for the reference:
Displaying Frame 13.png

This URL will be changed as per the created app. Below is an example of how you can use it further.

Request Method: Post

Request API: {{baseUrl}}/v2/Share/shareSurvey

Request Headers:

Authorization: Bearer {token}

Content-type: application/json

Note: Token can be generated by logging in to SurveySensum platform-> Setting-> Integrations & Apps-> Created Apps, here you can create a new app for getting an Auth token

 

Query Parameters

Name

Type

Optional

surveyGuid

string

No

shareId

string

Yes

 


 

Request body:

{

  "channelType": "Email",

  "contactInfo": [

    {

      "key": "Contact prop descriptor Code",

      "value": "Contact prop value"

    }

  ],

  "metadata": [

    {

      "key": "Metadata prop descriptor code",

      "value": "Metadata value"

    }

  ],

  "delayMinutes": 0

}

 

 

Example curl :

curl -X POST " {{baseUrl}}/v2/Share/shareSurvey?surveyGuid=919a168f-2b97-45b8-b7ce-f45e85c6154e" -H  "accept: text/plain" -H  "Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjM3M2QwOWY4NDQ3ZjUyZjEyMjY3MjY2ZjMxMjM2MzE5IiwidHlwIjoiSldUIn0.eyJuYmYiOjE3NDIzNjE5NDcsImV4cCI6MTc3Mzg5Nzk0NywiaXNzIjoiaHR0cHM6Ly9wcm9kLWphLW1pY3JvLnN1cnZleXNlbnN1bS5jb20vc3RzIiwiYXVkIjpbImh0dHBzOi8vcHJvZC1qYS1taWNyby5zdXJ2ZXlzZW5zdW0uY29tL3N0cy9yZXNvdXJjZXMiLCJ2el9vcGVuX2FwaSJdLCJjbGllbnRfaWQiOiIwZWJkM2I0YS05YzkyLTRmNzItYmVjZS0wMjhmZDcyNzJiNGQiLCJzdWIiOiJkYzExMGYzNy0wM2ZhLTExZjAtOGU5ZC0wYTBjZGE5Nzg5ZjIiLCJhdXRoX3RpbWUiOjE3NDIzNjE5NDcsImlkcCI6ImxvY2FsIiwiSXNQYW5lbEFsbG93ZWQiOiJGYWxzZSIsInN1YnNjcmlwdGlvbkd1aWQiOiJkYzkyNTQyNS0wM2ZhLTExZjAtOGU5ZC0wYTBjZGE5Nzg5ZjIiLCJ1c2VyR3VpZCI6ImRjMTEwZjM3LTAzZmEtMTFmMC04ZTlkLTBhMGNkYTk3ODlmMiIsInVzZXJJZCI6ImdhYnJpZWxsYS5nb256YWxsZXNAYWt1bGFrdS5jb20iLCJGdWxseU1hbmFnZWRVc2VyIjoiZmFsc2UiLCJBZ2VudFVzZXIiOiJmYWxzZSIsImZvclphcHBlciI6ImZhbHNlIiwic3ViSWQiOiI2MDY5IiwidXNlclN0YXR1cyI6IjQiLCJQZXJtaXNzaW9uIjpbImNyZWF0ZV9jb250YWN0X2xpc3RzIiwidmlld19jb250YWN0X2xpc3RzIiwidXBkYXRlX2NvbnRhY3RfbGlzdHMiLCJkZWxldGVfY29udGFjdF9saXN0cyIsImNyZWF0ZV9jb250YWN0Iiwidmlld19jb250YWN0IiwidXBkYXRlX2NvbnRhY3QiLCJkZWxldGVfY29udGFjdCIsImNyZWF0ZV9zdXJ2ZXlzIiwidmlld19zdXJ2ZXlzIiwidXBkYXRlX3N1cnZleSIsImRlbGV0ZV9zdXJ2ZXkiLCJ2aWV3X3dlYmhvb2tzIiwiY3JlYXRlX3dlYmhvb2tzIiwidXBkYXRlX3dlYmhvb2tzIiwiZGVsZXRlX3dlYmhvb2tzIiwiY3JlYXRlX3NoYXJlcyIsInZpZXdfc2hhcmVzIiwidXBkYXRlX3NoYXJlcyIsImRlbGV0ZV9zaGFyZXMiLCJ2aWV3X2VtYWlsX3RlbXBsYXRlcyIsInZpZXdfcmVzcG9uc2VzIl0sInNjb3BlIjpbIm9wZW5pZCIsInByb2ZpbGUiLCJtYW5hZ2VfY29udGFjdF9saXN0cyIsIm1hbmFnZV9jb250YWN0cyIsIm1hbmFnZV9zdXJ2ZXlzIiwibWFuYWdlX3dlYmhvb2tzIiwic3VydmV5X3NoYXJlIiwidmlld19jb250YWN0X2xpc3RzIiwidmlld19jb250YWN0cyIsInZpZXdfZW1haWxfdGVtcGxhdGVzIiwidmlld19yZXNwb25zZXMiLCJ2aWV3X3N1cnZleXMiLCJ2aWV3X3dlYmhvb2tzIiwib2ZmbGluZV9hY2Nlc3MiXSwiYW1yIjpbInB3ZCJdLCJSb2xlcyI6WyJBZG1pbiJdfQ.vPcHDxJEuKp63_MrvAZ_7AzSMbBRG8u1hgynIh9GJa9M7NhcTrQphp55ryb_5plWIWFStcD91drBapI2NvFP2vcZFixyfGmwXwC5jbPkVrjRgDXQVNQ_yhv-gT448EhnKqShQmDCi-3xRnhfLQs_y_8TXMz6vY04YAcx9i2a3C2qHGUVS_x6vJLfCu3-XTyQTRicynR4l6fxiZ-7P1C14A-rUZVr0w0zFQYlWNjhsJhXX3d6_jhRF8iJA_Qd2ODFAWwXyZw4yqXBfj189jU-N9qbMo1RtwoEz0tJ189y3_LWTxwXODzd8y_ffly1cgvGxwRRpJiS0AKQgG0bhBWG-w" -H  "Content-Type: application/json-patch+json" -d "{\"channelType\":\"Email\",\"contactInfo\":[{\"key\":\"vz_c_email\",\"value\":\"gabriella.gonzalles@akulaku.com\"}]}"

Displaying Frame 7.png

    • Related Articles

    • API document for Unique link generation

      What is SurveySensum Platform: SurveySensum is a SAAS application, using the application anyone can create multiple surveys. These surveys can be shared to the customers through multiple channels like WhatsApp, Email, SMS. Once customers receive the ...

    • Share Survey Via Email

      How to share survey via Email After creating your survey, your survey is ready to be shared! Let us see how we can share the survey via email. Click on Send Email and you will direct to the Email Campaign. Enter the following details based on your ...

    • How to create unique trackable links for surveys sent via external email/sms services

      This feature will help you to track respondents while using external email/sms provider by generating unique links for each responder. You will need to upload the data in contacts section before using this feature.   Let's suppose you already have a ...

    • How to get a Survey Link in Salesforce via API call

      Use - Case: When you want to send surveys created on SurveySensum via Salesforce, you have to configure this integration. Flow of Integration - Event happens in Salesforce, like a ticket gets closed. Immediately a request is sent to SurveySensum, ...

    • How to create custom email template using HTML

      This feature will help you to create a custom email template using HTML. You can use this to create your beautiful email templates to match your brand theme. In case you already have a design template that you use for your brand and you want to use ...