---
title: Zoho CRM Widget App Creation and Installation Guide
slug: contact-center/zoho-crm-widget-app-creation-and-installation-guide
docTags: 
createdAt: 2025-10-13T09:36:51.611Z
---

# Overview

This document serves as a guide to configure (for the 4.7 release and above) the Zoho Widget App at Zoho application's end. Please follow all the steps for the configuration given below.

# Usage Instructions:

## Step 1: Add Extension to Zoho Developer Account

- Visit **Zoho Developer Console** and add your extension to this URL:[https://developer.zoho.com](https://developer.zoho.com)
- log in with Zoho admin credentials and Navigate to Sigma > Start Building to initiate extension development.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/_8-SAkt5GSM8_xdbKJD31_.blob)

## Step 2: Create a New Extension

- Click on “New Extension” within Sigma to begin setup.
- Select **Zoho CRM** as the target application.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/x0EVftu-PhXIO79IrDkTh_.blob)





![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/JYJNCUHb6pNzX6pcfmjGv_.blob)

## Step 3: Configure the Extension

- Fill out the required configuration fields and save your settings.
- You will be redirected to the extension management screen upon successful creation.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/3FU1Kw-oVxk-Mv0ovm3uB_.blob)

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/9xMXrS6jb_T7nBFpbxKsR_.blob)



**Alternative Extension Creation Path (alternative to step 1 to 3)**

- Visit **Zoho Platform Home**.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/uPevcAUHuicDQ0KeHicI7_.blob)



- Click “Create an Extension” and provide a unique extension name (e.g., AshwaniAmeyoCom) and namespace.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/iNKP_7ceAhoQM5Dwzg5qk_.blob)



- Complete setup and click “Create”.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/bq-9roGkZ6ViC2t7dwCN-_.blob)

****

****

**After Creating Extension from the above steps:**

-  Now go to the connected apps and provide the connected app name like Ameyo and choose the hosting i.e External Hosting

        Sandbox base URL Ex: https\://ashwani.ameyo.com:8443/ameyowebaccess/toolbar

-  Provide the production base URL (Ex\:https\://ashwani.ameyo.com:8443/ameyowebaccess)



![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/P_s-AqWeMMm5OWgLFfr98_.blob)



- Now go to the telephony tab from the left panel and provide the relevant information.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/zkww1u9CEj1266FqyII9c_.blob)





## Step 4: Configuration For CRM OAuth for the SSO and CRM Authorization

- Add a Client ID for CRM OAuth configuration.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/nYKRrjh5neH4POuKJC8lK_.blob)

- Go to **Zoho Accounts Developer Console: **[https://accounts.zoho.com/developerconsole](https://accounts.zoho.com/developerconsole) to set up OAuth.
  - Use your Ameyo server domain in redirect URIs.
  - Pass the SSO Redirect URL example: [https://qanode10.ameyo.com:8443/ameyowebaccess/\_callback](https://qanode10.ameyo.com:8443/ameyowebaccess/_callback)
  - Pass the OAuth CRM Redirect URL example: **https\://qanode10.ameyo.com:8443/oauth/crm**

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/jKEro3_AEELKdLYD7yM11_.blob)

****

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/oGmsU_JUoleDslLlUhw1M_.blob)



3. **Extension Publishing and Installation**

- Publish the extension and note the generated URL.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/GNJP4SlqMxFTkWIMnA46__.blob)



![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/Dk6KO6FQqJYp2ya4lguRE_.blob)



- Now you will get the URL as shown in the screenshot and click on OK.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/K22vRcE7_NAPfJWjK9iGy_.blob)

- Open the published extension URL in a separate browser tab.
- Install it on Zoho Marketplace; uninstall any conflicting CRM extension beforehand.



4. **Extension Activation**

- Go to the Zoho CRM Settings Extensions page (adjust the URL for your server) and activate the extension. https\://crmplus.zoho.com/drishtiameyo/index.do/cxapp/crm/org678879106/settings/extensions/all and change the url according to your server:

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/TZj-6LCqQiUmWcsN-jYEH_.blob)



- Access the “Ameyo toolbar” via the telephony icon in Zoho.

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/FPXYgm8ERKlj734QDtU-X_.blob)

##

##

:::hint{type="info"}
After executing the steps mentioned in this document, there will be few configurations done at the Ameyo DB as well, for which the details will be provided by the designated project manager/engineer
:::