19.06.2023
271

How to Connect KeepinCRM as Data Search

How to Connect KeepinCRM as Data Search

Integration with KeepinCRM is implemented as a separate Search block, which can be placed between the Source and Destination data. This will allow you to get data fields in the Data Source, make a request from KeepinCRM to search for an agreement or a client by specified values, and transfer data on agreements or clients to the Data Destination fields. Thus, through the search, you can automatically get data from KeepinCRM and transfer them to the services and systems that you use.

The function allows you to search for Agreements or Clients KeepinCRM Clients and update data

Navigation:

Connecting Google Sheets as a Data Source:

1. What data can be get from Google Sheets?
2. How to connect your Google Sheets account to ApiX-Drive?
3. Selecting the table and sheet from which rows will be exported.
4. An example of data that will be transferred from Google Sheets.

Connecting KeepinCRM as Data Search:

1. What data can be get from KeepinCRM?
2. How to connect your KeepinCRM account to ApiX-Drive?
3. How to set up data search in KeepinCRM in the selected action?
4. An example of the data that will be transferred from KeepinCRM.

Setting up row updates in Google Sheets:
1. What will the Google Sheets integration do?
2. How to connect your Google Sheets account to ApiX-Drive?
3. How to set up data transfer to Google Sheets in the selected action?
4. An example of the data that will be sent to your Google Sheets.
5. Auto-update and update interval.

Setting Data SOURCE: Google Sheets

Let's look at how the Search function works using the example of updating a Row in Google Sheets.

First, you need to create a new connection.

Setting up KeepinCRM Agreement Search in Google Sheets | Create a connection

Select a system as the Data Source. In this case, you must specify Google Sheets.

Setting up KeepinCRM Agreement Search in Google Sheets | System selection

Next, you need to specify the action "Get ROWS (all)".

Setting up KeepinCRM Agreement Search in Google Sheets | Action selection

The next step is to select the Google Sheets account from which the data will be uploaded.

If there are no accounts connected to the system, click "Connect account".

Setting up KeepinCRM Agreement Search in Google Sheets | Connecting account

Select which account you want to connect to ApiX-Drive and grant all permissions to work with this account.

How to Connect Google Sheets as Data Source | Select a Google account to connect
How to Connect Google Sheets as Data Source | Select a Google account to connect
How to Connect Google Sheets as Data Source | Select a Google account to connect

When the connected account is displayed in the "active accounts" list, select it.

Attention! If your account is in the "inactive accounts" list, check your access to this account!

Setting up KeepinCRM Agreement Search in Google Sheets | Account selection

Select the Google Sheets table and sheet where the data you need is located.

Setting up KeepinCRM Agreement Search in Google Sheets | Table and Sheet Selection

At this step, you can add a data filter to load not all rows, but only those for which data needs to be updated, for example:

1. Select a column from the table in which you have the data you are looking for.

2. Select the "Does not contain" action.

3. Write the value by which the filtering will take place, for example "Talks".

With such a filter, you will not unload rows that already have this stage. Why spend extra steps to overwrite this stage if the agreement is already in it?

Setting up KeepinCRM Agreement Search in Google Sheets | Data Filter

Now you can see the test data for one of the rows in your Google Sheets.

If you want to update the test data - click "Load test data from Google Sheets".

If you want to change the settings - click "Edit" and you will go back one step.

Setting up KeepinCRM Agreement Search in Google Sheets | Test data

Now we connect an additional Data Search block. To do this, click on the "+" and select "Add data SEARCH" from the list.

Setting up KeepinCRM Agreement Search in Google Sheets | Add data Search

As the system in which the search will be performed, select "KeepinCRM".

Setting up KeepinCRM Agreement Search in Google Sheets | System selection

Next, select an action, for example "Find AGREEMENT".

Setting up KeepinCRM Agreement Search in Google Sheets | Action selection

The next step is choosing a KeepinCRM account.

If there are no accounts connected to the ApiX-Drive system, click "Connect account".

Setting up KeepinCRM Agreement Search in Google Sheets | Connecting account

Enter the API Key to connect to your KeepinCRM personal account.

Setting up KeepinCRM Agreement Search in Google Sheets | Entering data for access and connection

Go to your account settings in the Company profile - API section, copy your API key and paste it into the appropriate field in your ApiX-Drive account.

Setting up KeepinCRM Agreement Search in Google Sheets | Go to KeepinCRM settings

When the connected account is displayed in the "active accounts" list, select it.

Setting up KeepinCRM Agreement Search in Google Sheets | Selecting a Search account

Select a field to search for data.

The following types of fields are available for searching:
- Agreement ID;
- Client ID;
- Phone.

