# Google Sheet

**Guide to Integrating Google Sheets with Getfly CRM 6.0**

## 1. **Benefits of Integrating Google Sheets with Getfly CRM**

Accelerated Data Entry: Seamlessly sync customer data from Google Sheets to Getfly CRM in just a few simple steps.

Improved Cross-Team Collaboration: Centralizes data usage across departments, minimizes duplication, and boosts operational efficiency.

## 2. **Step-by-Step Integration Instructions**

Note: Before starting, ensure that the Google account used to create the sheet matches the one used for integration.

### 2.1 **Step 1**

Visit <https://console.cloud.google.com> to create a new project.

Click "Select a project" → then choose "New Project."

<figure><img src="/files/Q32L8S45iXMdwHe1dhk3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NsVvKrHlsBMRfvKBIrli" alt=""><figcaption></figcaption></figure>

### 2.2 **Step 2**

In the Project Name field, enter a name of your choice and click “Create.”

<figure><img src="/files/riQHEQJKpLHVUukVxyfY" alt=""><figcaption></figcaption></figure>

Once the project is successfully created, a confirmation message will appear.

Then, click the notification bell icon and select "Select Project" to open the project settings screen.

<figure><img src="/files/WRd50vqEtDiEiKC0zytr" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/25m4uaxVpiNx41L5K8rQ" alt=""><figcaption></figcaption></figure>

### 2.3 **Step 3**

Navigate to APIs & Services > Enabled APIs & Services.

<figure><img src="/files/uEaS8OHyrZPc97fJQmw7" alt=""><figcaption></figcaption></figure>

Click "Enable APIs and Services."

<figure><img src="/files/meJ598Mlw8hM1EEscdVn" alt=""><figcaption></figcaption></figure>

### 2.4 **Step 4**

The API Library screen will be displayed.

In the search bar, type “Apps Script API” and press Enter.

<figure><img src="/files/7nD7LQYjt0UTCDEAXA5S" alt=""><figcaption></figcaption></figure>

### 2.5 **Step 5**

When the search results appear, click on "Apps Script API."

<figure><img src="/files/AcBhQLXayR7CvkF2IgtO" alt=""><figcaption></figcaption></figure>

Then click "Enable."

<figure><img src="/files/xNQ29fTctFJ6IiL2lVM4" alt=""><figcaption></figcaption></figure>

### 2.6 **Step 6**

Once enabled, proceed by clicking “Create Credentials.”

<figure><img src="/files/A3O2Le1g8mV8TtKgXY72" alt=""><figcaption></figcaption></figure>

Under Select an API, choose "Apps Script API".

Select "User data" and click “Next.”

<figure><img src="/files/5ElxRJ74hg4ZZS0aaMmj" alt=""><figcaption></figcaption></figure>

### 2.7 **Step 7**

Fill in the information on the OAuth Consent Screen:

App Name: Getfly CRM – Google Sheets Sync

User Support Email: Select the email currently used for setup.

Developer Contact Information: Enter the same email address.

Click "Save and Continue."

<figure><img src="/files/VjQzA7vJPUkQ4ahKnvoP" alt=""><figcaption></figcaption></figure>

### 2.8 **Step 8**

In the Scopes section (optional), simply click “Save and Continue.”

<figure><img src="/files/P8Sd2stZNvlVY6Rscoeu" alt=""><figcaption></figcaption></figure>

### 2.9 Step 9

In the OAuth Client ID step:

Set Application Type to "Web application"

Leave the default name “Web client 1”

<figure><img src="/files/9MaMDOP9eXeChBkoxV15" alt=""><figcaption></figcaption></figure>

Click “+ Add URI” under Authorized JavaScript origins

Enter: <https://script.google.com>

<figure><img src="/files/vmdIm9Cn5rgJmu9X7r0X" alt=""><figcaption></figcaption></figure>

### 2.10 Steap 10

Open a new tab and navigate to the Google Sheet you want to sync.\
Go to Extensions (Utilities) > Apps Script.

<figure><img src="/files/wunQhGUl9s862rBGDQNg" alt=""><figcaption></figcaption></figure>

Once the Apps Script editor opens, copy the string of characters after “projects/” and before “/edit” in the URL.

<figure><img src="/files/3osH1iIRQzeYaH48bh1E" alt=""><figcaption></figcaption></figure>

Example: 1pkNskZFwwHYlBD9aFE2m3xRiLAnJOn5ya8QPcebZPzzv4ziQVUFowKha

### 2.11 Step 11

Insert the copied script ID into the following URL format:

<https://script.google.com/macros/d/your\\_script\\_id/usercallback\\>
Replace your\_script\_id with the actual ID from Step 10.

Example result:\
<https://script.google.com/macros/d/1pkNskZFwwHYlBD9aFE2m3xRiLAnJOn5ya8QPcebZPzzv4ziQVUFowKha/usercallback>

### 2.12 Step 12

Return to the integration setup screen from Step 9.

Click “+ Add URI” under Authorized redirect URIs, and paste the URL you generated in Step 11.

<figure><img src="/files/1PfBBkNad8XwaGPoK2bn" alt=""><figcaption></figcaption></figure>

After adding the URI, click “Create.”

<figure><img src="/files/shPpMmQ1q6pnYI1UOo8J" alt=""><figcaption></figcaption></figure>

### 2.13 Step 13

In Step 5 – Your Credentials, click “Done.”

<figure><img src="/files/GTQjSkBp4VcT050L8t2F" alt=""><figcaption></figcaption></figure>

### 2.14 Step 14

Click the three-line menu icon and go to APIs & Services > OAuth Consent Screen.

<figure><img src="/files/vqGS5X5rLk8FaIoK8BT2" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6GqGXQYYYDLStzLidfQP" alt=""><figcaption></figcaption></figure>

