# How to Connect Zoho Desk Using Generic Webhook

When a customer raises a ticket on your support portal, there is no confirmation to them that you received their ticket. Generic Webhook Integration in Gallabox help desk lets you send custom notifications for all these actions and more. Here is how you can do it:

### Generating Webhook URL in your Gallabox Account <a href="#generating-webhook-url-in-your-gallabox-account" id="generating-webhook-url-in-your-gallabox-account"></a>

1. From your Gallabox Dashboard navigate to **Integration** on the left navigation. Under Available Integration, you can find **Generic Webhook**. Click on Connect.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FeHQD6QU806bogcuoUspe%252FGeneric%2520Webhook%2520Integration%2520application.gif%3Falt%3Dmedia%26token%3De3ad19e7-9cfb-4cfb-a713-42a88bd9397a&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=950b58c7&#x26;sv=1" alt=""><figcaption></figcaption></figure>

2. Provide a name to the Integration “**Zoho Desk Integration**” for example.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FzywKBzmYEtqJIBiu6o5q%252FNaming%2520the%2520Integration.gif%3Falt%3Dmedia%26token%3D7890f782-411d-4f5f-9815-f6ff3f694d72&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=db5be0b6&#x26;sv=1" alt=""><figcaption></figcaption></figure>

3. Select the Channel you want to use with Zoho Desk. A Webhook URL will be there to be used in the further steps.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FglqNr9wCiMvfhB3dz0nm%252FChannel%2520for%2520Zoho%2520Desk.gif%3Falt%3Dmedia%26token%3De49f8bc7-de59-4746-a54a-7fcef1d05d75&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=ba541b1&#x26;sv=1" alt=""><figcaption></figcaption></figure>

### Adding Webhook URL in your Zoho Desk Account <a href="#adding-webhook-url-in-your-zoho-desk-account" id="adding-webhook-url-in-your-zoho-desk-account"></a>

