# Integration with Zendesk

### Overview

Companies using Zendesk for incident management can now integrate it with MangoApps to sync tickets and collaborate efficiently with Level 2 & 3 support teams and subject matter experts (SMEs). This integration aims to ensure real-time syncing of Zendesk issues to MangoApps for seamless information flow, streamline collaboration to improve resolution times, provide real-time updates on issue statuses to keep stakeholders informed, and create a cohesive framework that encourages active participation from developers, support staff, and end-users for prompt issue resolution. 

<figure><img src="/files/yObmz0CtQb5XrjE8EYVv" alt="" width="188"><figcaption></figcaption></figure>

MangoApps integration supports the following Zendesk editions: Suite Team, Suite Growth, Suite Professional, and Suite Enterprise.

***

### Setup in Zendesk

To enable the integration on the Zendesk side, ensure you have the Zendesk administrator role. You will need the following configuration details: Zendesk domain URL, username, and password of the Zendesk account.&#x20;

Next, navigate to the Zendesk admin control and enable the API authentication settings.

<figure><img src="/files/IGr5sz9KUPmcWos6ghMf" alt="" width="563"><figcaption></figcaption></figure>

***

### Setup in MangoApps

Setup within MangoApps requires two configurations: one for the Domain Admin and one for the Teams Admin of the Zendesk team.

**Configuration for Domain Admin of MangoApps**

To enable Zendesk integration, the MangoApps domain administrator needs to open the admin portal, navigate to the **Built-In** **Integrations** section, and toggle **Zendesk** to **ON**.&#x20;

<figure><img src="/files/KpsmdtlCUaGVWElgO0oX" alt="" width="563"><figcaption></figcaption></figure>

Next, set up the Zendesk widget on the home page or in a workspace by adding it from the widget gallery. Configure the widget by adding a header image and setting up the visibility for a specific user segment or for everyone. Specify the number of tickets to display by default.

<figure><img src="/files/FG0TRqv8qiyXwAHQsQSF" alt="" width="563"><figcaption></figcaption></figure>

***

**Configuration for Teams Admin of MangoApps**

Once the network admin enables Zendesk, the team admin needs to enable the integration in the relevant project on MangoApps. Navigate to the project, click on **Admin tools > Configure Integrations**, and enable Zendesk from the integration options.&#x20;

<figure><img src="/files/bSHDZGSUKJuZOtySXWL5" alt="" width="563"><figcaption></figcaption></figure>

Authenticate your Zendesk account through **Global OAuth2** by clicking **Connect** to automatically authenticate the connection using the OAuth2 flow.

<figure><img src="/files/YYMMJEXjpnq5fTkpSZqt" alt=""><figcaption></figcaption></figure>

Once the connection is established, customize the application name and assign team members permission to post comments from MangoApps back into Zendesk.

***

#### Advanced Filters

Configure advanced filters to sync tickets based on specific conditions such as organization, status, priority, and tags. Save the Zendesk settings after configuration.

<figure><img src="/files/DefJUHiPWsXa2KRa44bj" alt="" width="563"><figcaption></figcaption></figure>

**Organization**: Zendesk can have one or more organizations configured to report different types of issues. Leaving this field blank will pull tickets from all organizations. Specifying a value will sync only tickets from the specified organization.

**Status**: By default, tickets with statuses of New, Open, and Pending are synced into MangoApps. Setting a specific status will sync only tickets that meet that status.

**Priority**: This filter allows the team admin to decide whether all priority levels should be synced into MangoApps or only those marked as Urgent/Critical. Leaving this field blank will sync tickets of all priorities.

**Tags**: Zendesk allows tags to be assigned to tickets. The team admin can configure the advanced filter to sync only tickets with specified tags or leave this field blank to pull tickets with any tags.

***

### End User Experience

When a Zendesk end user reports a ticket, it will sync into MangoApps with an "Open" status. Ticket properties include a unique ticket ID, the user who reported it, configurable statuses and priorities, creation and update timestamps, and a summary and details of the incident.&#x20;

<figure><img src="/files/7mkpC8QDGqldtjs7VP04" alt="" width="563"><figcaption></figcaption></figure>

To comment on a Zendesk ticket from MangoApps, select “Post to Zendesk” and set the status to “Pending.” Comments posted in MangoApps will sync in real-time to Zendesk.&#x20;

<figure><img src="/files/Iv8qQyzYKAqLAbf3UJ8R" alt=""><figcaption></figcaption></figure>

The customer support team can review and adjust the priority of tickets based on business urgency.&#x20;

<figure><img src="/files/6pZ4JCb8zPHpNxV40yf5" alt="" width="375"><figcaption></figcaption></figure>

Once resolved, the ticket status updated in MangoApps will reflect in real-time on Zendesk.

<figure><img src="/files/p7B0bCt3AKzvW7TZ3rom" alt=""><figcaption></figcaption></figure>

***

### Testing Considerations

For testing, make sure to set up project members with permissions to post back to Zendesk and test the flow. Be sure to configure advanced filters to align with the tickets/incidents for testing.

{% hint style="info" %}
For Zendesk API to be able to process external requests from MangoApps, we include the required 'organization id' and 'app id' in the request headers by default for our integration. The header details are as below :

#### X-Zendesk-Marketplace-Name:"MangoApps"

#### X-Zendesk-Marketplace-Organization-Id:3295&#x20;

#### X-Zendesk-Marketplace-App-Id: 1218508

{% endhint %}

***

### Rollout Recommendations

Ensure team members can view news feeds for all tickets in MangoApps teams where the integration is enabled. Add necessary customer service team members to the integration settings on MangoApps to reply to tickets created in Zendesk. By following these steps, companies can effectively integrate Zendesk with MangoApps, enhancing their incident management and collaboration capabilities.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/integrations-guide/workspace/integration-with-zendesk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.