### 2.15 Step&#x20;

Go to the "Publishing status" section under Audience:

<figure><img src="/files/cjNgip8dDRD0K9nZXq9Z" alt=""><figcaption></figcaption></figure>

Click "Publish App" → Confirm by clicking “Confirm.”

<figure><img src="/files/VELUeTDRbm1yenJ2Sxcn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/JChXBRZSmvFUzZudBcIe" alt=""><figcaption></figcaption></figure>

### 2.16 Step&#x20;

Click the three-line menu icon again and go to IAM & Admin > Settings.

<figure><img src="/files/64UwVlpgV75HqLCSh6O9" alt=""><figcaption></figcaption></figure>

Copy the Project Number.

<figure><img src="/files/Gjls7p2BoMSyeSPt1Bru" alt=""><figcaption></figcaption></figure>

### 2.17 Step 17

Return to the Apps Script editor in Google Sheets and go to Project Settings.

<figure><img src="/files/nZVzHGzzdsguHENvOLDQ" alt=""><figcaption></figcaption></figure>

### 2.18 Step 18

Click “Change Project” and paste the Project Number from Step 16.

<figure><img src="/files/DaycuA1PqoK2lmTD0Sd9" alt=""><figcaption></figcaption></figure>

Then click “Set Project.”

<figure><img src="/files/q7Px1TEsPkqIZSa05fQs" alt=""><figcaption></figcaption></figure>

A confirmation screen will appear.

<figure><img src="/files/3syRvsHw4yTM0w2GL29T" alt=""><figcaption></figcaption></figure>

### 2.19 Step&#x20;

Log in to the Getfly CRM system using an admin account or a user account with integration privileges.

Ensure an external API integration has been configured, following this guide: <https://wiki.getfly.vn/portal/post/2491>

Go to:\
Settings → Integrations → Other Software Integration → Connect Google Sheet

<figure><img src="/files/TGBOedxz7pzJh1bxuCkg" alt=""><figcaption></figcaption></figure>

Map the corresponding fields in Getfly CRM with columns from the Google Sheet.\
For example: “Customer Name” in Getfly CRM = “Customer Name” column in the sheet.

Enable the Activation switch and click Update.

<figure><img src="/files/6aDsUBH1wOkXs7S5fUP1" alt=""><figcaption></figcaption></figure>

Click Copy.

<figure><img src="/files/yxhBXe3DWgC1QEVhvefW" alt=""><figcaption></figcaption></figure>

### 2.20 Step 20

Return to the Google Sheets Apps Script interface → click on Editor.

<figure><img src="/files/zuQDQGIaeRT57LQcVk9G" alt=""><figcaption></figcaption></figure>

Open the file named code.gs

<figure><img src="/files/L1y9rnx2ItRe5z2SVoGR" alt=""><figcaption></figcaption></figure>

Press Ctrl + V to paste the code copied from Getfly CRM

Press Ctrl + S to save the script

<figure><img src="/files/IGD2Rm0d37IbXzb3mGM6" alt=""><figcaption></figcaption></figure>

### 2.21 Step 21

Click on Triggers (Activate) to set up an event-based automation.

<figure><img src="/files/165hpn6iJO3j5SBqxUUz" alt=""><figcaption></figcaption></figure>

Click “Add Trigger”

<figure><img src="/files/QBCqu0ZClaV0zKfE8i7v" alt=""><figcaption></figcaption></figure>

On the setup screen, in the “Select event type” dropdown, choose the third option: “On change.”

<figure><img src="/files/qP8c54djVH5abDiA5qkI" alt=""><figcaption></figcaption></figure>

Click “Save.”

### 2.22  Step 22

After saving the trigger, a prompt will appear requesting authorization:

Select the Google account used for integration

<figure><img src="/files/42u0o7gfxUvT0HN5OVJr" alt=""><figcaption></figcaption></figure>

Click “Advanced”

<figure><img src="/files/4DLYABqRhqtlNK2Br48r" alt=""><figcaption></figcaption></figure>

Then click “Go to Getfly CRM – Google Sheet Sync (unsafe)”

<figure><img src="/files/qyMZ1oHdjF2WjxRS9yBJ" alt=""><figcaption></figcaption></figure>

Finally, click “Allow” to authorize script execution

<figure><img src="/files/c26FnvIEzjSvqT43e88B" alt=""><figcaption></figcaption></figure>

A confirmation message will be displayed, indicating successful authorization.

<figure><img src="/files/lTkigMgCQVXXxSASin9q" alt=""><figcaption></figcaption></figure>

### 2.23 Step 23

Return to the Google Sheet and add a new row to test the integration.

<figure><img src="/files/7WyCxfSiSRDbkiDYZOjG" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/CjuqVoQRhjmuXeDSA2r9" alt=""><figcaption></figcaption></figure>

Important Notes:\
Only new rows added to the Google Sheet will be synced with the CRM.\
Edited or deleted rows will not be updated in Getfly once they’ve been synced.

For fields such as "Created by" or "Assigned to":

If the Google Sheet does not contain corresponding columns, these values will not be recorded.

If such columns exist, the system will capture the usernames (login names) from the Getfly CRM account.

For select list data types:

The values entered in Google Sheets must exactly match the predefined options in Getfly CRM.

If they do not match, the system will leave the field blank.

The Lead Source field will only sync if the source has already been defined in Getfly.

If the source does not exist in the system, the imported data will default to an empty source field.

If the Google spreadsheet contains multiple sheets, data from all sheets will be pushed to the CRM.

If the spreadsheet is shared with multiple Google accounts, all of those accounts will have permission to push data to Getfly CRM.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpdesk.getfly.vn/web-version/integrations/google/google-sheet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
