# Zoho Lead Panel

### How to Set Up the Zoho Leads Panel

Follow the steps below to configure the Zoho Leads Panel in your Gallabox workspace.

#### Step 1: Open Zoho Leads Panel in the Gallabox Dashboard

1. You can log in to your Gallabox account.
2. From the left navigation, click on Integrations.
3. You can just scroll through the list of integrations and select Zoho Leads Panel.

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

**Step 2: Click Configure and Select Channel**

1. Click on the Configure button.
2. In the integration setup, select the channel where you want the lead info widget to appear.
3. Click on Connect to begin the integration.

<figure><img src="/files/8BsloRc71JBA5bCIH7YE" alt=""><figcaption></figcaption></figure>

**Step 3: Log in to Zoho and Authorize Access**

1. You’ll be redirected to the Zoho login page.
2. Log in to your Zoho CRM account using your credentials.
3. Choose the CRM organization that you want to link with the Gallabox Leads Panel.
4. Click on Submit to authorize access and complete the connection.

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

**Step 4: Configure Custom JSON Schema for Zoho Leads Panel**

Once the connection is successful, you will be redirected to the Zoho Leads Panel configuration page inside Gallabox.

This is where you define which lead fields from Zoho CRM should appear inside Gallabox conversations using a custom JSON schema.

By default, Gallabox will display the following fields: Lead name, Lead Email, Lead ID, Lead Status, Contact owner name, Contact owner ID, and Contact owner email. If you want additional fields from Zoho to be displayed, define it in the custom Schema.

***

### How to define Lead Fields using JSON Schema

In your JSON Schema, define the fields you want to display in the app panel by listing them under the properties section. We support specific types of field definitions, which must be used correctly.

{% hint style="warning" %}
If any field's data doesn't match its expected type, the entire panel will fail to load, and you'll see an error message saying "Something went wrong."
{% endhint %}

<table><thead><tr><th width="149">Object property</th><th width="251">Object property type</th><th>Format requirements</th><th width="178">Examples</th></tr></thead><tbody><tr><td>Text</td><td>$ref: "#/definitions/text"</td><td>maxLength: 255</td><td>First Name</td></tr><tr><td>Numerical</td><td>$ref: "#/definitions/numerical"</td><td>Decimal or integer</td><td>12.00, 100, 45.6</td></tr><tr><td>Date</td><td>$ref: "#/definitions/date"</td><td>YYYY-MM-DD</td><td>2024-07-08</td></tr><tr><td>Time</td><td>$ref: "#/definitions/time"</td><td>hh:mm:ssZ</td><td>14:30:00+05:30</td></tr><tr><td>DateTime</td><td>$ref: "#/definitions/date-time"</td><td>YYYY-MM-DDThh:mm:ssZ</td><td>2024-07-08T14:30:00+05:30</td></tr><tr><td>Email</td><td>$ref: "#/definitions/email"</td><td>Valid email address</td><td>jane.doe@example.com</td></tr><tr><td>Link</td><td>$ref: "#/definitions/link"</td><td>Must be a valid URI</td><td>https://example.com</td></tr><tr><td>Phone number</td><td>$ref: "#/definitions/phone"</td><td>^[+]?[0-9]{1,15}$</td><td>+3725000001</td></tr><tr><td>Address</td><td>$ref: "#/definitions/address"</td><td>maxLength: 500</td><td>123 Main St, New York, NY</td></tr><tr><td>Currency</td><td>$ref: "#/definitions/currency"</td><td>Object: code (string), value (number)</td><td>{ "code": "USD", "value": 120.5 }</td></tr><tr><td>Label</td><td>$ref: "#/definitions/label"</td><td>Object: color (hex), label (text)</td><td>{ "color": "#FF5733", "label": "Urgent" }</td></tr><tr><td>Tags</td><td>$ref: "#/definitions/tags"</td><td>Array of strings</td><td>["priority", "vip"]</td></tr><tr><td>Chip</td><td>$ref: "#/definitions/chip"</td><td>Single string value</td><td>"Lead Won"</td></tr><tr><td>Boolean</td><td>$ref: "#/definitions/boolean"</td><td>true or false</td><td>true</td></tr></tbody></table>

**Example Usage:**

Here, properties contain fields from Zoho Leads and its type is defined in the $ref key.&#x20;

**Phone** field from Zoho is of type **Phone,** which is mentioned as **#/definitions/phone**

**Company** field from Zoho is of type **Text,** which is mentioned as **#/definitions/text**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfx69oYTVLlFKVlMEZRonlbwDAlx_ZzMRr3SR7Bn1hXe_XTKYEXWTm0-OyjjDa64JaOL7K_TKM7DYCwMEaZdDNMGZdCqO2nzJGd2-s3YOjkzS40lmG_RUlVmKEMuBtu-bllTPBx_A?key=2t8X9rQmgZ6eJfAXMSOerA" alt=""><figcaption></figcaption></figure>

**Helpful Links**

Standard Fields - Zoho CRM Leads:&#x20;

{% embed url="<https://help.zoho.com/portal/en/kb/crm/sales-force-automation/leads/articles/standard-fields-leads>" %}

**Step 5: Save and Preview**

1. After entering the schema, click on update configuration.
2. You can go to the conversation tab and choose a conversation to verify how the panel will appear.
3. It will be available in right pane.

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

{% hint style="info" %}
Only contacts in Zoho as a Lead will be available.
{% endhint %}

<br>


---

# 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://docs.gallabox.com/integration/other-integrations/zoho-lead-panel.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.