In your business you probably use various tools to store customer information from different sources. With the help of Incoming Integration, Synerise can collect this data and store it in your workspace in any way you want - for example as customer data (attributes, events) or in a catalog.

This use case describes how to prepare an automated workflow that synchronizes an updated list of customers opinions on your company stored in Google Spreadsheet with Synerise. The workflow is triggered with an incoming webhook and it creates an event with opinion on the customers’ profiles. In Google Spreadsheet, we use Apps Script to send data every day to the incoming webhook. This article describes the example of custom events but you can perform other actions in Synerise using the data in Google Spreadsheet depending on what you store there, for example, you can update data in a Synerise catalog or add new customers.

Note: Completing this procedure requires some knowledge on sending API requests using cURL, Postman, or similar tools.

Prerequisites

Create a Google Spreadsheet with data you would like to synchronise with Synerise. In our case, the spreadsheet document contains two columns:

opinion which contains information about the feedback that customer gave about the company
email which contains the customer’s email.

Process

In this use case, you will go through the following steps:

Create an iconming integration.
Configure a Google Spreadsheet.
Create a workflow.

Create an incoming integration

In this part of the process, create an incoming integration to which you will send the data submitted through Google Spreadsheet.

Go to Automation > Incoming > New integration.
On the pop-up, select Without authentication.
Enter the name of the webhook.
In the Endpoint section, click Define.

Important: The URL field is already filled in with the endpoint to which the data submitted throught the form will be sent.
1. Optionally, you can add an icon to this integration.
2. Confirm by clicking Apply.
Configuration of the Endpoint section
In the Incoming data section, click Define.
Click Retrieve data. Right after you click the button, send a request to the endpoint in the Endpoint section with the sample of data that will be sent through forms. The system waits for the incoming request for 1 minute and 30 seconds. Example request:

Important: Replace the endpoint URL from the example with the endpoint URL from step 4.
```
curl --location --request POST 'https://{SYNERISE_API_BASE_PATH}/automation-endpoint/endpoints/END_ID/trigger' \
--header 'Content-Type: application/json' \
--data-raw '{
    "opinion": "Great company",
    "email": "xyz@test.com"
}'
    
```
When the endpoint receives data from the request, verify the list of variables. If the variables include those which are in the payload (in this case, opinion and email), click Define. If not, click Start again re-send request, and wait for the results.

Collected variables from the request
Click Save & publish.

Configure a Google Spreadsheet

In this part of the process, you will create and schedule a script that sends data from your spreadsheet to Synerise at a specific time, everyday. The script will be created in Apps Script - one of the extensions available in Google Spreadsheets.

Go to your Google Sheets account and select the Spreadsheet with customers’ opinions.
Click on Extensions and from the dropdown list, selct Apps Script.

Google Sheet toolbar

Result: A window opens.

Apps Script view
Paste the below JavaScript into code window.

In the fragment of the code marked as #insert_endpoint_URL_here#, insert the endpoint URL from first step. This script is responsible for sending requests to the incoming webhook with maximum 1000 rows (this limit is configurable in the below code), if the email or opinion columns are not empty.

    function onOpen() {
    var ss = SpreadsheetApp.getActiveSpreadsheet();
    var menuEntries = [
        { name: "Send to Synerise ", functionName: "doGet" },
    ];
    ss.addMenu("Export to Synerise", menuEntries);
}
function doGet() {
    var ss = SpreadsheetApp.getActiveSpreadsheet();
    var sheet = ss.getSheets()[0];
    var range = sheet.getRange(2, 1, 1000, 2); // 1000 is number of last row
    var values = range.getValues();
    for (var row in values) {
        if (values[row][0].length != 0 && values[row][1].length != 0) {
            var obj = {};
            obj.email = values[row][0]
            obj.opinion = values[row][1]
            UrlFetchApp.fetch('#insert_endpoint_URL_here#', {
                "method": "post",
                payload: JSON.stringify(obj), headers: { "content-type": "application/json" }
            })
        }
    }
}

To save the script, in the program controls bar, click the disk icon.
In the menu on the left side, click the clock icon > Triggers .
In the right bottom corner, click the Add Trigger button.
Configure as below:

Time trigger configuration in Apps Script
Click Save.

Result: The data from your Google Sheet spreadsheet will be sent to the endpoint in Synerise everyday between 7 and 8 A.M.

Note: This schedule and script are just for reference and both can be adapted to your business needs. For example, sending data can be triggered by making changes in cells, or adding a new row. You can find more information on triggers here.

Create a workflow

As the final part of the process, create a workflow which captures data sent to incoming integration and creates custom events on the customers’ profiles. The workflow starts with the business event trigger that is launched every time the data from Google sheet is sent to Synerise. In response to that, a custom event with an opinion about the company is created.

Go to Automation > Workflows > New workflow.
Enter the name of the workflow.
As the first node, select Business Event. In the configuration of the node, select the incoming integration you created as the first part of the process.
Confirm by clicking Apply.
On the Buisness Event node, click then.
From the dropdown list, select the Outgoing Integration node.
Click the node. In the configuration of the node:
1. Select the Custom webhook.
2. Enter the name of the webhook.
3. Select the POST method.
4. Enter the endpoint URL:
  - For workspaces hosted in Microsoft Azure: https://api.synerise.com/v4/events/custom
  - For workspaces hosted in Google Cloud Platform: https://api.geb.synerise.com/v4/events/custom
5. Enter the following headers:
  - set the content-type header to application/json (default),
  - set the accept header to application/json,
  - set the api-version header to 4.4
6. Enter the request body. For the sheet used in this case, the body is as follows:
```
        {
    "label":"customer made an opinion about company",
    "client":{
        "email":"{{ request.body.email }}"
    },
    "action":"company.opinion",
    "params":{
        "opinion":"{{ request.body.opinion }}"
    }
    }
        
```
  Note: This is just an example, you can create JSON according to your business needs. In the example request body, we used the event context from the trigger which inserts an email address and opinion received in the Business Event trigger. You can read more about it here.
7. In the Authorization section, select By API key.
8. From the dropdown list, select API key that has permissions to create custom events.
  
  Tip: You can read more about API keys here and you can find more information about the endpoint and required API key permissions here.
Confirm by clicking Apply.
On the Outgoing Integration node, click then.
From the dropdown list, select End.
In the upper right corner, click Save & Run.

The view of workflow configuration — Workflow configuration

Result: A company.opinion event is saved to the profiles of the customers.

Custom event in customer's profile

Check the use case set up on the Synerise Demo workspace

You can check the incoming webhook configuration and workflow configuration directly in Synerise Demo workspace.

If you don’t have access to the Synerise Demo workspace, please leave your contact details in this form, and our representative will contact you shortly.

Send data from Google Spreadsheet to Synerise

Prerequisites

Process

Create an incoming integration

Configure a Google Spreadsheet

Create a workflow

Check the use case set up on the Synerise Demo workspace

Read more

We are sorry to hear that

Awesome!