> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Omneo Zendesk extension from the Zendesk Marketplace and review what is created on first install.

The Zendesk extension is installed from the [Zendesk Marketplace](https://www.zendesk.com/marketplace). Installing the app is enough to provision the integration. Omneo handles the rest of the setup for you.

## Prerequisites

Before installing, confirm you have:

* Your Omneo domain (for example `acme`, the subdomain of `acme.manager.getomneo.com`)
* An Omneo API token generated in CX Manager with the scopes below
* Admin access to your Zendesk account

| Scope                 | Why it's needed                                                        |
| --------------------- | ---------------------------------------------------------------------- |
| `read-locations`      | Reads location data referenced by profile mapping                      |
| `read-tenants`        | Reads existing extension configuration during install                  |
| `update-tenants`      | Writes extension configuration to your Omneo tenant                    |
| `read-profiles`       | Looks up Omneo profiles by Zendesk identity or email                   |
| `create-profiles`     | Creates an Omneo profile when a ticket comes from an unknown requester |
| `update-profiles`     | Links a Zendesk user ID to an Omneo profile as an identity             |
| `read-identities`     | Resolves the Zendesk identity already attached to a profile            |
| `create-interactions` | Records Zendesk ticket events as Omneo interactions                    |
| `read-interactions`   | Deduplicates interactions created from ticket events                   |

## Install from the Zendesk Marketplace

<Steps>
  <Step title="Find the Omneo app">
    Log in to Zendesk and open the Marketplace. Search for **Omneo** and select the listing.
  </Step>

  <Step title="Provide your Omneo credentials">
    Select **Install** and enter your Omneo domain and API token when prompted.
  </Step>

  <Step title="Confirm install in Omneo">
    The extension activates automatically against the Omneo tenant you provided. Your Omneo implementation team can confirm the install from CX Manager.
  </Step>

  <Step title="Configure profile sync and comms">
    Open the extension settings to review the profile mapping, identity handle, and tag prefix. See [Profile sync](/extensions/zendesk/profile-sync).
  </Step>
</Steps>

<Tip>
  Reinstalling is safe. Existing configuration is detected and replaced rather than duplicated, so you can reinstall to reset the extension to a clean state.
</Tip>

## What gets created on install

### In Omneo

The extension creates a set of tenant settings that control how it behaves, including the Zendesk subdomain, the identity handle used to link profiles, the tag prefix, and the field mapping. Your Omneo implementation team manages these on your behalf, and can adjust them if your requirements change.

<Info>
  Installing the extension does not automatically enable profile or rating sync from Omneo. Your implementation team configures the relevant Reactions during setup so that profile and rating events reach Zendesk once you are ready to go live.
</Info>

### In Zendesk

The Omneo app becomes available in the Agent Workspace sidebar for every ticket. No further Zendesk-side configuration is required for the sidebar to appear.

To also record Zendesk ticket activity as Omneo interactions, a Zendesk trigger and webhook need to be configured. See [Ticket events to interactions](/extensions/zendesk/interactions).