If you are not aware yet, Zoho has actually deprecated their v1 APIs on 31 December 2018, and that they reach End-of-Life(EOL) on 31 December 2019. If you are using v1, you can opt to migrate your existing auth tokens to refresh tokens to v2 by following their migration guide<\/a>.<\/p>\n And to minimize the consumption of v1 APIs, they are disabling the creation of new auth tokens from the below-mentioned URLs from June 1, 2019.<\/p>\n https:\/\/accounts.zoho.com\/apiauthtoken\/create?SCOPE=ZohoCRM\/crmapi<\/u><\/a><\/p>\n https:\/\/accounts.zoho.com\/apiauthtoken\/nb\/create?SCOPE=ZohoCRM\/crmapi&EMAIL_ID=mail&PASSWORD=password<\/u><\/a><\/p>\n Most people, including me in the past, integrated our UCM with Zoho CRM v1. Luckily for us, Grandstream IP PBX (UCM series) supports integration with Zoho CRM v2. And upon some googling, it appears that there are not many detailed articles or guides on this.<\/p>\n To integrate Zoho CRM v2 with Grandstream UCM, there are 3 main steps.<\/p>\n This step is pretty much straightforward. You login to UCM using the administrator account, navigate to Value-added Feature, select Zoho CRM (v2 API), select the correct CRM Server Address and Contact Lookups. Don’t forget to click on Save and Apply Changes.<\/p>\n This part is where most things get complicated. First, you will have to create an account here https:\/\/accounts.zoho.com\/<\/a><\/p>\n Next, go to Zoho API Console<\/a>, and log in.<\/p>\n There are two applications that you have to create in Zoho API Console \u2013<\/p>\n Create Client Application<\/u><\/strong><\/p>\n Click on Server-based Application > Create Now to create a server-based application.<\/p>\n Insert Client Name, Homepage URL, and Authorized Redirect URLs and click on Create. Authorized Redirect URLs are the URI endpoint that Zoho Accounts will redirect the web browser to with the authorization code after authorizing the client. If you have no Homepage URL or Authorized Redirect URLs, you can key in dummy URL as long as its format is http:\/\/xxxxxx.com<\/a> or https:\/\/xxxxxx.com. In my example below, I simply key in my UCM local IP address.<\/p>\n Upon clicking Create, you will get a randomized Client ID and Client Secret.<\/p>\n Now let us move on to creating Self Client application.<\/p>\n Create Self Client Application<\/u><\/strong><\/p>\n To create a Self Client application, click on Self Client > Create Now, just like how you have done for a Server-based application earlier (but choose Self Client application now).<\/p>\n Once you have clicked on Create on Self Client, you will be given a Client ID and Client Secret. These two are not important and you can ignore them for now.<\/p>\n Under Generate Code, key in the following value \u2013<\/p>\n Scope: <\/strong>ZohoCRM.modules.leads.ALL,ZohoCRM.modules.deals.ALL,ZohoCRM.settings.ALL<\/p>\n Time Duration:<\/strong> 10 minutes<\/p>\n Scope Description:<\/strong> ZohoCRM.modules.leads.ALL,ZohoCRM.modules.deals.ALL,ZohoCRM.settings.ALL<\/p>\n Click on Create and you will see the following screen. Select ZohoCRM and select Grandstream, and click on Create again.<\/p>\n Upon clicking, you will be given a generated code (Grant token) which will help you find your access token. Copy this generated code\/ Grant Token down.<\/p>\n Now that we have our Grant Token, our next step is to generate Access Code and Refresh Code by using a POST request via an API platform. In my example here, I will be using POSTMAN API.<\/p>\n If you are on Google Chrome, download the POSTMAN extension and launch the app. Note that the POSTMAN extension in Chrome has been deprecated and might have no new features if you are using POSTMAN for Chrome. In that case, you can download POSTMAN API based on your OS version here: Download POSTMAN<\/a><\/p>\n Execute a POST request for this URL \u2013<\/p>\n https:\/\/accounts.zoho.com\/oauth\/v2\/token<\/a><\/p>\n Ensure that you have the following parameters\/values inserted in BODY before executing the request.<\/p>\n grant_type:<\/strong> authorization_code<\/p>\n client_id:<\/strong> This is the randomized Client ID from the Client Application which we created earlier. Key in the Client ID.<\/p>\n client_secret:<\/strong> This is the randomized Client Secret from the Client Application which we created earlier. Key in the Client Secret.<\/p>\n redirect_uri<\/strong>: This is the Authorized Redirect URLs from the Client Application which we created earlier. Key in that URL.<\/p>\n code:<\/strong> This is the Grant Token which we generated under Self Client earlier.<\/p>\n Note: This code will expire quickly, depending on the duration you have configured when you are generating the code earlier under Self Client. I would suggest you create the code when you have key in all the parameters under the BODY of your POST request, so you may copy and paste the code into the value field quickly.<\/p>\n Once you are done, click on Send to get the Access and Refresh Token.<\/p>\n We can see that the POST request is successful with 200 OK and response as shown below \u2013<\/p>\n **Alternative way to generate Grant Token**<\/em><\/strong><\/p>\n If the above method to generate Grant Token failed with {“error”:”invalid_code”}, another way to generate a Grant Token is to use this URL \u2013<\/p>\n https:\/\/accounts.zoho.com\/oauth\/v2\/auth?scope=ZohoCRM.users.ALL&client_id={client_id}&response_type=code&access_type={“offline”or”online”}&redirect_uri={redirect_uri}<\/a><\/p>\n e.g. https:\/\/accounts.zoho.com\/oauth\/v2\/auth?scope=ZohoCRM.users.ALL&client_id=1000.ET8U30XP6WSA9SEZKJVAE685DXPG5G&response_type=code&access_type=offline&redirect_uri=https:\/\/192.168.0.46:8089\/<\/a><\/p>\n and then use that code in place of xxxxx in the POST request made for Access token generation below.<\/p>\n\n
Admin Configuration in UCM<\/u><\/strong><\/h3>\n
![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_1.jpg\")
<\/p>\nZoho CRM v2 Configuration<\/u><\/strong><\/h3>\n
![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_2.png\")
<\/p>\n\n
![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_3.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_4.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_5.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_6.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_7.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_8.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_9.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_10.png\")
<\/p>\n![\"\"](\"http:\/\/jazchye.com\/wp-content\/uploads\/2021\/10\/Zoho_11.png\")
<\/p>\n{\"access_token\":\"1000.d7f6aa7cbf70d42e9df61e2a1bd1db9f.2efa7e1385ad5e653a8bd37787f27759<\/strong>\",\"refresh_token\":\"1000.9ed6597e87e6a8cf04ef9b938196f963.6bcd8f87af4494f23b28225d46a695d2<\/strong>\",\"api_domain\":\"https:\/\/www.zohoapis.com\",\"token_type\":\"Bearer\",\"expires_in\":3600}<\/code><\/pre>\n