***

title: Intercom
description: Learn how to integrate Intercom with Fern Docs!
------------------------------------------------------------

For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see [https://buildwithfern.com/learn/llms.txt](https://buildwithfern.com/learn/llms.txt). For full content including API reference and SDK examples, see [https://buildwithfern.com/learn/llms-full.txt](https://buildwithfern.com/learn/llms-full.txt).

Integrate Intercom to add the Messenger widget to your documentation, allowing users to access your help center and contact support directly from the docs.

<Steps>
  <Step title="Get your Intercom app ID">
    Your Intercom `app_id`, also known as the Intercom workspace ID, is a unique code assigned to your app when you create it in Intercom.

    Find it under [Settings > Workspace > General](https://app.intercom.com/a/apps/_/settings/workspace/general) in the "Workspace name & time zone" tab.

    See [Intercom's FAQ](https://www.intercom.com/help/en/articles/8771110-getting-started-faqs#h_c12f89cf9d) for more details.
  </Step>

  <Step title="Add Intercom to `docs.yml`">
    In your `docs.yml` file, add your Intercom configuration:

    <CodeBlock title="docs.yml">
      ```yaml
      analytics:
        intercom:
      	app-id: ${INTERCOM_APP_ID}
      ```
    </CodeBlock>
  </Step>

  <Step title="(Optional) Configure a custom endpoint">
    If you use a custom Intercom instance, add the endpoint to your configuration:

    <CodeBlock title="docs.yml">
      ```yaml {4}
      analytics:
        intercom:
      	app-id: ${INTERCOM_APP_ID}
      	api-base: ${INTERCOM_ENDPOINT} # e.g. https://intercom.custom-instance.com
      ```
    </CodeBlock>
  </Step>
</Steps>