Setting up KeepinCRM Agreement Search in Google Sheets | Assigning fields

In the "Search" field, you must specify a variable from the Data Source in which the search data is located, that is, a variable with which the column in the Data Destination will be compared, for example, Agreement ID, Client ID or Phone. If a match is found, the row will be updated.

Setting up KeepinCRM Agreement Search in Google Sheets | Assigning fields

Now you see test data for one of the Agreements. You can transfer this data to your receive table.

If the test data did not appear automatically, click "Search in KeepinCRM".

If something does not suit you - click "Edit", go back one step and change the settings for the search fields.

Setting up KeepinCRM Agreement Search in Google Sheets | Test data
Setting up KeepinCRM Agreement Search in Google Sheets | Test data
Setting up KeepinCRM Agreement Search in Google Sheets | Test data

This completes the Data Search setup!

Now we can start setting up Google Sheets as a Data Ingestion system.

To do this, click "Add Data DESTINATION".

Setting up KeepinCRM Agreement Search in Google Sheets | Setup Data Destination system

Setup Data Destination system: Google Sheets

Select the system as Data Destination. In this case, you must specify Google Sheets.

Setting up KeepinCRM Agreement Search in Google Sheets | System selection

Next, you need to specify the action "Update ROW".

Setting up KeepinCRM Agreement Search in Google Sheets | Action selection

The next step is to select a Google Sheets account to which the stage of KeepinCRM will be sent. If this is the same account, then select it.


If you need to connect another accounts to the system, click "Connect account" and repeat the same steps as described when connecting Google Sheets as a Data Source.

Setting up KeepinCRM Agreement Search in Google Sheets | Account selection

Now you need to select the File(Table) and Sheet in which the KeepinCRM Agreement data will be updated.

In the "Search column" field, you need to select the column by which the data will be searched. That is, where to look for data in the table.

Next, in the "Search" field, you need to select a variable from the drop-down list or enter the data manually, by which value the system will search for data to update the row you need. In our case, we select the "E" column, which contains the agreement ID data. The system will update the data in the desired row only if it matches the agreement ID.

Also, you need to specify the Search type, in case several rows with the same ID are found:

"First found row" - searching and updating data will occur in the first found row that satisfies the search conditions.
"Last found row" - searching and updating data will occur in the last found row that satisfies the search conditions.
"All found rows" - search and update of data will be performed on all found rows that satisfy the search conditions.

Also specify the option how to Overwrite data:

- Overwrite old data - new data will be written over the old ones.
- Append to old data - new data from the Data Source will be appended to the old data.

Now you need to assign the agreement stage variable, which we take from the Data Search block, to the empty column. In the future, this column will be updated with data on the stage of your agreement.

After setting, click "Continue".

Setting up KeepinCRM Agreement Search in Google Sheets | Assigning fields
Setting up KeepinCRM Agreement Search in Google Sheets | Assigning fields
Setting up KeepinCRM Agreement Search in Google Sheets | Assigning fields

Thus, the Data Search block takes the Data Source field in which your Agreement ID is registered, queries KeepinCRM for the agreement data, in this case, the agreement stage, and passes this stage to the Data Destination field, for example, in the "F" column.

Setting up KeepinCRM Agreement Search in Google Sheets | Test data
Setting up KeepinCRM Agreement Search in Google Sheets | Test data

This completes the Data Destination system setup!

Now you can start choosing the update interval and enabling auto-update.

To do this, click "Enable update".      

Setting up KeepinCRM Agreement Search in Google Sheets | Enable auto-update

On the main screen, click on the gear icon to select the required update interval or set up scheduled launch. To start the connection by time, select scheduled start and specify the desired time for the connection update to be triggered, or add several options at once when you need the connection to be triggered.

Attention! In order for the scheduled run to work at the specified time, the interval between the current time and the specified time must be more than 5 minutes. For example, you select the time 12:10 and the current time is 12:08 - in this case, the automatic update of the connection will occur at 12:10 the next day. If you select the time 12:20 and the current time is 12:13 - the auto-update of the connection will work today and then every day at 12:20.

To make the current connection transmit data only after another connection, check the box "Update connection only after start other connection" and specify the connection after which the current connection will be started.     

Setting up KeepinCRM Agreement Search in Google Sheets | Update interval
Setting up KeepinCRM Agreement Search in Google Sheets | Update priority

To enable auto-update, switch the slider to the position as shown in the picture.

To force the connection, click on the arrow icon.

Setting up KeepinCRM Agreement Search in Google Sheets | Enable auto-update

This completes the KeepinCRM Agreement Data Search setup! See how easy it is!?

Now don't worry, ApiX-Drive will do everything on its own!