Getting Credentials

In order to connect DigitalGenius with your Zendesk Chat (Zopim) account you would need to generate an authentication token.

In order to perform the following steps you need to have an Admin profile on Zendesk Chat.

Create API Client

First we will create an API client. On Zendesk Chat go to Setting -> Account -> APIs & SDKs.
You should be able to see a page like below maybe with some existing API client(s).

2614

API & SDKs

Next click on the Add API client button and enter the following:

  • Client name: DigitalGenius Bot
  • Company: DigitalGenius
  • Redirect URL: http://localhost
1362

API client settings

Click Create API client to save this.

After you create the API client you should see a pop-up with the details of the client. Copy and save client ID and client secret as we will need these later. Keep these details private and treat them as passwords.

2370

Retrieve Access Token

Next we need to create a url with some of the details from previous steps. The URL structure is the following:

https://www.zopim.com/oauth2/authorizations/new?response_type=token&client_id={{CLIENT_ID}}&scope=read%20write%20chat&subdomain={{SUBDOMAIN}}

Copy the above URL and replace {{CLIENT_ID}} and {{SUBDOMAIN}} with the client ID from the previous step and subdomain of your Zendesk account. So for example if the client ID was 12345 and the subdomain is dg then the URL would be:

https://www.zopim.com/oauth2/authorizations/new?response_type=token&client_id=12345&scope=read%20write%20chat&subdomain=dg

Once you managed to construct the URL with your client ID and subdomain then paste the URL into your browser and load the page. This should redirect you to the following confirmation screen.

1660

Click Allow.

After clicking Allow you should see a page with a message such as "This site can’t be reached". This is OK, what we need is the URL in the browser. So go ahead and copy the URL that you currently have in the browser.

2428

The URL you copied should have the following structure:

http://localhost/#access_token=abcd&token_type=Bearer&scope=read+write+chat

Now select and copy the part after access_token and before &token_type. In the above example that would be abcd.

Save that value, this your access token that we will need later.

Get Account Key

In this section you are going to the account key for your zendesk chat account.

In order to get the key you need to click on your profile icon at the top right corner. This will open a menu like below.

3244

Click on the Check connection and it should open the following pop-up. Copy the value of Account Key and save it for later.

1636