# Installation

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

1. Install Birdie from [Intercom Marketplace →](https://www.intercom.com/app-store/?app_package_code=zest-app)
2. Once installed, <mark style="color:green;">`Connect`</mark> Birdie app to your Birdie workspace:

   * if you **don't** have a Birdie account yet, use your professional email
   * if you **already** have a Birdie account, use the same email address. &#x20;

   *(Note: If logged into Birdie workspace, skip step 2)*

Here is the installation walkthrough:

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

### Add Birdie to your sidebar

Be sure to add Birdie to your sidebar. To do so, go to your Intercom inbox → select "edit app," → pin Birdie.

Here is how:

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

<details>

<summary>What happens if IP restrictions are enabled?</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>

<details>

<summary>Why does Birdie override my background color with the Intercom background color?</summary>

If you are using Birdie with Intercom, Birdie will override the background color with the Intercom background color to ensure a seamless integration. This way, customers will feel that Birdie is a natural part of the Intercom flow.

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

</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/intercom/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.