# Installation

### Install Birdie in Pylon 

#### 1. Get your Pylon API Token

* First, go into your Pylon workspace Settings > Integrations & dev > API Tokens.
* Create a new token with the **Admin** role, and give it a recognizable name (for example, *"Birdie Token"*).
* Copy the token and store it somewhere safe - you’ll need it in the next step.

#### 2. Setup Birdie

Go to your [**Birdie workspace settings**](https://app.birdie.so/settings/helpdesk), open the **Helpdesk Integrations** section, find **the "Pylon" integration**, and click **Enable**.

<figure><img src="/files/0OdgvMnDt3waZa1SQ1Qd" alt=""><figcaption></figcaption></figure>

A window will open prompting you to paste the API token you just created. Paste it into the **API Token** field and click the **Test** button.

![](/files/n4uh1c0CY6hmnCuf2UVq)

If the token is valid, you will see three pieces of information required to complete the Pylon integration in the next step.

Make sure to click **Save** before leaving.

#### 3. Setup Pylon Integration

Go back to your **Pylon workspace** → **Settings** → **Integrations & Dev** → **Integrations**.

Scroll down to **Custom Iframe (by Pylon)** and click on it.

On the Iframe Integration screen, click **+ Add Iframe**, then fill out the form with the following information:

* <mark style="color:$info;">Display location:</mark> choose the value **Issue Sidebar**
* <mark style="color:$info;">Title:</mark> Birdie Screen Recording&#x20;
* <mark style="color:$info;">Description (optional):</mark> *leave empty*
* <mark style="color:$info;">Icon URL (optional):</mark> <https://app.birdie.so/img/birdie-logo.svg>
* <mark style="color:$info;">URL:</mark> copy the URL directly from the Pylon Setup window in Birdie (see previous step).
* <mark style="color:$info;">Height (in pixels, optional):</mark> *leave empty*

Make sure to click **Save**.

You're all set! The **Birdie Screen Recording** panel should now appear in your Issue sidebar.&#x20;


---

# 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/pylon/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.