# Installation

{% hint style="info" %}
**Requirement:** You need to be a Zendesk admin
{% endhint %}

Here is the installation walkthrough:

<figure><img src="/files/LSeaBbiR0BbpkZvdpzWl" alt=""><figcaption><p>Birdie installation walkthrough on Zendesk</p></figcaption></figure>

{% stepper %}
{% step %}
**Install Birdie app on Zendesk from** [**Zendesk Marketplace →**](https://www.zendesk.com/marketplace/apps/support/452045/screen-recording-by-zest/)
{% endstep %}

{% step %} <mark style="color:green;">**`Connect`**</mark>**&#x20;the Birdie app to your Birdie workspace:**\
\
Once installed, open the Birdie app from the Zendesk sidebar. You’ll be prompted to connect it to your Birdie workspace

* If you already have a Birdie workspace, use the **same email address** associated with that workspace.
* If you don’t have a Birdie workspace yet, use your **professional email address** (ideally the one you use for Zendesk) — we’ll create one for you automatically.

*(Note: If you're already logged into your Birdie workspace, step 2 might be skipped)*

<figure><img src="/files/dVQzrCsVEbF425gPzO4k" alt=""><figcaption><p>Step 2: <mark style="color:green;"><strong><code>Connect</code></strong></mark><strong> the Birdie app to your Birdie workspace</strong></p></figcaption></figure>
{% endstep %}
{% endstepper %}

<details>

<summary>How to enable role / group restrictions? </summary>

By default, all teammates who have a Zendesk seat will see the Birdie app in their Zendesk instance. If you wish to apply specific restrictions, visit your Zendesk admin center and follow these steps:

<img src="/files/TWT9x0x0NQYq2YwTVk2Z" alt="" data-size="original">

</details>

<details>

<summary>What happens if IP restrictions are enabled on Zendesk?</summary>

Just allow the following IPs: <mark style="color:green;">`18.189.92.93`</mark> and <mark style="color:green;">`3.20.198.186`</mark>&#x20;

</details>


---

# 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://docs.birdie.so/birdie-docs/helpdesk/zendesk/installation.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.