> For the complete documentation index, see [llms.txt](https://docs.birdie.so/birdie-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.birdie.so/birdie-docs/helpdesk/intercom/installation.md).

# 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>