Welcome to Portal

?Unknown\pull-down

Welcome to Zoho Cares

Bienvenido a Soporte de Zoho

Search our knowledge base, ask the community or submit a request.

Setting up Connections


Connections enable you to integrate Zoho Desk with other cloud-based third-party services to access authenticated data. To establish a connection, you will have to provide a Connection Name, Authentication Type, amongst other details.

Why Connections?
Zoho Desk offers integration support for a wide range of third-party applications. However, some services cannot be integrated directly with your help desk. In such cases, you can use a connector to expand your help desk's integration capabilities. For example, you can create a connection to log in to a particular service and access your data stored in those services.

Permission Required
Users with the Support Administrator profile permission can access this feature.
Check Feature Availability and Limits

Types of Connections
There are two types of connections in the create connections page:
  1. Predefined Connections: Choose from an existing list of services, provide your credentials, and establish a connection.
  2. Custom Connections: Configure the desired service on your own and connect to it.

Creating a New Connection
You can create a connection with a default service or set up a custom one from scratch. Here's how:
  1. Click the Setup icon (  ) in the top bar.
  2. Click Connections under the Developer Space menu.
    You will land on the My Connections page, which will list the connections created by you.
  3. Click the Create Connection button in the top right corner of the page.
  4. On the Create Connection page, do either of the following:
    1. Select and configure a predefined connection in the Pick Your Service section. Predefined connections are the third-party services that Zoho Desk is already connected with. You will have to enter only the basic details required to set up the connection.
      (or)
    2. Create a custom connection under the Custom Services tab. You will have to enter specific details such as the Authentication Type, Authentication Specific details, and Connection Name of the application that has to be connected.

Sample Connection
Let's take a look at an example scenario of creating a connection with Zoho OAuth. This will be a default connection wherein you will need to choose Zoho OAuth from the already available list of services.
  1. Click the Setup icon (  ) in the top bar.
  2. Click Connections under the Developer Space menu.
    You will land on the My Connections page.



  3. Click the Create Connection button in the top right corner of the page.



  4. Select Zoho OAuth from the Pick your Service tab.
    You will land on the Connection Details section.



  5. Under the Connection Details section, do the following:
    1. Enter the Connection Name and the Connection LinkName you intend to have.
    2. Note: Link name must be unique as it will be used in Deluge integration tasks and invoke URL scripts to establish authentication.
    3. Select the Scope if required, depending on the application’s prerequisites.
      Refer to our API documentation to identify the scopes for each API.
    4. Click Create and Connect.
  6. A login page or a page requesting further details will appear.



  7. Click Connect for the connection to take place.
  8. A summary page displaying the Link name, Service Name, and Status of the Connection is shown.



  9. Additionally, the code to be used in a function to invoke the connection is also given in a box.
You can use the above block of code in Deluge invoke URL scripts or use connection in Integration tasks to access data from the third-party services.

Creating a Custom Connection
If the desired service is not available in the default services list, you can configure it on your own and connect to it.

To create a custom connection:
  1. Go to Setup > Developer Space > Connections.
  2. Click Create Connection in the top right corner of the page.
  3. On the Create Connection page, click the Custom Services tab.
  4. Click Create New Service and do the following:
  5. Enter the Service Name and ServiceLink Name to identify your custom service.
  6. Select the Authentication Type. You can choose between Basic, OAuth 1, or OAuth 2.
  7. Select the Param Type to determine how the authentication parameters will be sent along with the URLs specified in the invoke URL scripts.
    You can choose between Query string, Form Data, or Header.
  8. Add Actual Parameter and Parameter Display Name.
    You can add as many parameters as required.
  9. Provide the Connection Name and Connection Link Name.
  10. Click Save.
Upon successful authorization, your connection will be created and listed on the connections page.

Helpful?68
Updated: 10 months ago
Share :
Follow

Subscribe to receive notifications from this article.