1. Go to your Zoho Desk Account, and click the Setup icon ( <img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2Fsupportlab.zoho.com%2FDocsDisplay%3FzgId%3D4241905%26mode%3Dinline%26blockId%3Dgbdiwffc564318a2748e4890124c83bc37eef&#x26;width=40&#x26;dpr=4&#x26;quality=100&#x26;sign=3b92473f&#x26;sv=1" alt="" data-size="line"> ) on the top bar. Under *Developer Space*, click Webhooks.

{% hint style="info" %}
Only agents with Webhooks permission in their [profile](https://help.zoho.com/portal/kb/articles/managing-user-profiles) can create webhooks.
{% endhint %}

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252Fa3I7RbwZkTN6oTGrt82o%252FWebhooks%2520in%2520Zoho%2520Desk.gif%3Falt%3Dmedia%26token%3Dd53f59d9-3d2b-4956-bca6-7b37001eb655&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=30b90a31&#x26;sv=1" alt=""><figcaption></figcaption></figure>

2. On the *Webhooks List* page, click Add your First Webhook or New Webhook.

On the *New Webhook* page, do the following:

* Enter the webhook's name in the Name field.
* Enter the Webhook URL generated in the Gallabox in the URL to notify field.
* Add a description for the webhook (optional).
* Under *Choose Event*, select the module, event and the department details.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252F96G9mODlnseCc9wXWZF4%252FWebhook%2520details%2520in%2520Zoho%2520Desk.gif%3Falt%3Dmedia%26token%3D0df0152c-cb14-456c-bef7-664d38edb50a&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=5cb621c2&#x26;sv=1" alt=""><figcaption></figcaption></figure>

3. Click Test Run to validate the Webhook URL and click on save.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FZ58aCfuX1ejVLlU8M48x%252FValidate%2520Webhook%2520URL.gif%3Falt%3Dmedia%26token%3D33e35aee-41f1-4ac5-8710-d321e57523e7&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=6e16ba2e&#x26;sv=1" alt=""><figcaption></figcaption></figure>

### Testing the Webhook in your Gallabox account <a href="#testing-the-webhook-in-your-gallabox-account" id="testing-the-webhook-in-your-gallabox-account"></a>

1. Go back to Gallabox tab to test the workflow created. Click on **Capture Webhook Response** Button.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FxHrrL9b2jQG5RTjTALxu%252FWebhook%2520Response%2520for%2520Zoho%2520Desk.gif%3Falt%3Dmedia%26token%3D79e1cb52-f523-4d6b-bc37-5a2b8bfd6aa6&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=f0bdadc1&#x26;sv=1" alt=""><figcaption></figcaption></figure>

2. To create a test ticket in Zoho Desk, click on Quick Action and select Ticket. Add the Contact Name, Subject, and status for the Ticket and click on submit.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FeHT0khBFlAtky8UdDZNC%252FTest%2520Ticket%2520in%2520Zoho%2520Desk.gif%3Falt%3Dmedia%26token%3D8a64b12e-da0a-4d44-abf6-881f13209680&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=f64e3ea3&#x26;sv=1" alt=""><figcaption></figcaption></figure>

3. Once you **Submit** the ticket, the response captured will come on your Gallabox account as shown in the GIF below. Click on **Update Configuration** Button to be redirected to Workflows.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FXBstyamZAKMkDa1VEv1R%252FWebhook%2520Response%2520Captured.gif%3Falt%3Dmedia%26token%3D68a7d4fe-386f-4031-9d64-20f2eaf22049&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=6be0e77a&#x26;sv=1" alt=""><figcaption></figcaption></figure>

### WhatsApp Message Workflow - Ticket Creation Notification <a href="#whatsapp-message-workflow-ticket-creation-notification" id="whatsapp-message-workflow-ticket-creation-notification"></a>

1. Click on “**Create New Workflow**” and enter the Webhook Name. We will take the name as "Create Ticket Notification".

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FhjcroCx4OCV77LdRE9sx%252FTicket%2520Creation%2520Notification.gif%3Falt%3Dmedia%26token%3Dd80a9dd3-e754-4e5f-b551-00c063fc46bd&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=efca1b62&#x26;sv=1" alt=""><figcaption></figcaption></figure>

2. To add the Conditions for the workflow, choose **ALL**. Three fields will be visible - **Comparator**, **Operator**, and the **value.**

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FH0uL9SgNJ2t0rBOQM5K4%252FCreate%2520Ticket%2520Notification%2520Conditions.gif%3Falt%3Dmedia%26token%3D8a09655f-11a9-4965-bfa0-1f6da2bce45f&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=15fd5e11&#x26;sv=1" alt=""><figcaption></figcaption></figure>

3. To add the comparator, go back to the Configuration under the Generic Webhook Integration and scroll down to see which Label has the data for the *MODULE-EVENT* of the workflow created in Zoho Desk. The MODULE-EVENT *Ticket\_Add* is captured under the Label `[0].eventType`.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FU5a2wcw8jkBy4npsVMCT%252FEvent-module.gif%3Falt%3Dmedia%26token%3D8f289ece-e27b-43f3-be86-60accff2f4c9&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b053638a&#x26;sv=1" alt=""><figcaption></figcaption></figure>

4. Add the values for Comparator, Operator, and values as `[0].eventType`, `Equal`, and `Ticket_Add` respectively.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FZgEWrC8gspDwncG0uTIq%252FCondition%2520Values.gif%3Falt%3Dmedia%26token%3Dc61b6183-b5a8-4569-a2eb-a93e5524fe63&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=2a67ea76&#x26;sv=1" alt=""><figcaption></figcaption></figure>

5. Click on **Pick Template** and map the variables. To map the variables, go back to the Configuration under the Generic Webhook Integration and scroll down to see which Label has the data for the *variables you defined in the Message Template*.

{% hint style="warning" %}
Remove the square brackets around 0 in the variables. For example, when you choose the Label for Recipient Name you choose *{{body.\[0].payload.contact.lastName}}* from the dropdown. After removing the square brackets, it would be {{body.0.payload.contact.lastName}}.
{% endhint %}

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FWkIRxrs7RPoeDRaGxumq%252FTemplate%2520for%2520Zoho%2520Desk%2520Workflow.gif%3Falt%3Dmedia%26token%3D542875a6-cbaa-4367-bf90-7d2410e81d6c&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=e199c818&#x26;sv=1" alt=""><figcaption></figcaption></figure>

6. After removing the square brackets, the variables would look as per the picture below:

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FwShDlO43zie1jEJduIGw%252FWorkflow_template.png%3Falt%3Dmedia%26token%3Dd02a88cf-d2c5-4ba9-9486-f9c06845ef77&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b0ada45c&#x26;sv=1" alt=""><figcaption></figcaption></figure>

7. If you want to **update the Marketing opt-in** for the contact details, Click on “**Action**”. Edit the “**Action Type**” as "**Update Contact Marketing Opt-in**" Tags.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FfNzCTNpNmbL3VGXFGWa4%252FAdd%2520Action.gif%3Falt%3Dmedia%26token%3Df7fc2b3b-64a3-414d-af1a-a76f1cf32629&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=947ca202&#x26;sv=1" alt=""><figcaption></figcaption></figure>

8. Click on “**Create Workflow**” as a Final Step in the Integration.

<figure><img src="https://docs.gallabox.com/~gitbook/image?url=https%3A%2F%2F3137140735-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FZcl3T6ePz95GpzjAeOLW%252Fuploads%252FVcgEgBQSCQsnqAZqMCm3%252FCreate%2520Workflow.gif%3Falt%3Dmedia%26token%3D2e71ac58-33ed-429e-8e0e-4ccb3feb0732&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=77a6c7bd&#x26;sv=1" alt=""><figcaption></figcaption></figure>

After the Integration is successful, you can see who all have received the messages via logs under the Generic Webhook Integration. Learn more about [Zoho Webhooks](https://help.zoho.com/portal/en/kb/desk/automation/webhooks/articles/setting-up-webhooks-in-zoho-desk).
